Revert "Revert "updated comments""

This reverts commit 8a67e4b2eaef4f2777260f411b9a40526936b092.