News for hackers. Stuff that matters.
Re:One of the Best Bits of Programming Advice I ever Got by ctdonath on Monday September 26, 2011 @08:55AM (#3038619)
Amazing how small linguistic changes can cause large semantic shifts.

Comparable to the post's rule: in English, a few rules I've picked up are

- avoid words ending in "ly" (suffix weakens concepts; suggestion from Stephen King)

- never start a sentence with "I" and otherwise minimize its use

- "but" negates everything that came before

- avoid "to be"

Any other such suggestions, in natural or artificial languages?

Re:One of the Best Bits of Programming Advice I ever Got by kabdib on Monday September 26, 2011 @10:10AM (#3038971)
Good code isn't written, it's re-written.

Omit needless code. Omit needless code. Omit needless code.

Re:One of the Best Bits of Programming Advice I ever Got by jamiemill on Monday September 26, 2011 @12:22PM (#3039583)
George Orwell's five rules of effective writing come to mind: http://www.pickthebrain.com/blog/george-orwells-5-rules-for-...

And people so often substitute longer words, (e.g. 'myself' instead of 'me') when they want to sound professional.

"I hit myself" => OK "Please contact myself" => WRONG.

Re:One of the Best Bits of Programming Advice I ever Got by vacri on Monday September 26, 2011 @06:32PM (#3041006)
"I can' let you do that, Dave"

There are plenty of times to use "I" at the start of a sentence. Told by my boss "we're out of power converters", it's natural and correct to simply say/write "I will get some at Toshi station on the way in". Trying to find a sentence to say the same thing without starting with "I" is unnecessarily torturous.

Re:One of the Best Bits of Programming Advice I ever Got by pestaa on Monday September 26, 2011 @11:07AM (#3039274)
Is there a collection of suggestions from Stephen King? I love picking up small pieces of advice from respectable writers, and he is undoubtedly one of them.
Re:One of the Best Bits of Programming Advice I ever Got by cpeterso on Monday September 26, 2011 @12:47PM (#3039688)
Stephen King's On Writing: A Memoir of the Craft.
Re:One of the Best Bits of Programming Advice I ever Got by ctdonath on Monday September 26, 2011 @01:43PM (#3039937)
Most of the book is his less-than-riveting autobiography.

The ~16 pages which are in fact about writing ("Toolbox") are worth more than the cover price.

Re:One of the Best Bits of Programming Advice I ever Got by MartinCron on Monday September 26, 2011 @02:04PM (#3040024)
Someone else mentioned Stephen King's (enjoyable) book. If you're after more "small bits of advice from respectable writers" you should look into Lawrence Block's books, specifically "Telling Lies for Fun and Profit" which I keep coming back to whenever I'm stuck.
Re:One of the Best Bits of Programming Advice I ever Got by Nick_C on Tuesday September 27, 2011 @03:26AM (#3042252)
> Lawrence Block

My favourite crime author, by a long way. Who else can write about a killer and make him a sympathetic character.

Re:One of the Best Bits of Programming Advice I ever Got by MartinCron on Tuesday September 27, 2011 @02:10PM (#3044497)
Who else can write about a killer and make him a sympathetic character.

That's easy, Donald Westlake writing as Richard Stark. Though Block is probably my favorite crime author as well.

Re:One of the Best Bits of Programming Advice I ever Got by ams6110 on Monday September 26, 2011 @09:23AM (#3038762)
Avoid the passive voice.
Re:One of the Best Bits of Programming Advice I ever Got by ppog on Monday September 26, 2011 @04:36PM (#3040632)
Geoffrey K Pullum has a delightful article tearing Strunk and White's prescription and examples to pieces. While there's some truth to the advice, it is often simplistically presented and ludicrously overapplied (uh, I mean, "style guides often present it simplistically, and editors often overapply it"). There's plenty of room for the passive voice, and even more so when you consider what Strunk and White consider to be passive even though it isn't.

http://chronicle.com/article/50-Years-of-Stupid-Grammar/2549...

Re:One of the Best Bits of Programming Advice I ever Got by throwaway32 on Monday September 26, 2011 @05:47PM (#3040885)
whats humorous is that Strunk and White use the passive voice in their recommendation to not use it!
Re:One of the Best Bits of Programming Advice I ever Got by r00fus on Monday September 26, 2011 @02:07PM (#3040046)
There are reasons to use variants of the passive voice. Using Wikipedia's NPOV [1] approach with speaking with people is very useful in attempting to agree on fact first so emotion is avoided for charged situations/discussions.

[1] https://secure.wikimedia.org/wikipedia/en/wiki/Wikipedia:Neu...

Re:One of the Best Bits of Programming Advice I ever Got by vacri on Monday September 26, 2011 @06:22PM (#3040976)
Scientific reporting also benefits greatly from use of the passive voice.
Re:One of the Best Bits of Programming Advice I ever Got by uriel on Monday September 26, 2011 @09:49AM (#3038875)
- read Strunk & White.