Scott on Writing

Musings on technical writing...

The Process of Writing

The other day I was talking about how one prepares and researches for an article to noted author and speaker Michele Leroux Bustamante (with whom I teach a “Fundamentals of Web Services” class with).  Michele said that she spends several days on an article, utilizing articles, newsgroups, communications with contacts in Microsoft, and, of course, by crunching out code and seeing what happens.  She said her technique was to focus 100% of her time on one particular article until she had it finished.  Her comments piqued my interest, since I am on the opposite end of the spectrum.  I shared my style with Michele, but thought it might also be useful to other writers to share my approach here.....

I find my best writing occurs when there are several weeks of time between initially given the writing assignment and actually starting writing.  Too, I find sometimes writing goes best if spread out over several days.  If I am asked to write a topic about which I only have a cursory understanding on, I usually start by spending an hour or two a day for a week reading articles, trying out code examples, just playing around with the concepts and specifics to broaden my understanding.  Following that, I find it helps to continue poking around the Web for information, but, at the same time, I start formulating an article outline mentally.  I rarely find myself writing down the outline, usually it's just a bunch of 1s and 0s in my brain, but I lay out the flow of the article mentally before writing.  I'll usually do this to fill time, like if I'm waiting in line, taking a shower, before falling asleep or right after waking up, or when walking the dog.  For topics I have an intimate understanding with, such as topics on the ASP.NET DataGrid, I usually forgo the initial research (since it's been done in countless hours past) and instead spend a day or two mapping out the article in the noggin'. 

Once I have a mental vision of the article, and have had sufficient research time, I begin writing!  Writing can vary from hours to a week, depending on my knowledge of the subject matter, the length of the article, and the complexity of the material.  For example, I find myself taking close to a week to write each installment of my Extensive Examination of Data Structures article series, due in part to its length (Part 4 is over 8,000 words long with 16 figures!!) and the difficulty in describing a potentially complex topic in an easy-to-understand manner.  I rarely find myself refactoring what I write.  That is, I hardly ever go back and rearrange the presentation of the material, or strike a paragraph, or add extra content.  If I do make edits to previously written content, it's usually because at some point later in the same article I realize I need to talk about something that requires an explanation beforehand.

Also, ever since my first book I've found that very little changes from my first draft and the final draft.  For books, typically two grammatical editors and at least one technical editor will go through the manuscript, making suggestions, changes, and fixes, but usually the only fixes are slight grammatical ones.  I humbly attribute this to good writing, not lazy editors.  I've worked as a technical editor on two computer trade books before and, trust me, there can be a lot of work for an editor, especially for newer authors.

posted on Friday, January 16, 2004 12:11 PM

Feedback

# re: The Process of Writing 1/16/2004 1:42 PM Maxim V. Karpov

Scott,
Thanks for sharing your thought on writting. I always like to hear other people talking about it. I find out two things that are true about writting:
1. Hard work
2. Proccess based

Process can change from writer to writer but it requires hours and hours of research before anything can be written on paper.

I still have to improve my writting (like all of us) but it is better to start somewhere.

By the way thanks for the nice write up about my last blog entry.

Maxim

www.ipattern.com (do you)?

# re: The Process of Writing 1/16/2004 1:53 PM Bruce Johnson

It seems that we share at least part of the process. Like you, I don't particularly like to create an outline of the topic that I'm writing about. Sometimes, like if I need to make sure that I'm covering everything relevant, I might create a high-level outline, but that is usually nothing more than some scribbles on a piece of paper.

Our difference is in the editing process. I like to practice what I call 'stream of consciousness' writing. My 'voice' is to write with basically the same rhythm and style as when I speak. Which means I sit down in front of the keyboard and type whatever thoughts strike me. I found this technique especially useful if I'm trying to get started. It doesn't matter what I write first. I can always move it later. It's more important to get something down, which avoids the 'what should the first paragraph be' syndrome that stymies so many writers.

After I've made my first pass at the content, I go back with a more critical eye. Now I'm looking for how the paragraphs flow from a reading perspective and how the ordering of the concepts work towards making the topic understandable. Did I use the word that I intended? Do the attempts at humour work? For some reason, I got into the habit of going through this stage on paper. I like the tactile stimulation of bluelining whole sections, I guess :)

