final fixes for logging, documentation, etc..