documentation and logging updates