update documentation

a few fixes and updates to the documentation