Minor reword

Keno · KristofferC · commit 3208679d526b · 2020-04-11T19:32:10.000+02:00
diff --git a/doc/src/manual/documentation.md b/doc/src/manual/documentation.md
@@ -335,7 +335,8 @@ y = MyType("y")
 
 ## Syntax Guide
 
-A comprehensive overview of all documentable Julia syntax.
+This guide provides a comprehensive overview of how to attach documentation to all Julia syntax
+constructs for which providing documentation is possible.
 
 In the following examples `"..."` is used to illustrate an arbitrary docstring.
 
diff --git a/stdlib/Markdown/docs/src/index.md b/stdlib/Markdown/docs/src/index.md
@@ -21,7 +21,7 @@ A paragraph containing a **bold** word.
 Surround words with one asterisk, `*`, to display the enclosed text in italics.
 
 ```
-A paragraph containing an *emphasized* word.
+A paragraph containing an *italicized* word.
 ```
 
 ### Literals
