some tweaks to documentation/comments