CORE-3451: documentation updates