A language for describing resource-oriented APIs & turning them into Swagger or resource diagrams. Oriented around the concepts we want to expose in the APIs.
Links from one grammar production to another, such as "Used by", "References". I don't know about these specific diagrams, but I have used similar diagrams in the past that had active links from the diagram "bubbles" to the other productions. That was nice for exploration of the grammar structure.
The generated PDF seems to be "paper" oriented. Some diagrams are too wide for a printed page, and they're chopped off on the right.
The presentation order seems pretty random. Would be great if the productions appeared in a logical, top-down flow.
Would be ideal if we could present the HTML as the display format. Would take some investigation in github. Even if github didn't support HTML, would be sufficient to download the HTML and then load a local file into one's browser.
The current railroad diagrams, https://github.com/LiveRamp/reslang/blob/master/docs/bnf/railroad-for-reslang.pdf, are generated as a PDF. This disables some useful features from the "raw" HTML: