Tools to Solve Common Problems
Learn about some common tools to help you identify and solve your problems as a manager.
We'll cover the following...
The final section of this chapter introduces you to some additional housekeeping techniques that can solve common problems and produce documentation that you can review with time. Let’s look at them in turn.
Why is this code like this?
We’ve all been there, staring at code that’s been designed in an esoteric manner. Maybe it’s your own code, and you can’t remember why it wasn’t written differently. To prevent problems like this from happening in the future, you can use an Architecture Decision Record (ADR).
As you progress on your own projects and reach a decision point, like a design choice, whether that be stylistic, framework-related, or a choice on how to build some infrastructure, you can capture that choice in an ADR. This website in the footnote has links to a number of templates that you can use, but broadly speaking, an ADR should capture:
- The point in time in which the decision was made
- The status of the ADR (proposed, accepted, rejected, and so on
- The current context and business priorities that led to the decision
- The decision itself (What are we doing as a result