On Tue, Jun 24, 2025 at 9:20 AM Daniel Gustafsson <dan...@yesql.se> wrote:
> > 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 > +1. -- Magnus Hagander Me: https://www.hagander.net/ <http://www.hagander.net/> Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/>
