Обсуждение: Broken NewbieDoc Docbook Guide link

Поиск
Список
Период
Сортировка

Broken NewbieDoc Docbook Guide link

От
PG Doc comments form
Дата:
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?

Re: Broken NewbieDoc Docbook Guide link

От
Álvaro Herrera
Дата:
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:
https://www.postgresql.org/message-id/flat/aFpXSCPpQkoFk_mb%40paquier.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)