Commit 6fcbe60a by oddlittlebird Committed by Torkel Ödegaard

Docs: Update documentation-style-guide.md (#19292)

* Update documentation-style-guide.md

Added heading rules

* Update documentation-style-guide.md

Added ampersand rule
parent 50b4695c
...@@ -21,6 +21,8 @@ For all items not covered in this guide, refer to the [Microsoft Style Guide](ht ...@@ -21,6 +21,8 @@ For all items not covered in this guide, refer to the [Microsoft Style Guide](ht
* Write in present tense. * Write in present tense.
- Not: The panel will open. - Not: The panel will open.
- Use: The panel opens. Grafana opens the panel. - Use: The panel opens. Grafana opens the panel.
* Do not use an ampersand (&) as an abbreviation for "and."
- **Exceptions:** If an ampersand is used in the Grafana UI, then match the UI.
### File naming conventions ### File naming conventions
...@@ -36,6 +38,9 @@ For all items not covered in this guide, refer to the [Microsoft Style Guide](ht ...@@ -36,6 +38,9 @@ For all items not covered in this guide, refer to the [Microsoft Style Guide](ht
* Task topic headings start with a verb. * Task topic headings start with a verb.
- Write a query. Create a dashboard. - Write a query. Create a dashboard.
* Concept and reference topic headings should be nouns or gerunds. Examples: Contributing to docs, Visualizations, Style guide * Concept and reference topic headings should be nouns or gerunds. Examples: Contributing to docs, Visualizations, Style guide
* Avoid following one heading with another heading.
* Avoid skipping heading levels. For example, an h1 should be followed by an h2 rather than an h3.
* Avoid having just one lower-level heading. For example, h1, h2, h2, h3, h3, h2 is a good order. Do no go h1, h2, h3, h2, h3, h2.
### Images ### Images
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment