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