docs(parser): improve documentation with Pydantic best practices (#5925)

docs(parser): improve documentation with Pydantic best practices (#5925) #4105