Horton

Thread

Commits

  1. doc: Remove dead link to NewbieDoc Docbook Guide

  1. "NewbieDoc Docbook Guide" link broken

    jian he <jian.universality@gmail.com> — 2025-06-24T04:17:46Z

    hi.

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

  2. Re: "NewbieDoc Docbook Guide" link broken

    Michael Paquier <michael@paquier.xyz> — 2025-06-24T05:04:39Z

    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

  3. Re: "NewbieDoc Docbook Guide" link broken

    Daniel Gustafsson <daniel@yesql.se> — 2025-06-24T07:19:53Z

    > 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

  4. Re: "NewbieDoc Docbook Guide" link broken

    Magnus Hagander <magnus@hagander.net> — 2025-06-24T07:36:20Z

    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/>
 Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/>

  5. Re: "NewbieDoc Docbook Guide" link broken

    Michael Paquier <michael@paquier.xyz> — 2025-06-24T07:44:08Z

    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

  6. Re: "NewbieDoc Docbook Guide" link broken

    Daniel Gustafsson <daniel@yesql.se> — 2025-06-24T10:03:26Z

    > 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