doc fixes, closes #517 [ci skip]