[ChrisMarshallNY]

I’ve been writing my entire life.

I’ve found writing in the vernacular is usually the most effective approach (speaking only for myself -YMMV).

In my opinion, I think that there are a number of “base class” rules for tech writing, but each subject domain really requires a distinct approach, as well as a clear understanding of the audience (and subject matter -but in my experience, being a good writer/teacher is more important than being a subject matter expert. The worst teachers I ever had were subject matter masters).

But this is a cool resource.

The one critical thing I find for my writing, is that the information I give be 100% correct, and the accompanying materials be absolutely polished and tested out the wazoo.

If I’m speculating or unsure, I’m careful to note that.

Mild humor helps, but I need to be extremely careful, and it’s usually self-deprecating.