improved documentation [ci skip]