Merge pull request #63 from dret/patch-1

minor fixes

Author: darrelmiller

specification/docs.md

@@ -11,7 +11,7 @@ Besides machine-readable descriptions, an OpenAPI Description (OAD) can also inc
 
 This page shows how to take full advantage of special documentation capabilities in OpenAPI like markdown syntax or example objects.
 
-## The Documentation Fields
+## The Description Field
 
 Almost every object in the OpenAPI Specification accepts a `description` field which can provide additional information for developers, beyond what can be automatically generated from the API descriptions.
 
@@ -142,7 +142,7 @@ A fenced code block
 ![Alt text](Image URL)
 ```
 
-## The Example Object
+## Adding Examples
 
 Finally, some OpenAPI objects can list examples explicitly instead of having them embedded in the `description` field, enabling automated processing by tools.