updating documentation on commenting