head of technical publications:
Chrysler announced that digital owners’ manuals will replace their paper predecessors starting in 2010. The automaker is the first to switch from dead trees to DVDs, and estimates the move will save 930 tons of paper annually.
read on: http://www.wired.com/autopia/2009/09/chrysler-eliminates-the-paper-owners-manual/
Tuesday, September 22, 2009
bravo to Chrysler's
Thursday, July 23, 2009
GUI based application help
I started responding to this article about not include screen shots in GUI documentation. Then I went off topic so I'll just post my thoughts.
The problem of managing screen shots in GUI application documentation has dogged me starting 15 years ago - fresh out of college and a new tech writer.
Creating and maintaining documentation that includes screen shots is a nightmare. I'm surprised that GUI API suites haven't created a tool to make images and image regions structured. Pairing that with an authoring application that understood such structure and could apply style rules to the interaction of the master document's layout could help.
Actually, when you think about it, it's crazy that we document on-screen procedures in a separate paper-document or window. I'm sure those of you who write docs for GUI based applications on a daily basis think about this all the time.
An alternative is for help to be delivered as an overlay/layer over the GUI. that would be sweet.
Anyway what I'm saying is we don't have the tools for the most helpful Help/documentation. It's a minus for the user and tech writer. And that's sad considering that GUI based applications have been in widespread use for 20 or so years.
Maybe someone can point me to a well-woven/efficient application+help example. I'm just not aware of any.
Monday, May 11, 2009
documentation nightmares: car seats
- Building Ikea furniture? Easy and fast - rarely do I need the directions.
- Fix my car? Sure, I'm at home under the hood and under the chassis.
- Soldering circuits? Been doing that since 6th grade.
- Fear of disassembling anything? Nope not really.
- Booster seat operation
- Harness seat operation
- LATCH
- Seatbelt with shoulder strap
- Seatbelt without shoulder strap
Monday, December 15, 2008
tech writer job security
I think these days every worker is looking over his or her shoulders for the proverbial pink slip**. While companies are probably going into hibernation mode, let's remember how important documentation is.
Tuesday, December 09, 2008
detailed concepts
The following thoughts were initiated by reading this great post by Alan J. Porter on how traditional structured content is losing primacy.
Monday, December 08, 2008
my failure as a blogger
I've been around the block on the Internet. I got my first Internet email account the 2nd or 3rd week of college in '91. To me, the WWW is just one part of the Internet. But obviously things change and mature and I haven't kept up. Which is to say I used to be thoroughly engaged in the culture and society of the Internet, but as we're in post-Web2.0 times, I have lonely facebook, myspace and livejournal pages. My 4 or 5 blogger accounts are mostly stagnant, and my personal website is used as a photo album to share with my family who lives out of state.
Tuesday, November 04, 2008
why the attention?
So why am I ranting about subject-oriented technical writing? Well for reasons of fate, it's the primary type of writing I've done in my professional life. I'm proud of my work, and I'm proud of what good S-O TWing can accomplish. Yet, I feel like it gets shafted in technical writing communities. (hey, my baby is beautiful too!)
subject oriented technical writing
It's been bugging to write down some of my thoughts on a fundamental technical writing dichotomy. Before we can even talk about audience, realize that your documents fall into the following camps (or a combination thereof):
- user-oriented
- subject-oriented
Subject oriented technical writing is only responsive to the topic it documents. It must faithfully and completely explain itself and create new context and explanation where needed. It is legalese in form and does not owe anything to its creator or reader.
About Me
- Writer Zero
- I'm an old-school engineering drop-out turned kick ass technical writer.