I would absolutely love to see more and better examples in the docs, particularly from the excellent @BulldogLowell! If you have an idea of what it should be, go ahead and PR and I'll take a look.
I will write up my use case and example when I get my parser working if that would also be helpful.