Re: Another modest proposal for docs formatting: catalog descriptions

2020-05-06 Thread Alvaro Herrera
On 2020-May-06, Jonathan S. Katz wrote: > I know that 9.6 uses a different subset of the styles, and I recall the > text being blue during the original conversion. For example, the "table" > in the 9.6 docs has a class of "CALSTABLE" whereas in master, it is > "table" (and we operate off of it as

Re: Another modest proposal for docs formatting: catalog descriptions

2020-05-06 Thread Jonathan S. Katz
On 5/6/20 5:18 PM, Alvaro Herrera wrote: > Hello > > I think the recent changes to CSS might have broken things in the XSLT > build; apparently the SGML tooling did things differently. Compare the > screenshot of tables 67.2 and 67.3 ... 9.6 on the left, master on the > right. Is the latter form

Re: JSON function docs page broken in HEAD

2020-05-06 Thread Thom Brown
On Wed, 6 May 2020 at 18:10, Tom Lane wrote: > > Thom Brown writes: > > I noticed that the tables on JSON functions and operators page in > > devel aren't rendering correctly. > > What do you think isn't correct? We're in process of changing the > design for function/operator tables, so it's cer

Re: JSON function docs page broken in HEAD

2020-05-06 Thread Tom Lane
Thom Brown writes: > I noticed that the tables on JSON functions and operators page in > devel aren't rendering correctly. What do you think isn't correct? We're in process of changing the design for function/operator tables, so it's certainly *different* from the way it's looked in the past, bu

JSON function docs page broken in HEAD

2020-05-06 Thread Thom Brown
Hi, I noticed that the tables on JSON functions and operators page in devel aren't rendering correctly. https://www.postgresql.org/docs/devel/functions-json.html#FUNCTIONS-JSON-PROCESSING -- Thom

Re: Direct links to edit documentation

2020-05-06 Thread Magnus Hagander
On Tue, May 5, 2020 at 4:49 PM Bruce Momjian wrote: > On Mon, May 4, 2020 at 07:06:55PM +0200, Magnus Hagander wrote: > > I see how that can be pretty useful for something that's as simple as > asciidoc. > > But I wonder how useful it would be for our docbook documentation. > > > > There'd be no

Re: Documentation - chapter 52, system catalogs

2020-05-06 Thread Jürgen Purtz
On 06.05.20 00:01, Tom Lane wrote: I don't deny that we have a problem here: in the website rendering, that text tends to be pushed down out of sight by the chapter's sub-table-of-contents. But that issue exists for every chapter that's got more than a couple of sections. We shouldn't hack arou