Clarify a few design decisions in the sample app with comments.