4 ms·
You're talking about docs here as if they're like a textbook on Calculus. Thorough, constant and unquestionably effective. Online docs are nothing like this.
by julianeon 3y ago
You're talking about docs here as if they're like a textbook on Calculus. Thorough, constant and unquestionably effective.
Online docs are nothing like this.
First, they can change as frequently as every few weeks, so there's no point in studying them exhaustively if they'll be useless after the next update.
Second, they're often inferior to Google's answers on the topic, especially if you're using your question as the search query.
Third, even if they are current and the best text resource available, they may still be bad. Halfhearted explanations or even whole pages saying "content should go here." Often worse than simply asking for an explanation in a Slack or a Discord.
I don't think that would be true of an engineer with a physical tool, but it's often true of software tools.
- pests 3y agoIf there is an update to the docs, that might mean there was an update to the tool you used. Why not learn the new features of your tool? You can also pin your docs to a version just like your dependencies, no reason for online-only. You can still google things as needed, I just don't see the problem with spending a few minutes familiarizing ourselves with the changelog. Even if they do change every few weeks, we have diffs don't we? I do agree a lot of docs and manuals are not production ready.