Augment your knowledge during software modelling sessions: Decision Log
- September 11, 2019
- Posted by: brian
- Category: Uncategorized
The most important learning during my career is that the act of creating software is a team effort. We can be a one-person team, but there is someone else involved; at least someone to use it.
As time goes by, I started to focus more on the collaboration between team members (and also teams, but it’s beside the point). The most effective collaboration techniques that I experienced are visual collaboration techniques. Amongst them, you can find EventStorming, Specification by Example, Impact Mapping or Example Mapping (I could be here all day).
I observed and facilitated in different settings; most of them are new teams inside of organisations that were set up to break legacy software, often intertwined. The teams are invested in crunching the knowledge before start coding the new solution, and part of the process involves making decisions that can impact the project.
Given the complex contexts in which the teams operate, it’s common to have several modelling sessions, spanning multiple days. During these sessions, the teams make strategic and tactical decisions, based on the knowledge that was crunched. However, not all these decisions stick in our mind, and I observed (and felt into the same trap) people to get over to the same topic, and not been able to recall the exact sequence of events for the decision.
To promote effective sessions, I started to use a visual technique, inspired by a pattern from Living Documentation, the Decision Log:
It is useful for use cases, where the group (or organisation) is in a scale-up mode. Although there are some specialists in some parts of the process, the process doesn’t cross silos because they don’t exist!
What I experienced is that this visual anchor helps the group to reason about parts of the process, enabling a discussion about the different boundaries within a process; it makes it easier to reason and discover those bounded contexts.
What are your experiences when facilitating modelling sessions such as EventStorming? Any tips or clue?