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 README.md
and NOTES.txt
documentent types.
Repository | Template(s) | Usage | Author |
---|---|---|---|
kyma |
README.md , NOTES.txt |
Use the template for charts. | All contributors |
examples |
README.md |
Use the template for examples. | 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 |
See the following table to find a template of Kyma graphics and logo.
Repository | Template(s) | Usage | Author |
---|---|---|---|
No specific repository | Official Kyma graphics and logo |
Use these graphics for any Kyma-related communication. | All contributors |
This table lists all document types used to fully describe a Kyma component.
Repository | Template(s) | Usage | Author |
---|---|---|---|
kyma/docs |
overview.md |
Use the template to introduce a Kyma component. | All contributors |
kyma/docs |
architecture.md |
Use the template to describe the architecture of a Kyma component. | All contributors |
kyma/docs |
details.md |
Use the template to provide more details about 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 |
cli-reference.md |
Use the template to describe the syntax and the use of CLI commands for a given component. | 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 |
kyma/docs |
metrics.md |
Use the template to describe custom and default metrics for services or controllers. | All contributors |
In the table you can find README.md
and meeting notes templates for SIGs and WGs.
Repository | Template(s) | Usage | Author |
---|---|---|---|
community/sig-and-wg |
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/sig-and-wg |
sig-wg-meeting-notes-template.md |
Use the template to document meeting notes of a given SIG or WG. | SIG and WG members |
See the templates for providing input and writing release notes.
Repository | Template(s) | 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 |
NOTE: Update the tables each time you add a new template to the
resources
folder.
Go to the repository guidelines section for the template of an exemplary Kyma repository.