22
WRITE THE DOCS NORTH AMERICA CONFERENCE 2016

Write the Docs 2016 NA conference summary

Embed Size (px)

Citation preview

Page 1: Write the Docs 2016 NA conference summary

WRITE THE DOCS NORTH AMERICA CONFERENCE 2016

Page 2: Write the Docs 2016 NA conference summary

HTTP://WWW.WRITETHEDOCS.ORG/

We consider everyone who cares about communication, documentation, and their users to be a member of our community. This can be programmers, tech writers, customer support, marketers, and anyone else who wants people to have great experiences with software.

Page 3: Write the Docs 2016 NA conference summary

“DOCUMENTARIANS”?

• Technical writer: someone whose main job it is to create documentation

•Documentarian: everyone who really cares about documentation!

Page 4: Write the Docs 2016 NA conference summary

WHO ATTENDED

Page 5: Write the Docs 2016 NA conference summary

DAY -2: HIKE!

Page 6: Write the Docs 2016 NA conference summary

DAY -2: HIKE!

Page 7: Write the Docs 2016 NA conference summary

DAY -1: API DOC

SESSIONS

Page 8: Write the Docs 2016 NA conference summary

DAY -1: API DOC

SESSIONS

Page 9: Write the Docs 2016 NA conference summary

THERE I AM!

Page 10: Write the Docs 2016 NA conference summary

DAYS 1-2

Page 11: Write the Docs 2016 NA conference summary

ALSO ME!

Page 12: Write the Docs 2016 NA conference summary

IT WENT WELL!

Page 13: Write the Docs 2016 NA conference summary

ALL PRESENTATIONS WERE RECORDED

https://www.youtube.com/user/NextDayVideo/videos

Page 14: Write the Docs 2016 NA conference summary

WRITE THE READABLE README(DANIEL BECK)

Page 15: Write the Docs 2016 NA conference summary

JUST-IN-TIME DOCUMENTATION(BRIANNE HILLMER)

Page 16: Write the Docs 2016 NA conference summary

OOPS, I BECAME A PROGRAMMER(TARA SCHERNER DE LA FUENTE)

Page 17: Write the Docs 2016 NA conference summary

CODE THE DOCS: INTERACTIVE DOCUMENT ENVIRONMENTS

(TIM MCJONES & PARIS BUTTFIELD-ADDISON)

Page 18: Write the Docs 2016 NA conference summary

MOVE FAST AND DOCUMENT THINGS: WRITING INTERNAL DOCS AT FAST-MOVING ORGANIZATIONS

(RUTHIE BENDOR)

Page 19: Write the Docs 2016 NA conference summary

COPY THAT: HELPING YOUR USERS SUCCEED WITH EFFECTIVE PRODUCT COPY

(SARAH DAY)

Page 20: Write the Docs 2016 NA conference summary

KEY POINTS

• Document what the user is doing, not what the app is doing• Just-in-Time vs. Just-in-Case documentation• Good internal communication is rare, valuable,

and results in better docs

Page 21: Write the Docs 2016 NA conference summary

MOST KEY POINT

“Docs are better when written with a team.”

Page 22: Write the Docs 2016 NA conference summary

SADLY, NO VOODOO

DOUGHNUTS FOR ME