What is Enough Documentation? An Agile tenet is “just enough documentation” which people often take to mean no documentation, or just the information that is recorded in the card plus acceptance criteria, the rest to be filled in by conversation. In discussion about green field Agile utopias, this might be enough. In the real world, […]
There is no excerpt because this is a protected post.
In Narration in Technical Writing 1, I talked about using a “movie trailer” intro to “sell” a technical idea under a show-don’t-tell approach. Here I’ll talk about how to take that that dramatic lead and convert it into requirements. From Narrative to Requirements “Storytelling is the most powerful way to put ideas into the world […]
Every tech writer has a literary giant hiding inside. Why wait? You can use that talent for narrative at work. The Movie Trailer Intro I have been very fortunate to work with many brilliant people in my career. The year before last, my friend Mark Hoffman and I were the primary authors on a paper […]