finalize changes to documentation for now