adding doc fixes for #1179
Merge pull request #1184 from bitovi/1179-docs

adding doc fixes for #1179