various updates to the documentation file