Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

What You Get When You Invest Non-docs Time in Docs Tools

70 views

Published on

Learn how a mid-stage startup tackled common documentation pains with tremendous results, culminating in a company-wide effort to rebuild our documentation site. We got incredible results backed by real data that we want to share with you.

Watch this talk to hear about how LaunchDarkly adopted new documentation practices to stay ahead of the curve of feature development by making docs a first-order concern. This effort culminated in a transformation of our docs toolchain that involved the entire company’s input, feedback, and enthusiasm. Now that we’ve launched our new site, contributions are through the roof. People are engaging with our content like never before, both from within the company and from the general public.

If you watch this talk, you’ll learn:

-How we increased our docs PRs by 350% (yes, really) within a month of launch
-How to get an entire company involved in testing docs
-How a technical writer can act as PM on a project where they have domain knowledge
-How working with design and engineering results in sustainable, scalable IA and tools
-How to capitalize on existing documentation practices within your company–and create new ones when you need them

Published in: Technology
  • Be the first to comment

  • Be the first to like this

What You Get When You Invest Non-docs Time in Docs Tools

  1. 1. Content, collaboration, community What you get when you invest non-docs time in docs tools. Sarah Day Senior Technical Writer scribblingfox
  2. 2. Content, collaboration, community What you get when you invest non-docs time in docs tools. Sarah Day Senior Technical Writer scribblingfox
  3. 3. How to make your company pay for technical writing projects A talk by a technical writer. Sarah Day A Technical Writer scribblingfox
  4. 4. YAWN.
  5. 5. Y THO
  6. 6. A dream without a plan is a wish.
  7. 7. A dream without a plan is a wish. No one gets promoted for having a cool idea.
  8. 8. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Agenda
  9. 9. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Agenda
  10. 10. ● What do you already know? Map the landscape
  11. 11. ● What do you already know? ● Does the organization want to do what you want to do? Map the landscape
  12. 12. ● What do you already know? ● Does the organization want to do what you want to do? ● How will you balance your project with the rest of your work? Map the landscape
  13. 13. ● What do you already know? ● Does the organization want to do what you want to do? ● How will you balance your project with the rest of your work? ● Do you have a specific plan, or vague wish? Map the landscape
  14. 14. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Agenda
  15. 15. ● What, exactly, do you want? Identify the outcomes
  16. 16. ● What, exactly, do you want? ● Who does this impact? Identify the outcomes Your bad decisions Everyone else
  17. 17. ● What, exactly, do you want? ● Who does this impact? ● Is it internally focused, or customer facing? Identify the outcomes
  18. 18. ● What, exactly, do you want? ● Who does this impact? ● Is it internally focused, or customer facing? ● Who do you need? Identify the outcomes
  19. 19. ● What, exactly, do you want? ● Who does this impact? ● Is it internally focused, or customer facing? ● Who do you need? ● What can you cut? Identify the outcomes
  20. 20. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Agenda
  21. 21. ● Who do you need? Build the team
  22. 22. ● Who do you need? Build the team
  23. 23. ● Who do you need? Build the team
  24. 24. ● Who do you need? ● Who would be nice to have? Build the team
  25. 25. ● Who do you need? ● Who would be nice to have? ● What are you doing? Build the team
  26. 26. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Agenda
  27. 27. ● What can you cut? Do the thing
  28. 28. ● What can you cut? ● How can you stay connected? Do the thing
  29. 29. ● What can you cut? ● How can you stay connected? ● Is your schedule accurate? Do the thing
  30. 30. Drudgery follows
  31. 31. Drudgery follows Illness Bought stock in Kleenex.
  32. 32. Drudgery follows Illness Bought stock in Kleenex. Dead hardware It burns, coach.
  33. 33. Drudgery follows Illness Bought stock in Kleenex. Dead hardware It burns, coach. Vacation All I’ve ever wanted.
  34. 34. ● What can you cut? ● How can you stay connected? ● Is your schedule accurate? ● How will you communicate updates? Do the thing
  35. 35. Map the landscape Identify the outcomes Build the team Land and expand Do the thing Agenda
  36. 36. 350%more PRs than the old site.
  37. 37. Everyone loves praise Clones Different teams using the docs site as a template Feedback People love us on Yelp PRs Internal and external
  38. 38. Everyone loves praise Clones Different teams using the docs site as a template Feedback People love us on Yelp PRs Internal and external
  39. 39. Land and expand
  40. 40. ● Who maintains it after launch? Land and expand
  41. 41. ● Who maintains it after launch? ● How can you continue the momentum? Land and expand
  42. 42. ● Who maintains it after launch? ● How can you continue the momentum? ● What’s next? Land and expand
  43. 43. Map the landscape Identify the outcomes Build the team Do the thing Land and expand Yay!
  44. 44. You’re the best. Thanks!

×