3 ms·
I disagree - the advice can be top notch independent of Google's organization successes. Teaching individuals still has value, because nobody is born a great wr
by edmundsauto 4y ago
I disagree - the advice can be top notch independent of Google's organization successes. Teaching individuals still has value, because nobody is born a great writer.
Google's failure could be because the org is not incentivizing good documentation.
- deleted 4y ago[deleted]
- maxerickson 4y agoIt's got issues. Like the use of the word "develop" for the clear and short sentence strategies on this page: https://developers.google.com/tech-writing/one https://developers.google.com/tech-writing/one Utilize and employ are about the same level of obscurity as 'develop' and much closer to the intended meaning. A later inspirational message is very impressed with itself: https://developers.google.com/tech-writing/one/paragraphs https://developers.google.com/tech-writing/one/paragraphs The work of technical writing is to organize and clearly present information. I wouldn't pat myself on the back if I published a writing guide that was easy to nit pick.
- joshuamorton 4y agoThe goal of something and the work of something are distinct. Untangling a topic is work done in service of, ultimately, clearly presenting information. The guide appears correct, and your criticism misplaced.
- danesparza 4y agoI'll take it. Thank you. My question still stands: What is a body of documentation that Google has completed that you would hold up as a standard of work worthy of imitation?