| From: | Isaac Morland <isaac(dot)morland(at)gmail(dot)com> |
|---|---|
| To: | Bruce Momjian <bruce(at)momjian(dot)us> |
| Cc: | Craig Ringer <craig(dot)ringer(at)enterprisedb(dot)com>, Stephen Frost <sfrost(at)snowman(dot)net>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: Add docs stub for recovery.conf |
| Date: | 2020-11-13 03:44:43 |
| Message-ID: | CAMsGm5e+Gm9SA2Ep414O14NJp2LfMzTgnyGFQJwe_rXksXorYQ@mail.gmail.com |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On Thu, 12 Nov 2020 at 22:40, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
Because at a certain point the number of _old_ names in the docs
> obscures exactly how to operate the current software. We have tried
> keeping stuff around, and we are very bad at removing stuff.
>
This is a good point, but does not attempt to explain why pages should
disappear entirely from /docs/current/. As I said in my previous comment,
there are lots of ways of doing this right. For example, we could have
pages that would disappear instead be replaced by a short page that
explains the page is removed and points to the current documentation of the
equivalent or replacement features; these hypothetical "useful 404" (or,
more correctly, "useful 410") pages don't even necessarily have to be
listed in the table of contents. In fact, serving them with a 410 HTTP
status code would be a reasonable thing to do.
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Michael Paquier | 2020-11-13 03:49:33 | Re: Skip ExecCheckRTPerms in CTAS with no data |
| Previous Message | Bruce Momjian | 2020-11-13 03:41:49 | Re: Add docs stub for recovery.conf |