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
Agreed, we should say this more softly. Maybe
>This API is currently in **Beta** status. The state model and data contracts will not change, but there may be additional attributes added to the JSON or minor semantic changes until the API reaches GA status.