Stream: cql
Topic: Railroad diagrams
Bryn Rhodes (Jul 07 2020 at 20:52):
J#27514 asks for more clarity around the grammar, so I've done a bit of fiddling with a railroad diagram generator. What do folks think of including this type of diagram: index.pdf
Bryn Rhodes (Jul 07 2020 at 20:52):
Note that in this PDF the image sizing is messed up, it actually looks really good in the HTML.
Chris Moesel (Jul 08 2020 at 02:47):
I think it's kind of cool. Where were you thinking it would go in the spec? Would it just be a page full or RR diagrams or would you integrate them into the narrative content somehow?
Bryn Rhodes (Jul 08 2020 at 03:46):
I think to really be useful they'd have to be part of the narrative. And to _really_ be useful, they'd have to be hyperlinked. Which seems possible with this tool, but looks like it would take some effort. So before committing to doing that I'd really want to make sure people would find them helpful.
Frank Adrian (Aug 07 2020 at 15:30):
The scale of the railroad diagram elements should be properly normalized, too. The difference in size between the elements in (for example) library vs. localIdentifier is very jarring and the small size on large productions makes them difficult to read.
Bryn Rhodes (Aug 11 2020 at 07:47):
Yes, the scaling is happening because of the rendering to a PDF. When rendered in a website, the images are all the same size.
Last updated: Apr 12 2022 at 19:14 UTC
