docs(parser): improve documentation with Pydantic best practices

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