Re: "NewbieDoc Docbook Guide" link broken - Mailing list pgsql-docs

From Magnus Hagander
Subject Re: "NewbieDoc Docbook Guide" link broken
Date
Msg-id CABUevExMNc07Q3vr21W7swAn6p9=0c_ZEdQw+m4BPAq4o5ZJQQ@mail.gmail.com
Whole thread Raw
In response to Re: "NewbieDoc Docbook Guide" link broken  (Daniel Gustafsson <daniel@yesql.se>)
List pgsql-docs


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.

--

pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: Fix incorrect UUID index entry in function documentation
Next
From: Daniel Gustafsson
Date:
Subject: Re: "NewbieDoc Docbook Guide" link broken