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
Just to preface this with a few more details:
>The authentication flow uses a state machine and standard JSON HAL ("next"/"prev" links) to navigate through it. The  current state is tracked in a state token, which is returned in each response and required to be passed back in on the next request. The following table shows the possible statuses for this token: