updates to documentation, improved logging