Re:Google and IBM still trying desperately to move cloud mar...
by true_tuna on Wednesday February 13, 2019 @03:05PM
(#19156421)
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.
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.