fixing warnings and errors in documentation