title | type |
---|---|
Architecture |
Architecture |
NOTE: Blockquotes in this document provide instructions. Remove them from the final document.
This is a template for the Architecture document type that describes in detail the architecture of a given Kyma component. This document should include, among others, the diagram which illustrates all components and sub-components involved, a description of the functions they perform, and a step-by-step description of the workflow.
In the document:
- Provide a diagram which illustrates the workflow of a given component. The diagram is a mandatory element of this document.
- Describe all components and sub-components involved in the workflow together with their functions.
- Use an ordered list to describe a step-by-step workflow.
- Use sections if the document does not describe any workflow but the overall arrangement of the components and sub-components. In this case, each component should be described in a separate section. Use H2 (##) for sections and H3 (###) for sub-sections. Do not use headings smaller than H3 as they do not display well on the UI.
- Follow the
02-{00}-{component-name}.md
convention to name the document.- In the metadata section, follow the
{Component name} architecture
convention for thetitle
if there are more than one Architecture document in a repository. If there is only one document of a certain type, remove thetype
metadata completely so that the document displays well on the UI.For reference, see the existing Architecture document for the Remote Environment Broker.