Re: "NewbieDoc Docbook Guide" link broken

On Tue, Jun 24, 2025 at 9:20 AM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:

> > On 24 Jun 2025, at 07:04, Michael Paquier <michael(at)paquier(dot)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/>
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/>