pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed

Broken NewbieDoc Docbook Guide link
2+ messages / 2 participants
[nested] [flat]

* Broken NewbieDoc Docbook Guide link
@ 2025-08-13 21:57  PG Doc comments form <noreply@postgresql.org>
  0 siblings, 1 reply; 2+ messages in thread

From: PG Doc comments form @ 2025-08-13 21:57 UTC (permalink / raw)
  To: pgsql-docs@lists.postgresql.org; +Cc: jlmuir@imca-cat.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?


^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: Broken NewbieDoc Docbook Guide link
@ 2025-08-14 12:24  Álvaro Herrera <alvherre@kurilemu.de>
  parent: PG Doc comments form <noreply@postgresql.org>
  0 siblings, 0 replies; 2+ messages in thread

From: Álvaro Herrera @ 2025-08-14 12:24 UTC (permalink / raw)
  To: jlmuir@imca-cat.org; pgsql-docs@lists.postgresql.org

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)





^ permalink  raw  reply  [nested|flat] 2+ messages in thread

end of thread, other threads:[~2025-08-14 12:24 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2025-08-13 21:57 Broken NewbieDoc Docbook Guide link PG Doc comments form <noreply@postgresql.org>
2025-08-14 12:24 ` Álvaro Herrera <alvherre@kurilemu.de>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox