Project Lionheart: The Story So Far…

Software development is in full swing and progressing nicely. Every day we learn something new about the problem we’re solving. The architecture is becoming more mature with every detail. The team draws pictures regularly to bounce ideas off each other and work through alternatives.

Teammates frequently sketch the same diagrams during design discussions. You take a picture of some whiteboard sketches with your phone and add the pictures to your source code repository along with with a brief write-up. You also start to build out element responsibility views so it’s easier to explain how everything works together. So far these views have been most useful when we add new elements to the architecture.

Up to this point in the project we’ve only shared design decisions informally. And we’ve had a few misses because of this. You decide it’s probably time for us to improve our documentation and rely less on tribal knowledge.