*8471* improve documentation