updates from issue #13 for console and command line APIs

I believe I captured all the updates for these docs. Let me know if I missed anything.