documentation improvements and cleanup