Skip to content

Latest commit

 

History

History
18 lines (17 loc) · 1.72 KB

architecture.md

File metadata and controls

18 lines (17 loc) · 1.72 KB
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 {000}-architecture-{component}.md convention to name the document.
  • In the metadata section, follow the {Component name} architecture convention for the title if there are more than one Architecture document in a repository. If there is only one document of a certain type, remove the type metadata completely so that the document displays well on the UI.

For reference, see the existing Architecture document for the Remote Environment Broker.