improve readme and docs [ci skip]