At work we’ve adopted ADR’s - Architecture Decision Records. These are similar to RFC’s but a little bit lighter weight. We generally use them for any architectural decision we make which is likely to affect more than one person, which took a while to understand, or will be impactful over a long time.
The great thing about them is that they’re structured to be able to be written in a stream of consciousness, to articulate the context (this is usually the most important thing), the decision, and its impact.
If we don’t have a decision immediately we can leave it open as a PR for discussion before finishing it.
At work we’ve adopted ADR’s - Architecture Decision Records. These are similar to RFC’s but a little bit lighter weight. We generally use them for any architectural decision we make which is likely to affect more than one person, which took a while to understand, or will be impactful over a long time.
The great thing about them is that they’re structured to be able to be written in a stream of consciousness, to articulate the context (this is usually the most important thing), the decision, and its impact.
If we don’t have a decision immediately we can leave it open as a PR for discussion before finishing it.