"NewbieDoc Docbook Guide" link broken

On Tue, Jun 24, 2025 at 12:17:46PM +0800, jian he wrote:

in https://www.postgresql.org/docs/current/docguide-docbook.html
the link (https://newbiedoc.sourceforge.net/metadoc/docbook-guide.html)
for (NewbieDoc Docbook Guide) is broken.

google around I found this [2]
[2]: https://ftp.sun.ac.za/ftp/pub/documentation/newbiedoc/newbiedoc-html/docbook-guide.en/index-docbook-guide.html

Not sure that it is a good idea to point to an external site while the
original site of the project is still around:
https://sourceforge.net/projects/newbiedoc/.

At the same time, perhaps there are better resources than a project
that had no updates since 2011, or we could consider removing this
reference. I have never used it, but perhaps some find it useful.
--
Michael

On 24 Jun 2025, at 07:04, Michael Paquier <michael@paquier.xyz> wrote:

On Tue, Jun 24, 2025 at 12:17:46PM +0800, jian he wrote:

in https://www.postgresql.org/docs/current/docguide-docbook.html
the link (https://newbiedoc.sourceforge.net/metadoc/docbook-guide.html)
for (NewbieDoc Docbook Guide) is broken.

google around I found this [2]
[2]: https://ftp.sun.ac.za/ftp/pub/documentation/newbiedoc/newbiedoc-html/docbook-guide.en/index-docbook-guide.html

Not sure that it is a good idea to point to an external site while the
original site of the project is still around:
https://sourceforge.net/projects/newbiedoc/.

At the same time, perhaps there are better resources than a project
that had no updates since 2011, or we could consider removing this
reference. I have never used it, but perhaps some find it useful.

Downloading what newbiedoc still ships shows no trace of docbook introdoctions,
so whatever we decided valuable back in the 8.1 days when this was added seems
gone now. I propose to apply the below and simply remove it.

--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -60,9 +60,7 @@
    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="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html">
-   NewbieDoc Docbook Guide</ulink> is very helpful for beginners.
+   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

--
Daniel Gustafsson

On Tue, Jun 24, 2025 at 9:20 AM Daniel Gustafsson <daniel@yesql.se> wrote:

On 24 Jun 2025, at 07:04, Michael Paquier <michael@paquier.xyz> wrote:

On Tue, Jun 24, 2025 at 12:17:46PM +0800, jian he wrote:

in https://www.postgresql.org/docs/current/docguide-docbook.html
the link (https://newbiedoc.sourceforge.net/metadoc/docbook-guide.html)
for (NewbieDoc Docbook Guide) is broken.

google around I found this [2]
[2]:

https://ftp.sun.ac.za/ftp/pub/documentation/newbiedoc/newbiedoc-html/docbook-guide.en/index-docbook-guide.html

Not sure that it is a good idea to point to an external site while the
original site of the project is still around:
https://sourceforge.net/projects/newbiedoc/.

At the same time, perhaps there are better resources than a project
that had no updates since 2011, or we could consider removing this
reference. I have never used it, but perhaps some find it useful.

Downloading what newbiedoc still ships shows no trace of docbook
introdoctions,
so whatever we decided valuable back in the 8.1 days when this was added
seems
gone now. I propose to apply the below and simply remove it.

--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -60,9 +60,7 @@
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="
http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html">
-   NewbieDoc Docbook Guide</ulink> is very helpful for beginners.
+   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

+1.

--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/&gt;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/&gt;

On Tue, Jun 24, 2025 at 09:36:20AM +0200, Magnus Hagander wrote:

On Tue, Jun 24, 2025 at 9:20 AM Daniel Gustafsson <daniel@yesql.se> wrote:

Downloading what newbiedoc still ships shows no trace of docbook
introdoctions,
so whatever we decided valuable back in the 8.1 days when this was added
seems
gone now. I propose to apply the below and simply remove it.

+1.

+1.
--
Michael

On 24 Jun 2025, at 09:44, Michael Paquier <michael@paquier.xyz> wrote:

On Tue, Jun 24, 2025 at 09:36:20AM +0200, Magnus Hagander wrote:

On Tue, Jun 24, 2025 at 9:20 AM Daniel Gustafsson <daniel@yesql.se> wrote:

Downloading what newbiedoc still ships shows no trace of docbook
introdoctions,
so whatever we decided valuable back in the 8.1 days when this was added
seems
gone now. I propose to apply the below and simply remove it.

+1.

+1.

Done, backpatched down to 13.

--
Daniel Gustafsson