Writing in an Agile World

[article]

Pay attention and speak up—in that order
Nobody wants to look like an idiot. Chances are you are going to have to ask some questions during a sprint planning meeting, and you are sure to look like an idiot if you don’t ask smart questions at the right time because you have been focused on your laptop or phone. Meetings can be tedious, especially when you don’t understand what’s going on or when the discussion just doesn’t apply to what you do. But staying focused has two benefits: you learn new things, which allows you to eventually offer educated opinions about things unrelated to tech info; and the questions you ask will be more appropriate in timing and content. You will be—in perception and reality—a more valuable member of the team. It’s important that you understand what the doc requirements of a story are so that you can adequately judge the effort required and manage your individual velocity. You simply must speak up and ask questions in order to do your job well. Be smart about it.

Write later
The biggest challenge most writers see in agile is that things always change in a product as the development effort goes on, and if we document things as they’re being developed, we ultimately have to erase what we’ve written in prior sprints and rewrite it. And that’s true. It just is. What can I say? There are good reasons to have documentation happening alongside the development effort, such as being able to support incremental releases; but ultimately, it’s true that you’re going to have to do more writing when working as an agilist.

In order to maximize your efficiency, wait until as late as possible to document an active story. If your sprint work consists of two development stories that require some doc work and one doc-only story, focus entirely on the doc-only story at the beginning of the sprint while other team members work on the product development stories. Wait as long as you reasonably can before starting the doc work on those stories in the hopes that all the changes—for example, changes to button names—have already occurred. This is tricky because you don’t want to hold up a story, but the longer you wait, the greater the chance that you minimize the amount of doc revisions needed.

What Now?
Get started. You’ll stumble, but part of Scrum is inspecting and adapting. Consider these suggestions and use what makes sense. Agile takes into account that each situation is unique, and you need to determine what makes the most sense for your particular Scrum team. Use the retrospective to talk with team members and figure out how to refine your role and methods so you can be most effective and useful. Keep an open mind and a positive attitude—you might be surprised by just how well agile works for you.

About the author

Sarah Johnson's picture Sarah Johnson

I’m a technical communications specialist with CA Technologies, working out of Framingham, MA. I’ve been a technical writer for ten years and have been working with Agile for three years. While my primary professional focus is on content creation, my main interest is in learning about the current trends in information consumption and presenting content in ways that make the most of the latest technology and tools. I’m a champion of the Agile methodology and work with other writers to develop strategies for successfully integrating technical writers into scrum teams as generalizing specialists. In my free time I enjoy reading and hiking with my dogs.

 

AgileConnection is one of the growing communities of the TechWell network.

Featuring fresh, insightful stories, TechWell.com is the place to go for what is happening in software development and delivery.  Join the conversation now!

Upcoming Events

Sep 22
Sep 24
Oct 12
Nov 09