Technical Difficulties from on Top of the Mountain
2004-12-20
  Hints for revising
Brian Marick (my so-called advisor on the Masters of Fine Arts in Software pilot project) has a Great List of Hints for Revising documents.

I've had to do a lot of writing over the last two to three years (and I'm not just talking about the 60,000 words I've written on this blog), and his rules resonate with some of the things I've had to do to turn business documents from mindless zombie lists to engaging narratives that the reader might survive reading. Business plans of course are the worst. Trying to create an executive summary that will hold an investor's interest for more than 30 seconds is a black art, but one of the key's is critical review and constant editing.

One idea he mentioned I found especially useful, because as you edit the text, you tend to forget about the bigger picture:

Print the piece with a wide margin on one side. Next to each paragraph, scribble a few words about the paragraph's topic. Now read the scribbles. Do they form a progression of thought, a developing story of explanation? Or are they more like a bunch of thoughts hitched together in any old order? If so, shuffle them into a better order. (Some people cut the paragraphs out and move them around; I usually draw arrows from where the paragraph is to where it should go. I suspect the other people do better.)
One of the things that made one particularly long and dreadful project turn out pretty well was that I was writing it with a business associate. It wasn't so much that we complemented each other, but that each of us tended to zero in on the weakness of the other's writing and pound it into submission until neither of us could find fault with it. While I could have given up on many sections long before they were done, having my already weak writing re-organized and (in my opinion), redone worse, motivated me to try and redo the section in such a brilliant way that there could be no further complaint about it. The results were pretty good, but it got pretty arduous working on that document as long as we did.

But that's how you produce quality work. If you read about writing, you find that nobody writes a masterpiece the first time around. Even the classics were unbearable in their early drafts. Good writing is a process of revising, clearing out the unnecessary, and focusing on the key ideas. Its said the difference between a best seller and a timeless classic is nine revisions vs twelve. Its just a matter of patience and putting the amount of time in in proportion to your goals.

Of course, these thoughts are brought to you fresh from the keyboard and without any editing altogether. Reminds me of the old sign at Me-n-Eds Pizza:

Quality food takes time to prepare.
Your's will be ready in minutes
 
Comments: Post a Comment

<< Home
Life in the middle of nowhere, remote programming to try and support it, startups, children, and some tinkering when I get a chance.

ARCHIVES
January 2004 / February 2004 / March 2004 / April 2004 / May 2004 / June 2004 / July 2004 / August 2004 / September 2004 / October 2004 / November 2004 / December 2004 / January 2005 / February 2005 / March 2005 / April 2005 / May 2005 / June 2005 / July 2005 / August 2005 / September 2005 / October 2005 / November 2005 / December 2005 / January 2006 / February 2006 / March 2006 / April 2006 / May 2006 / June 2006 / July 2006 / August 2006 / September 2006 / October 2006 / November 2006 / December 2006 / January 2007 / February 2007 / March 2007 / April 2007 / June 2007 / July 2007 / August 2007 / September 2007 / October 2007 / November 2007 / December 2007 / January 2008 / May 2008 / June 2008 / August 2008 / February 2009 / August 2009 / February 2010 / February 2011 / March 2011 / October 2011 / March 2012 / July 2013 / August 2013 / September 2013 / October 2013 / November 2013 / December 2013 / December 2014 / February 2015 / March 2015 / July 2016 / September 2016 / December 2016 / April 2017 / June 2017 / July 2018 / November 2018 / January 2019 / February 2019 / April 2019 / December 2019 / March 2020 / April 2020 / May 2020 / September 2020 / November 2020 / March 2021 / May 2023 / June 2024 /


Blogroll
Paul Graham's Essays
You may not want to write in Lisp, but his advise on software, life and business is always worth listening to.
How to save the world
Dave Pollard working on changing the world .. one partially baked idea at a time.
SnowDeal
Eric Snowdeal IV - born 15 weeks too soon, now living a normal baby life.
Land and Hold Short
The life of a pilot.

The best of?
Jan '04
The second best villain of all times.

Feb '04
Oops I dropped by satellite.
New Jets create excitement in the air.
The audience is not listening.

Mar '04
Neat chemicals you don't want to mess with.
The Lack of Practise Effect

Apr '04
Scramjets take to the air
Doing dangerous things in the fire.
The Real Way to get a job

May '04
Checking out cool tools (with the kids)
A master geek (Ink Tank flashback)
How to play with your kids

Powered by Blogger