Re: Release note bloat is getting out of hand

Поиск
Список
Период
Сортировка
От Magnus Hagander
Тема Re: Release note bloat is getting out of hand
Дата
Msg-id CABUevEyG8=1izPMt=PuJwsrGKx1yX-e_x6K+pss8gD-ODJJ7pQ@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Release note bloat is getting out of hand  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: Release note bloat is getting out of hand  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-hackers
On Mon, Feb 2, 2015 at 3:44 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
Robert Haas <robertmhaas@gmail.com> writes:
> On Sun, Feb 1, 2015 at 11:10 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> I propose that we go over to a policy of keeping in HEAD only release
>> notes for actively maintained branches, and that each back branch should
>> retain notes only for branches that were actively maintained when it split
>> off from HEAD.  This would keep about five years worth of history in
>> Appendix E, which should be a roughly stable amount of text.

> -1.  I find it very useful to be able to go back through all the
> release notes using grep, and have done so on multiple occasions.  It
> sounds like this policy would make that harder, and I don't see what
> we get out of of it.  It doesn't bother me that the SGML documentation
> of the release notes is big; disk space is cheap.

Disk space isn't the only consideration here; if it were I'd not be
concerned about this.  Processing time is an issue, and so is distribution
size, and so is the length of the manual if someone decides to print it
on dead trees.  I also live in fear of the day that we hit some hard-to-
change internal limit in TeX.

Yeah, the PDF size is definitely someting to consider in this context. And the limits.

But if we can find some good way to "archive" or preserve them *outside the main docs* that should solve this problem, no? We could keep them in SGML even, but make sure they are not actually included in the build? Would still be useful for developers there...

Or if we could find a way to do like Josh says - archive them separately and publish a separate download. We could even keep it in a separate git repo if we have to, with a "migrate" job to run on a major release?

--

В списке pgsql-hackers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: Release note bloat is getting out of hand
Следующее
От: Andres Freund
Дата:
Сообщение: POC: Cache data in GetSnapshotData()