Skip to content

Latest commit

 

History

History

content-guidelines

Content Guidelines

These guidelines provide rules and tips to all who contribute content to the Kyma repositories.

Content Strategy: Understand our target audience and document templates.

User Documentation: Publish documentation on kyma-project.io.

Style and Terminology: Use active voice and present tense. Look up correct capitalization and vocabulary.

Formatting: Learn about code font and bold font, how to create "Note" boxes, and correct headings.

UI Elements: Create concise buttons, tooltips, and (error) messages.

Tabs and Toggles: Create tabs or expandable sections, for example, for code blocks.

Links: Create meaningful links.

Release Notes: Write release notes for (pre-modular) Kyma.

Screenshots: Create useful screenshots.

Diagrams: Learn about the diagram style we use in Kyma.

Documentation Preview: Before publishing on kyma-project.io, check how your docs will look like.