documentation tweak

updated a few comments