On 2019-09-23 00:03, Tom Lane wrote: > While we're whining about this, I find it very off-putting that > the jsonpath stuff was inserted in the JSON functions section > ahead of the actual JSON functions. I think it should have > gone after them, because it feels like a barely-related interjection > as it stands. Maybe there's even a case that it should be > its own <sect1>, after the "functions-json" section.
I'd just switch the sect2's around. That would be similar to how the documentation of regular expressions is laid out: functions first, then details of the contained mini-language. -- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services