During this initial editing phase whole sections can be added, moved or removed. Some I even keep for use in other articles. But the end result is page after page of chicken scratch...er...corrections. Once these changes have been put into place, the article is ready to be reviewed by a real editor, where the whole process starts again.

# re: The Process of Writing 1/16/2004 2:27 PM Michele Leroux Bustamante

Hey! Scott just told me that he "blogged me" and as I read this I thought it appropriate to contribute as I am currently in the midst of wrapping up final touches on my second article this week.

I admire Scott because from what he has told me, he can really jam out those articles fast. One of the things we discussed was that it depends on the article content as well. For example, if you have been working with a particular technique for a long time, and have all that experience and sample code in your back pocket, it makes it easier to arrange your thoughts.

However, even when I think I know a subject well, I always err on the anal side and research for a few days as I play with sample code ideas, to be sure that I have a well rounded picture on the subject. Once in a while this has really paid off because I found a better way to do something, or a feature I hadn't been aware of. I assume from the start that there is something I have missed, in other words, which is nothing a few google searches can't cure. I also do this to make sure I'm not writing about something that is already well documented elsewhere, at least when it is for a paid publication.

One thing is for sure, for simple articles or lengthy essays or chapters, the wording always comes out better if I take the *finished* version and read it through one last time with my nice hot vanilla latte in the morning. It is funny how much better you can reword a paragraph during that last, focused pass. So, like Scott, I let an article age like a fine wine over several man-days, so I can have a few morning passes with a fresh outlook.

Cheers!
-Michele

Title:  
Name:  
Url:
Protected by Clearscreen.SharpHIPEnter the code you see:
Comments   

Add To Your Reader

My Links

Archives

Post Categories

 

I am a Microsoft MVP for ASP.NET.
I am an ASPInsider.
<May 2008>
SMTWTFS
27282930123
45678910
11121314151617
18192021222324
25262728293031
1234567

Comment Stats

DayTotal% of Total
Sunday 1866.8%
Monday 37913.9%
Tuesday 45316.7%
Wednesday 50418.5%
Thursday 53519.7%
Friday 49418.2%
Saturday 1666.1%
Total 2717100.0%

Hour1Total% of Total
12:00 AM 652.4%
1:00 AM 682.5%
2:00 AM 622.3%
3:00 AM 742.7%
4:00 AM 572.1%
5:00 AM 1033.8%
6:00 AM 1084.0%
7:00 AM 1585.8%
8:00 AM 1716.3%
9:00 AM 1475.4%
10:00 AM 1716.3%
11:00 AM 1816.7%
12:00 PM 1886.9%
1:00 PM 1696.2%
2:00 PM 1605.9%
3:00 PM 1324.9%
4:00 PM 1073.9%
5:00 PM 923.4%
6:00 PM 913.3%
7:00 PM 963.5%
8:00 PM 833.1%
9:00 PM 782.9%
10:00 PM 792.9%
11:00 PM 772.8%
Total 2717100.0%

Comments by Blog Entry Date/Time

Day Entry MadeAvg.Total
Sunday 5.54144
Monday 5.22339
Tuesday 4.28419
Wednesday 7.67637
Thursday 6.90607
Friday 5.48411
Saturday 5.33160
Total 5.842717

Hour1 Entry MadeAvg.Total
12:00 AM 5.0035
1:00 AM 1.002
5:00 AM 0.000
7:00 AM 7.0035
8:00 AM 5.35107
9:00 AM 6.32278
10:00 AM 6.47246
11:00 AM 4.41181
12:00 PM 6.88330
1:00 PM 3.00111
2:00 PM 5.41222
3:00 PM 8.64285
4:00 PM 4.0589
5:00 PM 5.92154
6:00 PM 4.52113
7:00 PM 9.67174
8:00 PM 9.80147
9:00 PM 5.05111
10:00 PM 5.4265
11:00 PM 4.5732
Total 5.842717

Learn More About Comment Stats
1 - All times GMT -8...


Blog Stats

Favorite Web Sites

My Books

My MSDN Articles