improve source documentation [ci skip]