Remote collaborative modeling

… and check why 5600+ Rails engineers read also this

Remote collaborative modeling

Being remote means you don’t always have face-to-face contact with your customers, with the domain experts, or with the right people who know how the business you’re trying to model works.

This must not be an excuse to skip the modeling part. It is even more important to have a good shared understanding of the domain and the problem you try to solve, to build and use the ubiquitous language.

Start with shared document

You don’t need any special knowledge, you don’t need to read books, you don’t need to take courses. Just start collaborating with the right people, the people who know the business or the people who have experience with old systems. Start by asking questions and by actually listening to the answers, and then note them down.

Use shared document, and if possible shared screen to collaboratively create the description of the domain problem. The tools here are not important - anything that is capable to show the history of changes and add comments / handle discussions would fit. The online documents shared and editable by the whole team would be a good start. From my experience, the tools to manage projects (Trello, Basecamp, Jira, etc) are not the best ones here. The discussion should be close to the text where the problem is described. Those tools allow you to comment under the main section and that is adding unnecessary friction when you want to understand the whole thing, with all different opinions. BTW if your collaborators are familiar with Github a Pull Request with a markdown file should work - you will get traceability of changes and PR conversations will allow for easy clarifications of misunderstandings.

A shared screen will work only if you work at the same time, what not always will be possible, that’s why is it important to have a way to track changes and have discussions in the edited document. Use a shared screen to build trust, to help others to focus on the current part and to make sure everything is described in a way all of you understand and being consistent with ubiquitous language.

A good idea might be to use techniques and tools used in Mob Programming - especially when you work in a larger group, with several domain experts. Put yourself in a driver role and let them guide you, follow their words and make notes - build the model based on shared understanding. And ask questions if you have any doubts.

But we could do better than that. Some modelers have already tried that and worked on some techniques on how to make the gathering requirements better, how to have better, easier conversations with domain experts. We could learn from them and try which technique works best for us.

Event Storming

The Event Storming has hit the DDD community a few years ago. It has changed the way we think about modeling session. It has introduced visual collaborative modeling techniques and has made us embrace the use of it.

But the Event Storming is the hardest one to use online. According to Alberto Brandolini, there is no good way to do it online, the same way you do not organize “toga party” online.

There have been some attempts to make remote/virtual Event Storming but my feeling is all of them miss some important energy we get when standing together under an unlimited modeling space, working chaotically. The remote Event Storming misses the chaos, and in this case, it’s a bad thing.

However things change… maybe you will find a good way to use it, maybe you could think of some new tools that will “embrace chaos” and allow you to get back that energy. I’ve tried… but I’ve failed. Some said that it was a success. Try it for yourself. Share the experiences. Let’s learn from each other because you know… “we’re learners”!

Domain Storytelling

Domain Storytelling is a collaborative modeling method developed by Henning Schwentner and Stefan Hofer. It relies on a fact that telling stories is a fundamental way of human communication and business experts are the storytellers (at least most of them). It uses a simple pictographic language with three essential types of symbols: actors (usually named with a role identifier), work objects and activities to visualize the stories told by domain experts. Domain Stories are told from the perspective of actors, which play an active role in the Domain Story. Actors create, work with, and exchange work objects such as documents, physical items, and digital objects.

The modeler should focus on true stories, no abstract generalizations, no hypotheticals, just concrete examples of what is happening in a domain.

Sometimes three good examples are more helpful to understand the requirements than a bad abstraction.

Start with drawing the default/happy case, model important variations and error cases as separate Domain Stories.

Telling the stories are natural for humans so this method is easy to explain to your collaborators. It’s easy to understand, easy to follow and very easy to do it remotely. There is a dedicated online tool where you could draw Domain Stories https://www.wps.de/modeler but this is not the only one option. Anything that works for you and is easy to share will work. You could read more about Domain Storytelling here.

Story Storming

Another technique is the Story Storming created by Martin Schimak. It is influenced by Domain Storytelling and Event Storming but also by other ways to map business requirements like Event Modelling and User Story Mapping. It starts with very simple, easy to explain notation. You use tree kinds of post-its: Subject, Verb and Object. And like in any language you build simple sentences. You describe the domain story with these simple sentences, using very specific, concrete examples. As a modeler you have to focus on language, the simplicity of the sentences enables domain experts to tell their stories in a natural manner. No need to learn a new technique, no barriers to start using it, no need for technical background. Learn more about Story Storming here.

Sync vs Async

Remote work gives you an opportunity to avoid sync meetings. Yes, sometimes this is much easier to just have a shared screen and work together - especially when your domain expert is not very technically savvy. It would work better also at the beginning of the modeling when you need to establish basics of the language (ubiquitous language is not defined from the begging - this is something you need to build together) and gain trust from the business. So start with sync, and then it depends on you and your collaborators how you want to continue.

Embracing async is not easy, it will cause some friction and misunderstandings but don’t let it stop you. With time your understanding of domain will grow, also you will learn how to work better with your domain experts and they will learn how to share the domain knowledge with you.

Async modeling has also some advantages. It’s is slower. And that is a good thing. You have time to think about your model, about what is important and about examples you are working with.

There is more, give it a try!

I’ve shown you only a few techniques here, but there is more. To name a few:

  • Event Modelling
  • User story mapping
  • Impact Mapping
  • Business Model Canvas
  • Example mapping
  • Specification by Example

Go check them. Find the one suitable for your needs. Start using it. Share your experiences. Help others to understand good and bad parts of the techniques, but remember your mileage may vary :)

You might also like