🚀 go-pugleaf

Robert Chao wrote:

> Some people have suggested that I take a tech writing course.
My question is,
> what does one learn in a tech writing course besides:
> 1) how to write well in general, which I already know;

You would learn how to write good technical documentation, which
is very different from writing well in general. To be more
specific, the course might teach:

* structure and layout
* use of headings
* style
* graphic presentation techniques
* markup strategies
* project management

just to name a few topics. There are many, many others, and a
single course would not cover them all.


> 2) how to use an advanced word processor like FrameMaker ?

Depending on what kind of course you take, they might teach you
about other document production systems, SGML, information
retrieval systems, archiving systems, etc.

> Also, what is the starting salary for a tech writer for a
mid-size company?
> I have heard it is about $35,000/year. I work as a word
processor and make
> about $31,000/year. This is because I work for a huge
accounting company. I
> have two college degrees and word processing is boring.

Gee, I have MS Word, WordPerfect, and a bunch of other word
processors, but none of them has even a single college degree.
:-)

Your guess about pay rates is better than mine. I live on another
continent, so what I make wouldn't be applicable. Besides, pay
rates vary widely (at least where I live). If you are any good at
DTD design, writing retrieval engines for SGML databases, and
stuff like that, you could get a lot more than the average
technical writer.

> If you took a good tech writing course, what books would be
used?

I do not know, but I do know a few books I would read if I wanted
to learn the ropes on my own:

Effective Writing, by C. Turk and J. Kirkman, ISBN 0-419-14660-1
This one requires some stamina to get through, but contains a lot
of good advice.

How to Write Usable User Documentation, E. H. Weiss, ISBN
0-89774-639-2
This one is good, despite the mistake in the Fog index formula on
page 151. It may get you into trouble though, because most
technical writers haven't heard of the ideas presented in the
book. Try to use them, and you might be considered a bit outr�.

The Elements of Style, W. Strunk and E.B. White, ISBN
0-205-19158-4
You probably know about this one already. If you don't have it,
get it, read it, sleep with it under your pillow. When you wake,
read it again. (It is only 85 pages.)

Those three are a start.


I hope this tells you what you want to know.

/Henrik