Re: Updates on Docbook information

From: Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
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 21:45:44
Message-ID: CA+FDnhLrC5PniWV9-j05n+1B4vpL78v_AnehLmpjcck4n3WBww@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sat, Oct 24, 2026 at 5:39 PM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
>
> > 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.

FYI: https://groups.oasis-open.org/discussion/docbook-technical-committee-meeting-minutes-13sep2024

> > - "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.

All the best,
Rodrigo

>
> --
> Daniel Gustafsson
>

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Joshua Carlson 2026-10-25 13:57:54 Re: Typo in Storage Parameter
Previous Message Daniel Gustafsson 2026-10-24 20:43:48 Re: Updates on Docbook information