Additions and changes to docs and comments.

Some additions and clarifications to docs and comments,
mainly in app.js, test_app.js, and models/charm.js, including
the promotion to docs of a nice long comment in the latter.

R=matthew.scott, gary.poster
CC=
https://codereview.appspot.com/7204057