3 ms·
>> 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 relat
by risyachka 4y ago
>> 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.