Rudy,

I felt that I had good writing skills but decided to take a "High-Powered
Technical Writing" course from C.G. Wright & Assoc. last year. The session
provided me with good reinforcement of the specific skills we use for
technical documentation. I still read back through the course material from
time to time for additional reinforcement.

A Lucent colleague of mine (Jay Heiser) normally recommends "The Elements of
Style", by Strunk & White for picking up writing skills. I found it a
little dry, but that is primarily a reflection of the era it was written in.
The content is very good though.

I always try to leave extra time to review my documents before submitting
them. I've found it very useful to step back for a few days and then
perform my final edit. For some reason I also perform final edits better on
paper than on a computer screen.

Peer review is also a big help if you have access to others with technical
or grammatical skills. These folks should be able to provide you with
objective feedback about the strengths and weaknesses of the document. Of
course, you should return the favor when they're seeking assistance from
you.

----
Bruce K. Marshall - brucem@lucent.com - 913-338-5090 x114
Lucent Technologies Worldwide Services - Overland Park, KS
> -----Original Message-----
> From: Rudy Ruiz [mailto:rudy@thummy.com]
> Sent: Thursday, July 12, 2001 2:53 PM
> To: cisspstudy@securityfocus.com
> Subject: Documentation skills
>
>
> Forgive me if this is just a little off topic, but I can't
> help but notice
> how important documentation skills are for a CISSP. From
> white papers to
> advisories over to proposals, there is a lot to write about.
> Has anybody
> done anything ( books/school/etc ) to improve their
> documentation skills? I
> feel that mine could definitely use some improvement and this
> would have a
> tremendous impact to my success as a security professional.

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]