3 ms·
Is there a better version of this in 2016 somewhere?
by infocollector 10y ago
Is there a better version of this in 2016 somewhere?
- rubidium 10y agoUm... not much has changed in the technical writing world. There's a few better tools for using images/video, but nothing really that great (someone go build this please!). The things expressed in the article are still pretty valid. Except for the first one (I don't like cutsy documentation), the rest are solid starting points. The biggest one for me is to tell people what to do. Don't ask or talk in the passive voice.
- niels_olson 10y agohttp://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19930013813.pdf http://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/1993001...
- Radim 10y agoExactly! Where's TensorFlow, where's AWS Lambda, where's Node and Spark and Elixir?? This is some prehistoric junk. I demand a deep-learning-ready version.
- hkmurakami 10y agoA friend of mine wrote a short ebook [1] on the subject, and I [2] thought it was excellent. He's currently a lead technical writer at Palantir. [1] https://www.amazon.com/Modern-Technical-Writing-Introduction-Documentation-ebook/dp/B01A2QL9SS https://www.amazon.com/Modern-Technical-Writing-Introduction... [2] I wrote a lot of Fluentd's documentation in its early days http://www.fluentd.org/ http://www.fluentd.org/