Readme cleanup + docs clarity [#120578743]

Dannyzen · Dannyzen · commit 44c475a4ad4e · 2016-05-31T09:02:04.000-04:00
diff --git a/README.md b/README.md
@@ -7,11 +7,11 @@ This is based on the [Heroku buildpack] (https://github.com/heroku/heroku-buildp
 
 This buildpack supports running Django and Flask apps.
 
-## Using the Buildpack
+### Buildpack User Documentation
 
-For information on deploying Python applications visit [CloudFoundry.org](http://docs.cloudfoundry.org/buildpacks/python/index.html).
+Official buildpack documentation can be found at http://docs.cloudfoundry.org/buildpacks/python/index.html.
 
-# Building the Buildpack
+### Building the Buildpack
 
 1. Make sure you have fetched submodules
 
@@ -40,7 +40,7 @@ For information on deploying Python applications visit [CloudFoundry.org](http:/
     cf push my_app -b custom_python_buildpack
     ```
 
-## Testing
+### Testing
 Buildpacks use the [Machete](https://github.com/cloudfoundry/machete) framework for running integration tests.
 
 To test a buildpack, run the following command from the buildpack's directory:
@@ -51,18 +51,18 @@ BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-build
 
 More options can be found on Machete's [Github page.](https://github.com/cloudfoundry/machete)
 
-## Contributing
+### Contributing
 
 Find our guidelines [here](./CONTRIBUTING.md).
 
-## Help and Support
+### Help and Support
 
 Join the #buildpacks channel in our [Slack community] (http://slack.cloudfoundry.org/) if you need any further assistance.
 
-## Reporting Issues
+### Reporting Issues
 
 Open a GitHub issue on this project [here](https://github.com/cloudfoundry/python-buildpack/issues/new)
 
-## Active Development
+### Active Development
 
 The project backlog is on [Pivotal Tracker](https://www.pivotaltracker.com/projects/1042066)
