fully document the module
typos