Skip to content

Commit 326d363

Browse files
committed
made Joan's changes
1 parent 6fe3a27 commit 326d363

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

supplementary_style_guide/style_guidelines/grammar.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -115,13 +115,13 @@ Know what your users do, what their goals are, and why they perform these action
115115
=== Findability
116116
Findability covers two areas:
117117

118-
* Make sure your content is findable through Google search and access.redhat.com site searches.
119-
* Make sure your content is scannable. Use short paragraphs and sentences and bulleted lists where appropriate.
118+
* Ensure your content is findable through Google search and access.redhat.com site searches.
119+
* Ensure your content is scannable. Use short paragraphs and sentences and bulleted lists where appropriate.
120120

121121
=== Titles and headings
122-
Have clear titles that use keywords the customer knows. Keep titles and headings to 3-11 words. If headings are too short, they don’t help customers know what’s in a section. If they’re too long, they don’t show up well in a Google search, and customers can’t absorb them.
122+
Use clear titles with familiar keywords for customers. Keep titles and headings between 3 to 11 words. Headings that are too short lack clarity and don’t help customers know what’s in a section. Headings that are too long are less visible in Google searches and harder for customers to understand.
123123

124-
=== Eliminating fluff
124+
=== Elimination of fluff
125125
Avoid long introductions and unnecessary context. Shorten unnecessarily long sentences.
126126

127127
=== Error recovery, verification, and troubleshooting

0 commit comments

Comments
 (0)