final documentation updates