Committing api doc updates
added future state example