updated docs on comment format