Scott on Writing

Musings on technical writing...

The Question Every Author Should Ask Themselves

Have you ever noticed how most technical authors can be divided into one of two camps: either they write books geared for beginner/intermediate developers, or they write for the upper-tier of developers.  Take, for example, someone like Don Box.  Don has written a plethora of books on COM and the underpinnings of .NET, books clearly aimed at advanced developers.  I have a hard time imaging Don would write a book titled, Write Your First Visual Basic .NET WinForms Application!, and for good reason.  On the opposite end of the spectrum, consider Wallace Wang's impressive list of For Dummies books.  Here is a prolific author who has written dozens of books for beginners.

It seems to me that when choosing a career in technical writing I think it is important for the author to ask himself an important question early on: “Do I want to be an expert for an advanced topic, or do I want to write 'howto' books for beginners?”  Choosing a particular direction can lead to better noteriaty among the group you are writing for.  When you say, “I'm reading a book by Don Box,” people know that you are an expert in your field.  So, what would you rather do?  Write for experts or write for beginners?  There are advantages and disadvantages to both.

If you are writing to become known as an expert in a particular field, then clearly it would be more beneficial to write for an advanced audience.  Authors who use books as a means to publicize their skills for consulting jobs or resume fodder would do best, in my opinion, to pick a specific topic they enjoy, become an expert, and write highly targetted books on said subject.  The downside to writing for advanced developers is that, sadly, there aren't very many of them.  This, of course, means fewer sales.  Writers that rely on techincal writing as their main source of income would, I imagine, do better by writing for a larger beginner-level audience.

There's also the enjoyment factor of it all.  Do you like explaining technologies to people who are just starting out learning about said technologies?  Or do you view that process as tedious hand-holding?  Is it important that your peers view you as an expert on an particular topic, or could you care less if you're known as “that guy who explains things to newbies?”  Personally, I prefer teaching beginners.  There's nothing as rewarding as seeing someone new to a technology, and being able to help them explore the new territory.  Seeing the lightbulb come on when someone picking up the technology “gets it,” is sometimes payment enough.  (Sadly the bank doesn't view this good karma as legal tender.)

Regardless of what path you choose, I think it best to pick a path early on in your writing career.  Not being one to follow my own advice, I have written books ranging from the beginner-level (Teach Yourself YYY in XXX) to books geared toward an intermediate to advanced crowd (Designing Active Server Pages, ASP.NET: Tips Tutorials, and Code, and ASP.NET Data Web Controls).  I am about to embark on my sixth book, and this book will be heavily geared toward the beginner crowd, even moreso than the Teach Yourself YYY in XXX books, hence my ruminations on this topic...........

posted on Friday, October 24, 2003 12:54 PM

Feedback

# re: The Question Every Author Should Ask Themselves 10/24/2003 4:07 PM G. Andrew Duthie

Good rumination...I'm also familiar with both ends of the spectrum. My first book was directed at intermediate/advanced audiences, while my later books have (mostly) been targeted more towards beginners. I agree completely that if you're looking to make money, targeting beginners is the way to go (though it is possible to make some money on an advanced book, if it's good, and if it is marketed properly).

Of course, if you REALLY want to make money as a technical author, skip development books entirely. Remember that there are many more computer users than developers. People who write books like "Teach yourself Windows XP in 24 Hours" make much better money than those of us who write developer books. Trouble is, I'm not sure I could bring myself to write one of those books. I'd have a hard time sustaining my interest level long enough. :-)

# re: The Question Every Author Should Ask Themselves 10/24/2003 4:16 PM Scott Mitchell

You bring up a good point, Andrew. My upcoming book will be targetted more toward the general Web surfing population than developers, per se, so hopefully your comments on increased profitability are spot on! :-)

# How are you going to tackle the PDC? 10/24/2003 7:41 PM jim blizzard's blog

# How are you going to tackle the PDC? 10/24/2003 7:45 PM bliz

So at the PDC, attend "Everything <insert codename here>" or attend "Everything under the sun"?

# re: The Question Every Author Should Ask Themselves 10/29/2003 11:18 AM Martin WP Reid

Totally agree having worked on two books as co author. I now almost entirely work on Tech Editing other peoples writing - more money in in and you get apid real fast.

