> On 24 Jun 2025, at 07:04, Michael Paquier <mich...@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
