Interactive Documentation in
Twine
Al Nelson
SF Write the Docs Meetup
March 29, 2016
What is Twine?
● “An open-source tool for telling interactive, nonlinear stories” (twinery.org)
● Sort of like “choose your own adventure”
● Users make choices to direct the flow of the story
How can I use it for documentation?
● “That’s all fine and good, but how does that help me?”
● When a customer has a question, they will usually go through a series of steps
(almost without realizing it) to find their answer
● These steps can be modeled in a choice-based architecture like Twine
● Good for:
○ Question and answer, flow-chart style processes
● Not good for:
○ Highly nuanced information
Demo!
http://philome.la/musegarden/interactive-documentation-with-twine/play

Interactive Documentation In Twine

  • 1.
    Interactive Documentation in Twine AlNelson SF Write the Docs Meetup March 29, 2016
  • 2.
    What is Twine? ●“An open-source tool for telling interactive, nonlinear stories” (twinery.org) ● Sort of like “choose your own adventure” ● Users make choices to direct the flow of the story
  • 3.
    How can Iuse it for documentation? ● “That’s all fine and good, but how does that help me?” ● When a customer has a question, they will usually go through a series of steps (almost without realizing it) to find their answer ● These steps can be modeled in a choice-based architecture like Twine ● Good for: ○ Question and answer, flow-chart style processes ● Not good for: ○ Highly nuanced information
  • 4.