On: What I wish someone told me about Postgres

[PhilippGille]

I love the diagrams from the SQLite documentation: https://www.sqlite.org/syntaxdiagrams.html

[teddyh → PhilippGille]

Those are commonly called “railroad diagrams”: <https://en.wikipedia.org/w/index.php?title=Syntax_diagram&ol...>

[o11c → PhilippGille]

I've been bitten by those before because they are not generated from the actual syntax-parsing code, and thus are sometimes out of sync and wrong (or at least misleading).

[christophilus → PhilippGille]

SQLite diagrams plus examples are pretty much the way I wish all of my documentation worked.