usage documentation updates