Code review comment for lp:~bcsaller/juju-gui/framework-docs

To be clear, I am fine with you landing this with the document changes
that I have suggested (or similar ones, after reconciling my review and
the other). I do not need for the framework changes I mentioned to be
made in this branch. If you agree with those suggestions, though, please
make bugs and cards for them, or ask me to. I would be happy to.

https://codereview.appspot.com/6858085/