I don't like these inline comments and I don't think we should include those in the docs.