add yard documentation config
cleanup doc markup [ci skip]