core documentation updates