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 по дате отправления:

Предыдущее
От: Bruce Momjian
Дата:
Сообщение: Re: Add docs stub for recovery.conf
Следующее
От: Michael Paquier
Дата:
Сообщение: Re: Skip ExecCheckRTPerms in CTAS with no data