diff --git a/docs/modules.md b/docs/modules.md
index 8e6825b4..0093ae81 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -7,18 +7,18 @@ This topic briefly describes the relevant Node.js modules on which a swagger pro
* [swagger-editor](#swagger-editor)
* [swagger-tools](#swagger-tools)
-###swagger
+### swagger
The `swagger` npm module provides everything you need to create new projects, including the Swagger editor, Swagger Tools middleware, sample project skeletons, and the `swagger` command-line tools.
-####Installation
+#### Installation
For installation instructions, see "[Installation](./install.md)".
-####Documentation
+#### Documentation
The main source of documentation for the swagger module and related components is in the swagger-node repository on GitHub.
-####Installation
+#### Installation
The swagger command-line tools are installed with swagger.
@@ -39,11 +39,11 @@ See the swagger "[Quick start](./quick-start.md)" to see how easy it is to get a
The Swagger Editor lets you design your API specification and interactively preview its documentation for your swagger API project.
-####Installation
+#### Installation
Standard npm install. Installed with swagger.
-####Documentation
+#### Documentation
See "[Swagger Editor](https://github.com/swagger-api/swagger-editor)" on GitHub.
@@ -51,11 +51,11 @@ See "[Swagger Editor](https://github.com/swagger-api/swagger-editor)" on GitHub.
Middleware for Node.js including Message Validation, Authorization and Routing.
-####Installation
+#### Installation
Standard npm install. Installed with swagger.
-####Documentation
+#### Documentation
See the `swagger-tools` [README](https://github.com/apigee-127/swagger-tools) on GitHub.
diff --git a/docs/swagger-file.md b/docs/swagger-file.md
index 8f50e0fd..2f12da62 100644
--- a/docs/swagger-file.md
+++ b/docs/swagger-file.md
@@ -56,7 +56,7 @@ Here is the entire `swagger.yaml` file that is provisioned for a new swagger pro
```
-###OpenAPI Specification elements
+### OpenAPI Specification elements
The Swagger file includes a number of standard OpenAPI 2.0 Specification elements. You can read about them in the [OpenAPI 2.0 Specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md).