Reduce the Grump: A Tech Writing Primer for Reluctant Developers

Comments

Comments are closed.

Anonymous at 17:08 on 6 Nov 2015

Very entertaining delivery.

Great list of tools at the end.

Anonymous at 17:09 on 6 Nov 2015

Amazing talk and great delivery! Can we get the slides posted somewhere, tons of great info.

In the past I sampled many documentation tools including wiki, enterprise document sharing, markdown, sphinx etc. I was leaning towards sphinx but was never confident I was making the right choice. This presentation helped me to make up my mind on what is the correct way. It confirmed by dislike with wikies and like of restructured text with sphinx. Overall, I the presenter made me more confident about my workflow.

Good notes about use of language. In school, I remember being graded down for using active voice. I was taught that it is not professional to write in that style. However, in practice I always found documentation in active and it felt more natural. Glad that Allison clarified appropriate grammar needed for a good documentation.

Great content, and slide design. I appreciated the writing resource recommendations towards the end of the talk.

Live demos are really hard to pull off. I personally avoid them unless I know I can execute them without errors.

Anonymous at 10:43 on 7 Nov 2015

I thought the presentation was done very well. Will the speaker post the slideshow up? There were some links/material I was hoping to get a second peek at.

If you're looking for slides, I've added the link to the talk description above.