further improve documentation