clarify how-to titls (Kong#1758)

brains-platform · Feb 3, 2020 · 3e2cfb8 · 3e2cfb8
1 parent d9aa81a
commit 3e2cfb8
Showing 1 changed file with 3 additions and 3 deletions.
diff --git a/TECHNICAL-WRITING-GUIDE.md b/TECHNICAL-WRITING-GUIDE.md
@@ -103,8 +103,7 @@ a specific concept.
 
 ### How-to Guides
 
-How-to guides should solve an explicit problem or accomplish a specific task
-such as “How to Delete an Admin”
+How-to guides should solve an explicit problem or accomplish a specific task.
 
 They should follow the following structure:
 
@@ -123,7 +122,8 @@ a starting point.
 
 *Title [h1]*
 
-How-to guide titles typically follow the “How to [X] using [Y]” format.
+How-to guide titles typically follow the “[imperative verb] + [object] + [details]” format, e.g.,
+"Delete an Admin," "Install Kong on Amazon Linux"
 
 *Table of Contents [h4]*