On Technical Writing: Gerunding It Up

chromatic on 2004-02-24T04:01:12

Some days, I'm tempted to propose a book on effective technical writing. Then I realize that my editors could produce examples of my bad prose. Also, the writers I work with are overwhelmingly quite nice, intelligent, and fully capable of fixing most minor issues with better feedback.

Still, it's nice to believe that the world is a better place for me having changed a heading from "Using $application To $verb $task" to "$verb-ing $task".

What's important? Is it the tool? In this case, no. It's getting something done. How is less important than what.

You have limited space in headings. Use it wisely.


This presumes....

Elian on 2004-02-24T14:03:02

...that we know the answer to one important question: What exactly a gerund is.

Re:This presumes....

hfb on 2004-02-24T15:51:13

Presuming is, in fact, a gerund. :)

not always

ask on 2004-03-03T13:02:15

That really depends on the context,

"Writing games with SDL"

vs

"Using Perl to write games with SDL" :-)

  - ask

Re:not always

chromatic on 2004-03-03T17:54:12

True, though I might write the second as "Writing Games with Perl and SDL". "Using" can be pretty weak.