Broken NewbieDoc Docbook Guide link

Started by PG Bug reporting form9 months ago2 messagesdocs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.org

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/docguide-docbook.html
Description:

At

https://www.postgresql.org/docs/17/docguide-docbook.html

the NewbieDoc Docbook Guide link is to

http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html

which results in an HTTP 404.

I guess the project page is

https://sourceforge.net/projects/newbiedoc/

but it doesn't actually display the guide, so I guess one would have to
download and build it in order to read it? Also, the project was last
updated over ten years ago (2013-04-15). Maybe the reference to this guide
should just be removed?

#2Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: PG Bug reporting form (#1)
Re: Broken NewbieDoc Docbook Guide link

On 2025-Aug-13, PG Doc comments form wrote:

At

https://www.postgresql.org/docs/17/docguide-docbook.html

the NewbieDoc Docbook Guide link is to

http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html

which results in an HTTP 404.

I guess the project page is

https://sourceforge.net/projects/newbiedoc/

but it doesn't actually display the guide, so I guess one would have to
download and build it in order to read it? Also, the project was last
updated over ten years ago (2013-04-15). Maybe the reference to this guide
should just be removed?

Yeah, it was removed some time ago actually, per this discussion:
/messages/by-id/aFpXSCPpQkoFk_mb@paquier.xyz
The updated docs coincidentally become visible later today, with the
release of 17.6 and friends. It's already visible in the development
docs for pg19: https://www.postgresql.org/docs/devel/docguide-docbook.html

--
Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/
"Doing what he did amounts to sticking his fingers under the hood of the
implementation; if he gets his fingers burnt, it's his problem." (Tom Lane)