15Seconds WebLog

Tech Writing - What Is It Good For?

For those of you who do not know me, I'm the managing editor of 15Seconds and Webopedia. I've been following and reading weblogs.asp.net for some time now, and I've noticed that the subject of technical writing does come up on occasion. In fact, blogging itself has become a form of technical writing.

I've set up this blog to share my thoughts and ideas on issues that surround the art, craft, and business of technical writing. I'd also be happy to respond to any questions or concerns you may have on technical writing.

I guess the first issue I'd like to address is book writing and article writing. I promise I'll try to keep it short and unbiased.

For those of you looking to write, I think it is important to know what you want to get out of the experience. Besides the desire to share your knowledge for the betterment of the development community, are you looking mainly to make some extra dough quick or are you primarily looking for prestige? Article and book writing do offer both, just in different proportions.

Those looking mainly for prestige, book writing is probably the best bet. There is greater distinction and prestige associated with having your name (and picture) printed on the front of a few-hundred page book. Writing a book is much more tedious and time consuming than writing articles, so the sense of accomplishment may be greater as well. Articles do also offer some prestige and distiction (and credibility), but the bare fact is this is book writing's forte.

Those looking mainly to make some extra money should try their hand at article writing. Publications, whether online or print, may pay, depending on writer experience, anywhere between $100.00 and $1000.00+ per article that usually contains 1,000 - 20,000 words. This is a flat fee, independent of page views or unique visits. Book authors may be granted royalties between 8% and 15% per copy sold. A colleague of mine recommends negotiating for the largest advance possible, especially if you are not a well establish author, and don't worry too much about the royalties.

With that said, there is definitely a synergy between the two. Writing articles is a great way to promote a book. While a book may eventually sell 20,000 copies, an online article may receive 20,000 visitors in less than a month. Plus, you'll get paid for the article as well! Depending on the terms of your contract, what you write in articles may be used in your books and vice versa.

In either case, you'll probably be asked to sign a contract to establish fees, rights, conditions, etc. It is of the utmost importance that you understand what is being granted to you and what you are granting.

This is just my take on the subject based on my experiences as an editor here at Jupitermedia. I know I haven't covered everything, but I hope I've given you a few things to consider.

Good luck!

-Steve Kapsinow

 

Comments

The Penton-izer said:

Glad to see you out here, Steve!
# March 25, 2004 12:10 PM

Adam Kinney said:

Awesome. I think technical writing as a blog focus is a great idea.
# March 25, 2004 12:36 PM

css said:

Tech writing is an important skill to have for developers. I graduated with a CIS degree (not straight CS) and a tech writing minor. Currently I'm working on a CS master's degree. I've been applying for internships and getting many interviews. My interview experience over the last two months have shown that my tech writing minor has gotten me many interview opportunities that I would have not have had even though I have a very strong programming background. I also believe that I write more and better code comments and project documentation due to my technical writing background. Those qualities are important for all developers.
# March 25, 2004 12:55 PM

Adnan Masood said:

Steve on Tech Writing! Glad to see you here.

I agree with CSS that tech writings brings maturity in development design. Being published surely offers a degree of prestige which developers often enjoy in interviews and peer-communication.
# March 25, 2004 1:25 PM

FifteenSeconds said:

In fact, some companies make it mandatory for their developers to write articles for tech publications. Good way to establish developer credibility while promoting their business.

Sometimes companies will even use their employees' articles in business presentations and portfolios.
# March 25, 2004 2:21 PM

Rob Chartier said:


Welcome to the blog world!
# March 25, 2004 3:20 PM

TrackBack said:

Tech Writing - What Is It Good For? Steve over at 15Seconds joins the Secret Tech Writer's Blogging Ball going...
# March 25, 2004 6:10 PM

suman kumar said:

Welcome to the party man.
# March 31, 2004 7:57 AM

Daniel Baker said:

I am a once-technician, 20 year writer, now trying to bend to programmer-writer. (I've written a lot of ASP/VBScript/SQL/Javascript; know some C and studying C#.) Programmer-writer is very powerful: know and read code, write about it clearly, distill it. It's not for everyone, but for those who enjoy it, I beleive it leads to clearer thinking. Possibly that is needed...

But I want to say that as a once user then long term TW, I think virtually 100% of the user/reader's point of view and understanding, something that a programmer is less likely to do. Can't see the trees for the forest. We TW's have heard millions of time, "oh, sure, all the engineers understand this", only to have an engineer trot out from around the corner saying what's this. We look for consistency in terminology within and between docs and the GUI that they are about. We notice GUIs that could be a bit clearer and processes (between screens) that could flow more clearly or efficiently. We seek to make information very quickly accessible to the reader; minimum throat-clearing stuff. Make the user education stuff work for both learning and problem solving, nothing in between. Look for efficient ways to assemble or disseminate info (that's why I do lots of ASP; learning XML).

How many things can I focus on at one time? How many things can you focus on at one time? Is that a good question?

Visit my website, visit me, lets talk. Harpoons are not welcome.
# April 2, 2004 3:31 PM

Another One Joins the Fray | The Creative Tech Writer said:

Pingback from  Another One Joins the Fray | The Creative Tech Writer

# December 2, 2011 2:55 PM
Leave a Comment

(required) 

(required) 

(optional)

(required)