Hello, Thanks for your feedback.
> To be honest with a background more in database systems than java > programming, these diagrams provide a lot more insight to me than many other > parts of the docs. Yes, formally adding BNF notations (and generated diagrams thereof) to the manual is on the roadmap: https://github.com/jOOQ/jOOQ/issues/1737 For the diagrams that you've discovered, I have used this tool: http://railroad.my28msec.com/rr/ui Do you happen to know of any similar tool that can generate SVGs and/or PNGs from BNF notations in Java? That would be a requirement for generally adding diagrams to the manual Cheers Lukas
