This repository contains the technical and architecture documents for AppStudio. User documentation is out of scope.

/architecture 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.

/ref folder hosts the API references for all the related services. These API references are generated during publish flow.

/diagrams folder stores the diagrams used on the overview document. These diagrams are done using draw.io and stored in .svg format.

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

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 and diagrams where applicable.
2. An ADR record is added to the /ADR folder.
3. At least 2 approvals 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 and diagrams where applicable.
2. Should have a skip-adr-check label
3. At least 1 approval