Re: Add docs stub for recovery.conf
От | Isaac Morland |
---|---|
Тема | Re: Add docs stub for recovery.conf |
Дата | |
Msg-id | CAMsGm5e+Gm9SA2Ep414O14NJp2LfMzTgnyGFQJwe_rXksXorYQ@mail.gmail.com обсуждение исходный текст |
Ответ на | Re: Add docs stub for recovery.conf (Bruce Momjian <bruce@momjian.us>) |
Список | pgsql-hackers |
On Thu, 12 Nov 2020 at 22:40, Bruce Momjian <bruce@momjian.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.
В списке pgsql-hackers по дате отправления: