From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Josh Berkus <josh(at)agliodbs(dot)com> |
Cc: | Robert Haas <robertmhaas(at)gmail(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: 9.0 release notes done |
Date: | 2010-03-22 14:46:46 |
Message-ID: | 201003221446.o2MEkkE19275@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
Josh Berkus wrote:
>
> >> In hindsight I could have loaded the ASCII release notes into a wiki and
> >> people could have modified, them, and later I could have converted them
> >> to SGML,
>
> That was, in fact, *exactly* what you said you'd do 3 months ago when we
> discussed this.
I now remember discussing it but I don't remember many of the details.
> > Yeah, I don't think that would have been better.
>
> Thing is, doing things like rearranging items for clarity is
> prohibitively painful in SGML. And while I know a professional
> copy-editor who would be willing to fix grammar, etc, she's not going
> anywhere near SGML.
>
> I think we're back at having two sets of feature information: one for
> the general public, one for the technically inclined.
>
> Or, to put it another way: I do the feature list for the general public.
> I'm not doing it in SGML. It's too freaking hard to edit. If someone
> else wants to take up doing that work, they can do it in any format they
> want.
I can accept diffs in any format and merge them into the SGML. That's
the way the proofreaders are working:
http://wiki.postgresql.org/wiki/Documentation_Proofreading
I do not require them to submit SGML; just some format where I can
identify the lines that changed. I can do the same for the release
notes. I have to check the diffs anyway so manually merging in the
changes isn't a problem.
It is certainly easy to put the information on a wiki for a week and
allow it to be proofread before adding the SGML markup. However, there
will still be adjustments after that and I am still going to be merging
stuff into SGML, just not as much.
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
PG East: http://www.enterprisedb.com/community/nav-pg-east-2010.do
From | Date | Subject | |
---|---|---|---|
Next Message | Simon Riggs | 2010-03-22 15:01:44 | Re: Comments on Exclusion Constraints and related datatypes |
Previous Message | Peter Eisentraut | 2010-03-22 14:40:04 | Re: Comments on Exclusion Constraints and related datatypes |