Merge pull request #2130 from JinShil/style_guide

Wordsmithing style guide's doc comments
merged-on-behalf-of: Sebastian Wilzbach <sebi.wilzbach@gmail.com>

Author: dlang-bot

dstyle.dd

@@ -396,7 +396,7 @@ class MyClass
 )
 
 $(LISTSECTION phobos_documentation, Documentation,
-    $(LI Every public symbol be exposed on the documentation:)
+    $(LI Every public symbol should be exposed in the documentation:)
 ---
 /// A public symbol
 enum myFancyConstant;
@@ -420,7 +420,7 @@ bool isPositive(int number)
     return number > 0;
 }
 ---
-    $(LI Text in sections (e.g. `Params:`, `Returns:`, `See_Also`) should be indented by one level if spans more than the line of the section.)
+    $(LI Text in sections (e.g. `Params:`, `Returns:`, `See_Also`) should be indented by one level if it spans more than the line of the section.)
     $(LI Documentation comments should not use more than two stars `/**` in the header line.)
     $(LI Block comments (`/**`) should be used - not nesting block comments (`/++`))
     $(LI Global functions shouldn't indent their documentation block nor use stars as indentation.)