improved docs /2