Agile Zone is brought to you in partnership with:

I'm a software developer working as a senior consultant at Kentor in Stockholm, Sweden. My core competence is as a technical specialist within development and system architecture. In my heart I am, and probably will remain, a programmer. I still think programming is tremendously fun, more than 20 years after I first tried it. That's why my blog is named Passion for Coding.  Anders is a DZone MVB and is not an employee of DZone and has posted 80 posts at DZone. You can read more from them at their website. View Full User Profile

Mob Documenting

04.09.2014
| 2678 views |
  • submit to reddit

This is a guest post from Håkan Rudelius. I’ve been working with Håkan for the last few months at Com Hem (Sweden’s major cable operator) and the discussions with him have been a great inspiration for me on agile, lean and team building.

A friend of mine, Jan, who is consulting at a major telecom company came up with a real nifty idea for how to make documenting smooth and well, almost – fun…


You recall how it’s normally done, right? One poor team member has to “volunteer” to the far from glorious mission of updating the system documentation to reflect the system updates that the team made in the sprint. So the poor guy has to write down everything he knows and then walk around and interview the rest of the team to get everything right. This task normally takes longer than expected because:

  1. It’s so boring so you take every opportunity to get distracted.
    You go get yet another cup of coffee.
    You join a discussion between fellow developers.
    You check that interesting website about nhibernate.
    And so on
  2. The person you need to interview is busy.

Once the document is updated, you normally have to have at least one boring review meeting to get everything right.

So in order to get around these problems my friend decided to try “team documenting” or “mob documenting”.

He gathered the whole team in the team’s war room, then he connected his PC to the projector and started updating the table of contents, when he ran out of new headings for the TOC, one of the other guys chipped in until the team was happy with it.

So they started on the first chapter, the guy who had written the code started formulating the text while my friend was typing. The other guys commented if they didn’t agree with the content or the wording. A few extra PCs where brought in so that the guys who weren’t typing could look up facts, run simple tests or chat with other people that had input. If there were the slightest hesitation, one or two runners were sent out to question the person who had the information.

There were always at least three people actively involved at any given time, usually more. People who were new to the team and didn’t have much to contribute also benefited from the session since they became educated on the design and also got the history and the reasons why the code was written the way it was.

The person behind the keyboard also became the moderator/enforcer so after a while, he got tired and gave the keyboard to the next in line. This procedure was repeated until all chapters were updated/written. The document was DONE, no need to review because that was DONE too!

The advantages with this approach are:

  • It’s fast (even counting man-hours)
  • It will get DONE, it won’t get halted because of distractions.
  • No need for dead-boring reviews, updates, more reviews…
  • All team members get educated on all the changes in the sprint
  • It’s actually quite fun!

Try it in your teams and let me know how it worked!

 

Published at DZone with permission of Anders Abel, author and DZone MVB. (source)

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)