diff --git a/log4brains/index.html b/log4brains/index.html index 46ae473..c5410c0 100644 --- a/log4brains/index.html +++ b/log4brains/index.html @@ -1,4 +1,4 @@ -Architecture knowledge base of Github Decision Records
Log4brains logo
+ }
Log4brains logo

Architecture knowledge base

Welcome 👋 to the architecture knowledge base for Wayne Goosen's GitHub profile. You will find here all the Architecture Decision Records (ADR) for all projects.

An Experiment with Architecture Decision Records¶

This repository employs Log4Brains to publish all Architectural Decision Records (ADRs) within it.

The experiment: Use ADRs to keep track of all decisions made across projects within my GitHub profile. If a project grows significantly, move all relevant ADRs to its own repository.

Why?¶

  1. To maintain a log of all decisions for historical and recall purposes. It's easy to forget WHY a certain approach was taken.
  2. For visibility... Decisions in software development are trade-offs that depend on the situation and context. This will help in understanding certain decisions.
  3. To practice crafting ADRs. This thought-provoking process will ideally lead to better decision-making.
  4. To instill a level of professionalism in side projects.

Structure¶

There are two distinct levels of ADRs:

  • Global: Decisions that impact all repositories.
  • Repository specific: Decisions exclusive to a particular project or product within a repository.

The repository-specific ones are added as 'packages' within the Log4Brains structure. You can identify these by the package name next to the title within the user interface.

ADRs¶

Definition and purpose¶

An Architectural Decision (AD) is a software design choice that addresses a functional or non-functional requirement that is architecturally significant. An Architectural Decision Record (ADR) captures a single AD, such as often done when writing personal notes or meeting minutes; the collection of ADRs created and maintained in a project constitutes its decision log.