improved docs [ci skip]