Improve documentation - refs BT#8783