commenting and docs fixes