One-time PR for Doc Reviews

@croche-okta @wdawson-okta @srinivasanagandla-okta @stsai-okta @lboyette-okta @hoanguyen-okta @karlmcguinness-okta @cwu-okta @tthompson-okta @eklein-okta

Hi team,

Since the material has been pushed to master, this pull request is a little unusual. Please add any comments to the docs here by the end of the day Monday, September 29, 2014. I will make changes and create a new branch and a new PR for the changes. Then, I will discard this PR. 

Please ping me if this doesn't work for you.

Thanks,
Evan
Let's leave the latter part about POSTing to authn/credentials/change_password out; that is captured in the JSON HAL, and we may freely change it, along with any URLs that are within the state machine since they are all identified by a "next" link.