3 ms·
It’s more that copy paste. It’s a philosophy of what the documentation is for. If I’m looking at a doc I’m here because I want to do a specific task. The docum
by true_tuna 8y ago
It’s more that copy paste.
It’s a philosophy of what the documentation is for.
If I’m looking at a doc I’m here because I want to do a specific task. The documentation should be task centric like the instructions for a university homework assignment. Imagine you want 30 people to practice a novel task in one evening. You taught them theory in class. Now you want them to try it out. Give them step by step instructions they can use to apply general knowledge to this specific case.
When I’m reading about load balancers and certs I don’t need a textbook. I need examples of specific commands. Instructions on using your tool to do my specific task.