Adding docbook-based docs

* Adding and Updating examples
* Adding docs for two-step create
* Additional updates after tech review
* Updating CR for Constance to help with the review - JMV
* Updating API endpoints - JMV
* Fixing WADL create order & secret methods to a POST - JMV

Change-Id: I0a06c4f7058ba801a9a09e952c5a143189922b9b
Merge "Adding docbook-based docs"