internal documentation updates