(#2022) - minor fixes to the docs