improve YARD docs [ci skip]