Good Writing Style [was Re: [Israel.pm] does anyone understand why this code is not working?]

Shlomi Fish shlomif at iglu.org.il
Sat Jul 17 05:32:57 PDT 2004


On Saturday 17 July 2004 14:33, Roman M. Parparov wrote:
> On Sat, Jul 17, 2004 at 01:33:44PM +0200, liat wrote:
>
> [snip]
>
> Using punctuation and capital letters together with consistent line
> length where appropriate incredibly improves readability of the messages.
>

Agreed. Good E-mail style is:

1. Capital letters where appropriate (at the beginning of sentence, for 
acronyms, for names, etc.)

2. Proper punctuation. Make good use of periods ("."), commas (","), and other 
punctuation marks.

3. Lines should wrap around 80 characters or so. A blank line between every 
paragraph.

4. As few spelling, grammatical and syntactical errors as possible. A couple 
of errors here and there is human, but please don't make a bootload of them.

Maybe there's more, and one can probably find resources about it on the Net.

Note that while E-mail is somewhat more informal than physical mail letters, 
it should still leave a good impression and be easier to read and understand. 
If the E-mail is important to you, then you can invest some time writing it 
properly, so people who read it will have an easier time reading it. Reading 
and understanding is many times more difficult than writing, so don't make it 
harder than it is.

> Thanks in advance,
>
> 	R.
>
> P.S. See also: top-posting, excessive quoting.

Hmmm.. yes. 

Regards,

	Shlomi Fish

knut isnt godd! god's emails are flaw-les while knot once mispeld 
descrimintion as discreminaton.

-- 

---------------------------------------------------------------------
Shlomi Fish      shlomif at iglu.org.il
Homepage:        http://shlomif.il.eu.org/

Knuth is not God! It took him two days to build the Roman Empire.



More information about the Perl mailing list