People now seem to want a system that is very easy to install and start playing with, even without reading the docs; only then will they be willing to make the learning investment necessary to use what they just installed more seriously. Old-timers who grew up flipping switches to enter the bootstrap loader on a PDP, or whatever, may well feel that today's generation is asking an awful lot 😊
I know, I know. (sigh) When I was maintaining my own set of documentation, there were always a few people who wanted the Macintosh-style "click the Continue button to continue" installation experience. I'm not asking people to be Michelin 3-star chefs, but those Swanson turkey pot pies sure sell well.
People, no matter how much experience they have, should anticipate the possibility of running into problems. Good luck with your updates.
