Architecture Repository/Process/Contributing

= =

How to maintain the Architecture Repository

Status: Ongoing development

Page format
All subpages of Architecture Repository must start with:

Excerpt
The excerpt must be a short description of the subject of the page, no longer than one sentence. It may be a sentence fragment. Excerpts appear at the top of the page and are used on navigation pages. To use an excerpt on a navigation page, add the following template:

Table of contents
For a right-aligned table of content,  may be replaced with. For landing pages or short pages,  may be replaced with.

Status
The page status field provides helpful context around the state of a document. Page statues can be customized to include any useful information. Here are a few example statues used in the Repository:


 * Draft
 * Page content is incomplete, pending review, or otherwise not finalized.


 * Ongoing development
 * Page content is valid and reliable but can be expected to change periodically, most likely by addition. This is a useful status for landing pages and lists.


 * v1 released January 1, 2020
 * v2 released December 1, 2020, added lessons learned
 * Page content was finalized on the date listed. The version number should start at 1 and increment whenever a significant change has been made. Incremented versions should include a brief note about the change made, relying on page history for a complete diff. Dates must be written out fully to avoid confusion between date formats.

Max width
The maximum width and padding styles are intended to improve readability and create a consistent layout across the Repository.