improved documentation [skip ci]