Re: Updates on Docbook information

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
Cc: "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Updates on Docbook information
Date: 2026-10-24 20:38:50
Message-ID: 8253BA0D-B6A5-48A3-B816-5642B4307258@yesql.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 23 Oct 2026, at 22:40, Matemática A3K <matematica(dot)a3k(at)gmail(dot)com> wrote:
>
> In https://www.postgresql.org/docs/18/docguide-docbook.html it says:
> "...
> DocBook is maintained by the OASIS group. The [official DocBook site]
> has good introductory and reference documentation and a complete
> O'Reilly book for your online reading pleasure. The [FreeBSD
> Documentation Project] also uses DocBook and has some good
> information, including a number of style guidelines that might be
> worth considering.
> "
> which caught my attention with:
> - "DocBook is maintained by the OASIS group.": No longer true, see
> https://docbook.org/

If the TC was truly shut down, I would think the OASIS would remove the content
or at least make some form of notice about that fact. The statements on
docbook.org might be all true, but before redirecting links from authoritative
sources I'd prefer a bit more context than an unsubstantiated claim.

> - "The [FreeBSD Documentation Project] also uses DocBook and has some
> good information, including a number of style guidelines that might be
> worth considering.": No longer true, it currently use asciidoc and
> there are no references to docbook in the current website

This part I do agree with, and I have pushed a removal of this sentence.

--
Daniel Gustafsson

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2026-10-24 20:42:26 Re: Updates on Docbook information
Previous Message Matemática A3K 2026-10-23 20:40:29 Updates on Docbook information