Update documentation-style-guide.md (#28037)

81ec13b7 · Diana Payton · GitHub · 1c865b5b · 81ec13b7
Commit 81ec13b7 authored Oct 05, 2020 by Diana Payton Committed by GitHub Oct 05, 2020
Show whitespace changes
Inline Side-by-side

Showing with 2 additions and 0 deletions

contribute/style-guides/documentation-style-guide.md
+2 -0

No files found.
--- a/contribute/style-guides/documentation-style-guide.md
+++ b/contribute/style-guides/documentation-style-guide.md
@@ -61,6 +61,8 @@ The following sections provide general guidelines on topics specific to Grafana 
  - **Exceptions:** If an ampersand is used in the Grafana UI, then match the UI.
 - Avoid using internal slang and jargon in technical documentation.
 - Do not use two spaces after a period. Only add one space after each sentence. Do not add a space at the end of the paragraph.
+- Sentence length should be 25 words or less. If your thought is longer than 25 words, consider breaking up the sentence or changing the format to a list.
+- Paragraphs should be three sentences or fewer. Break up long paragraphs.

 ### File naming conventions