addressed doc comments in #11