Adding documentation for service plan schemas.

[Albertoimpl]

As part of the service plan schemas work we updated some of the responses.
In order to keep the documentation up to date we did some modifications.
The associated PRs are:

• Service broker create instance schemas #834
• Broker schema validation #842
• Service Broker Create Service Instance Schema Validation #847
• Service broker update instance schemas #865
• Add service broker create binding schema #866

• I have viewed signed and have submitted the Contributor License Agreement

• I have made this pull request to the master branch

• I have run all the unit tests using bundle exec rake

• I have run CF Acceptance Tests on bosh lite

[cfdreddbot]

Hey AlbertoImpl!

Thanks for submitting this pull request!

All pull request submitters and commit authors must have a Contributor License Agreement (CLA) on-file with us. Please sign the appropriate CLA (individual or corporate).

When sending signed CLA please provide your github username in case of individual CLA or the list of github usernames that can make pull requests on behalf of your organization.

If you are confident that you're covered under a Corporate CLA, please make sure you've publicized your membership in the appropriate Github Org, per these instructions.

Once you've publicized your membership, one of the owners of this repository can close and reopen this pull request, and dreddbot will take another look.

[cf-gitbot]

We have created an issue in Pivotal Tracker to manage this:

https://www.pivotaltracker.com/story/show/150745644

The labels on this github issue will be updated when the story is started.