documentation updates from jason