Talk in English - US at True North PHP 2015
Track Name:
3
View Slides: http://mistressofinformation.com/talks/Reduce-the-grump-TrueNorthPHP-20151106.pdf
Short URL: https://joind.in/talk/994f7
(QR-Code (opens in new window))
Reduce the Grump: A Tech Writing Primer for Reluctant Developers
Comments
Comments are closed.
Very entertaining delivery.
Great list of tools at the end.
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.
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.