improved docs /3