small improvements to parsing api docs