docs(parser): change parser documentation - WIP

[anafalcao]

Issue number: #1371

Summary

Changes

draft to change parser documentation

User experience

Please share what the user experience looks like before and after this change

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• [x] Meet tenets criteria
• [x] I have performed a self-review of this change
• [x] Changes have been tested
• [x] Changes are documented
• [x] PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• [ ] Migration process documented
• [ ] Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.