title |
---|
Document types templates |
Use a particular document type template to be consistent with the Kyma standards. The tables provide an overview of the template names, the repository they refer to, and their usage:
NOTE: If a template does not specify otherwise, all sections are optional.
This table contains templates for general documents, such as NOTES.txt
and README.md
document types.
Repository | Template | Usage | Author |
---|---|---|---|
kyma |
NOTES.txt |
Use the template for charts. | All contributors |
All | README.md |
Use the template for the README.md document in any repository, directory, or subdirectory within the Kyma organization. |
All contributors |
This table lists all document types used to fully describe a Kyma area and/or component.
Repository | Template | Usage | Author |
---|---|---|---|
kyma/docs |
concept.md |
Use the template to introduce a given concept. | All contributors |
kyma/docs |
architecture.md |
Use the template to describe the architecture of a Kyma component. | All contributors |
kyma/docs |
configuration.md |
Use the template to describe configuration options for a Kyma chart or sub-chart. | All contributors |
kyma/docs |
custom-resource.md |
Use the template to describe a custom resource (CR) and its elements. | All contributors |
kyma/docs |
tutorials.md |
Use the template to provide a clear step-by-step instruction that helps the user to understand a given concept better. | All contributors |
kyma/docs |
troubleshooting.md |
Use the template to explain all details needed for Kyma and its components' troubleshooting. | All contributors |
See the following table to find a template of Kyma graphics and logo.
Repository | Template | Usage | Author |
---|---|---|---|
No specific repository | Official Kyma graphics and logo |
Use these graphics for any Kyma-related communication. | All contributors |
See the templates for providing input and writing release notes.
Repository | Template | Usage | Author |
---|---|---|---|
website/content/blog-posts |
release-notes.md |
Use the template to write release notes. | Technical Writers |
Internal use | release-notes-input.md |
Use the template to provide input for the release notes. | Product Owners |
Go to the repository-templates
directory for the template of an exemplary Kyma repository.
In the table you can find README.md
and meeting notes templates for SIGs and WGs.
Repository | Template | Usage | Author |
---|---|---|---|
community/sigs-and-wgs |
sig-wg-readme-template.md |
Use the template for the main README.md document in a given SIG or WG folder. |
SIG and WG members |
community/sigs-and-wgs |
sig-wg-meeting-notes-template.md |
Use the template to document meeting notes of a given SIG or WG. | SIG and WG members |