>> I feel the documentation is riddled with advanced concepts everything is way, WAY more complex than it has to be.
Because it is. Mostly because it is relatively easy to create a complex system/framework. But incredibly harder to make a one that does the same but is simple to understand and use.
And even among those, even less have all that well documented.
Oh, and writing good docs requires a separate set of skills. If the person that writes docs doesn't have years of experience in technical writing - there is a good chance you will have hard time understanding docs written even for a simple thing.
Also, I believe with age our bar for the quality of products and its docs raises as we don't have a ton of time to waste on digging into it.
Because it is. Mostly because it is relatively easy to create a complex system/framework. But incredibly harder to make a one that does the same but is simple to understand and use. And even among those, even less have all that well documented.
Oh, and writing good docs requires a separate set of skills. If the person that writes docs doesn't have years of experience in technical writing - there is a good chance you will have hard time understanding docs written even for a simple thing.
Also, I believe with age our bar for the quality of products and its docs raises as we don't have a ton of time to waste on digging into it.