# re: The Question Every Author Should Ask Themselves 10/29/2003 9:48 PM mike

Interestingly, we have this division even within the (.NET) documentation community at MS. There are those who prefer writing the gearhead stuff and others who prefer writing for the Mort persona; each camp secretly believes that the other is crazy to spend so much energy for that other audience, haha. No, seriously, recognizing (as indeed we do) that there are different audiences with different needs (and best served by different authors) has been useful for us, and we can work in a complementary fashion to try to cover the needs of as many readers as possible in a single (albeit gigantic) doc set. It is rare that a single author can cover both audiences, but such people exist. Me, I like the novice-to-intermediate audience. For computer writing, anyway. ;-) BTW, one thing we keep running into when we talk to users in the field is that very few of them read books cover-to-cover.

# re: The Question Every Author Should Ask Themselves 10/30/2003 8:17 AM Salman

You could also say that there are certian publishers that focus on beginner level and advanced level books. It must be difficult for a new author to start off with a 'advanced' level work, correct?

# re: The Question Every Author Should Ask Themselves 10/30/2003 8:18 PM Scott Mitchell

Salman, I think an author could start out with an "advanced"-level book if they have the appropriate background. For example, take someone like Anders Hejlsberg, the inventor of languages like Delphi and C#. I think the only book he's written is to to-be-release "The C# Programming Language" (http://www.amazon.com/exec/obidos/ASIN/0321154916/), which looks like it's geared toward the intermediate audience, BUT I have a feeling someone with his background could very easily say to a publisher, "I'm only writing an uber-advanced book," even if it were his first book.

# re: Numbers are not summing up 3/21/2004 12:19 PM Justin Lovell's Blog

# My Latest Computer Book - One for the Non-Technical Crowd 11/22/2004 11:15 AM Scott on Writing

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

My Links

Ads Via DevMavens

Archives

Post Categories

 

I am a Microsoft MVP for ASP.NET.
I am an ASPInsider.
<February 2010>
SMTWTFS
31123456
78910111213
14151617181920
21222324252627
28123456
78910111213

Comment Stats

DayTotal% of Total
Sunday 2046.8%
Monday 42514.1%
Tuesday 51617.1%
Wednesday 55318.4%
Thursday 58019.2%
Friday 54718.2%
Saturday 1886.2%
Total 3013100.0%

Hour1Total% of Total
12:00 AM 772.6%
1:00 AM 812.7%
2:00 AM 682.3%
3:00 AM 822.7%
4:00 AM 692.3%
5:00 AM 1264.2%
6:00 AM 1183.9%
7:00 AM 1806.0%
8:00 AM 1926.4%
9:00 AM 1585.2%
10:00 AM 1876.2%
11:00 AM 1936.4%
12:00 PM 2016.7%
1:00 PM 1846.1%
2:00 PM 1695.6%
3:00 PM 1354.5%
4:00 PM 1153.8%
5:00 PM 1063.5%
6:00 PM 1013.4%
7:00 PM 1073.6%
8:00 PM 923.1%
9:00 PM 882.9%
10:00 PM 893.0%
11:00 PM 953.2%
Total 3013100.0%

Comments by Blog Entry Date/Time

Day Entry MadeAvg.Total
Sunday 4.94158
Monday 4.80384
Tuesday 4.08477
Wednesday 7.47680
Thursday 6.25675
Friday 5.02462
Saturday 4.78177
Total 5.413013

Hour1 Entry MadeAvg.Total
12:00 AM 5.2937
1:00 AM 1.002
5:00 AM 0.000
7:00 AM 3.8550
8:00 AM 3.72134
9:00 AM 6.02295
10:00 AM 5.63276
11:00 AM 4.20193
12:00 PM 6.14350
1:00 PM 3.17133
2:00 PM 5.00230
3:00 PM 7.62320
4:00 PM 4.00108
5:00 PM 6.04169
6:00 PM 4.64116
7:00 PM 8.95188
8:00 PM 8.63164
9:00 PM 5.00115
10:00 PM 6.31101
11:00 PM 4.5732
Total 5.413013

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


Blog Stats

Favorite Web Sites

My Books

My MSDN Articles