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/
- [official DocBook site] points to
https://www.oasis-open.org/docbook/, and "has good introductory and
reference documentation and a complete O'Reilly book for your online
reading pleasure" seems not appropriate for the page
- "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
I think those sentences should be replaced with:
"...
The [DocBook site] has good introductory and reference documentation,
a complete O'Reilly book for your online reading pleasure, and an
archive with previously released versions.
"
Also, in https://www.postgresql.org/docs/18/docguide-toolsets.html says:
"...
[DocBook DTD]
This is the definition of DocBook itself. We currently use version
4.5; you cannot use later or earlier versions. You need the XML
variant of the DocBook DTD, not the SGML variant.
"
where [DocBook DTD] points to https://www.oasis-open.org/docbook/ and
it is not found there. It should point to
https://archive.docbook.org/schemas/ where you can find the 4.5 DTD.
I attach a patch with the proposed changes for review / further refinement.
Thanks!
diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index 7b61b4841aa..f1cdb0f7584 100644
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -56,15 +56,11 @@
<productname>DocBook</productname> allows an author to specify the
structure and content of a technical document without worrying
about presentation details. A document style defines how that
- content is rendered into one of several final forms. DocBook is
- maintained by the <ulink url="https://www.oasis-open.org";>
- OASIS group</ulink>. The <ulink url="https://www.oasis-open.org/docbook/";>
- official DocBook site</ulink> has good introductory and reference documentation and
- a complete O'Reilly book for your online reading pleasure.
- The <ulink url="https://www.freebsd.org/docproj/";>
- FreeBSD Documentation Project</ulink> also uses DocBook and has some good
- information, including a number of style guidelines that might be
- worth considering.
+ content is rendered into one of several final forms.
+ The <ulink url="https://docbook.org/";> DocBook site</ulink> has
+ good introductory and reference documentation,
+ a complete O'Reilly book for your online reading pleasure,
+ and an archive with previously released versions.
</para>
</sect1>
@@ -78,7 +74,7 @@
<variablelist>
<varlistentry id="docguide-toolsets-docbook-dtd">
- <term><ulink url="https://www.oasis-open.org/docbook/";>DocBook DTD</ulink></term>
+ <term><ulink url="https://archive.docbook.org/schemas/";>DocBook DTD</ulink></term>
<listitem>
<para>
This is the definition of DocBook itself. We currently use version
