more work on docs [ci skip]