Architecture knowledge base

Welcome πŸ‘‹ to the architecture knowledge base of the Identus platform.

You will find here all the Architecture Decision Records (ADR) of the project.

The introduction of ADRs was approved in RFC-0016

Engeering guidance on creating and managing ADRs can be found here

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.

An ADR is immutable: only its status can change (i.e., become deprecated or superseded). That way, you can become familiar with the whole project history just by reading its decision log in chronological order. Moreover, maintaining this documentation aims at:

  • πŸš€ Improving and speeding up the onboarding of a new team member
  • πŸ”­ Avoiding blind acceptance/reversal of a past decision (cf Michael Nygard's famous article on ADRs)
  • 🀝 Formalizing the decision process of the team


This website is automatically updated after a change on the main branch of the project's Git repository. In fact, the developers manage this documentation directly with markdown files located next to their code, so it is more convenient for them to keep it up-to-date. You can browse the ADRs by using the left menu or the search bar.

More informationΒΆ