Document the parser for future developers

### Developer docs

- [ ] How does the parser work
- [ ] How to customise
- [ ] How to debug

### Behaviour & assumptions

- [ ] Node connectivity
  - pattern
- [ ] Attributes
- [ ] Nested attribute lookup
  - fail silently when absent