4 ms·
Overall, disregard for documentation in places I worked in puzzles me. I like to say: Documentation is memoization for communication. Training courses and vid
by b0rsuk 8y ago
Overall, disregard for documentation in places I worked in puzzles me. I like to say:
Documentation is memoization for communication.
Training courses and videoconferences are overrated. A guy gets to wear a suit and (usually) point at some slides. I don't see the benefit of being able to ask questions, because people feel intimidated and few questions are asked. And whenever some new employees arrive, you have to redo the whole thing.
To be sure, there's plenty of shitty documentation. But I think it's the problem with the writer not making an effort to put himself into reader's shoes. A technical writer should be eager to clarify, and improve documentation. His goal should be to be understood, not high page output.