16 January 2013

Resiliance versus Resiliancy

I came across this sentence in my own writing:

"Resiliency is accomplished through properly configured..."

I thought it looked weird. According to the grammarist, I wasn't wrong.

"Both nouns mean the ability to recovery quickly from illness or misfortune. But resilience is far more common than resiliency, especially outside the U.S. and Canada."

Wrong or not, I decided to go with the herd and use resilience.

15 January 2013

STC Australia Chapter... whats the point?

We're now well and truly into the new year. I just renewed my membership, and was sure to pay extra and nominate Australia as my regional chapter.

Have you renewed? Are you thinking of joining? Have you ever wondered "what is the point of joining a chapter?"

 $25 is, after all, $25.

I thought it was a good exercise to start off the year with a look at the promise of chapter membership.

The STC Australia Chapter's official website has this to say about what we aim to provide:

14 January 2013

A link about writer errors, to whet whistles.

Here is a good "check-box"  post of common writer errors to look for when you are about to publish something.

The title of the post is link-bait of course. Did I get you?

12 January 2013

And... we're back.

Happy (belated) New Year everyone.

I found this post about what people hate about open source documentation, and I thought sharing it would be a good way to get back into the habit of blogging.

I've missed you.

10 December 2012

"Managing Your Documentation Projects" by JoAnn Hackos -- an overview

Everyone in the office where Tim and I work is issued a copy of JoAnn Hackos's Managing Your Documentation Projects. In this blog post, I'll provide some general remarks about this often-issued, not-so-often-read book.

JoAnn Hackos's Managing Your Documentation Projects (hereafter, MYDP) discusses technical writing from a managerial, strategic perspective, with emphasis on implementing a process for documentation development. MYDP provides a 5-level model for assessing the maturity of your documentation team.

It is important to say what MYDP is not. MYDP is not a manual for teaching you how

07 December 2012

Archived Seminar Review: Strategies for the Social Web for Documentation.

Introduction:

The STC website has about 90 archived seminars, webinars, and presentations. Access to all this material is included in your dues. They are mostly over an hour long, and cover a range of topics. As a public service to STC members, I decided to watch and review them all. One at a time.

Review Number 2: Strategies for the Social Web for Documentation.

In this presentation, Anne Gentle (author of Conversation and Community: The Social Web for Documentation) explored possible intersections between technical communication and social media, or the social web as she calls it. Anne explained how she thinks technical documentation could change and improve through more direct user interaction. She also tried to put to rest the idea that user generated content will one day put us all out of a job.

28 November 2012

Don't be mean to non-writers.

I've gotten better at writing since I started being a technical writer. And sometimes my pride in myself verges on smugness.

I came across this blog post, that helped me remember how important it is to be humble, and stay off high horses. This line in particular hit me:
"The idea that there is only one right way of doing English – and everyone else is doing it wrong – is inherently flawed. And by “flawed” I mean illogical, elitist and even oppressive"
The point is, worry about your own writing, and learning more every day. It's one thing to help people learn from a place of respect, and another thing to cut them down for not being as awesome as you are.