more comment changes as well as documentation changes. No functional changes