| From: | Peter Eisentraut <peter_e(at)gmx(dot)net> |
|---|---|
| To: | Bill Moran <wmoran(at)potentialtech(dot)com> |
| Cc: | Richard Broersma <richard(dot)broersma(at)gmail(dot)com>, David Fetter <david(at)fetter(dot)org>, pgsql-general(at)postgresql(dot)org |
| Subject: | Re: Editor for sgml files |
| Date: | 2009-11-11 20:23:07 |
| Message-ID: | 1257970987.22025.23.camel@vanquo.pezone.net |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-general |
On ons, 2009-11-11 at 08:32 -0500, Bill Moran wrote:
> In response to Peter Eisentraut <peter_e(at)gmx(dot)net>:
>
> > * The Elements of Style
>
> Hope this doesn't start a flame war, but:
> http://chronicle.com/article/50-Years-of-Stupid-Grammar/25497
Yeah, you need to be prepared to reject about 30% of the advice and
guidelines in each of the sources I mentioned.
However, some of the prescriptionism in these various style guides that
a writer or journalist might ordinarily complain about is actually a
good idea for open-source documentation writing, because it enforces
consistency. For similar reasons we have commenting and indentation and
portability conventions, even though purists might complain about "35
years of stupid C code". ;-)
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Martijn van Oosterhout | 2009-11-11 20:53:54 | Re: upgrade to 8.4 with new character set |
| Previous Message | Scott Mead | 2009-11-11 19:58:50 | Re: Incremental Backups in postgres |