minor changes to function documentation
Merge branch 'fix-documentation' into develop