/book

Architecture documents

Apache License 2.0Apache-2.0

Book of Janus

This repository contains the technical and architecture documents for the Janus project.

Guide to Sections

The Technical Overview Document

/book folder hosts the technical overview document. This document represents the latest state of agreed technical and architectural decisions. See contributing on how to propose changes.

Architecture Diagrams

/diagrams folder stores the diagrams used on the overview document and slides. These diagrams are done using excalidraw.com and stored in .svg format.

ADRs

/ADR folder contains the ADRs that are executed as part of the process to update these documents as explained in contributing](#contributing) section.

Contributing

All changes to the documents and diagrams require a peer-reviewed pull request.

For significant changes that include changes to technical details or architecture the pull request should have

  1. Changes to the overview document, slides and diagrams where applicable.
  2. An ADR record is added to the /ADR folder.
  3. At least 2 approvals are required to be merged

The changes that are corrections and clarifications and that do not reflect a significant change pull request should have

  1. Changes to the overview document, slides and diagrams where applicable.
  2. At least 1 approval