Managing Writers

16 April 2009

Headed to DocTrain/DITA and STC Summit

Filed under: DocBook, DocTrain, Uncategorized — Tags: , , , — @ 12:44 pm

I will be at both the Society for Technical Communication (STC) Summit in Atlanta next month (May 2-6) and DocTrain/DITA in Indianapolis (June 2-5).

At the former, I will be talking about employee performance evaluation as part of a “Progression,” which is the conference version of speed dating. There are tables set up in a large room, with a presenter at each table. Each presenter has a topic related to the progression; in this case, the broad topic of the progression is management and my sub-topic is employee performance evaluation.

Attendees join whichever table has a topic of interest, then every 20 minutes or so, the moderator blows a whistle (metaphorically) and attendees move to another table. The progressions I’ve been to in the past were informal events where you could talk with presenter about pretty much anything related to their sub-topic (or not).

Should be fun; I plan to prepare a “checklist” for performance evaluation that attendees can take away with them, and I’ll be prepared to discuss whatever they are interested in. If you’ve read my book, Managing Writers or the excerpts published in the Managing Writers blog, you know I have strong opinions about the topic, which I’ll be glad to share with anyone who stops by my table.

DocTrain/DITA is a whole different game. I will give two presentations, DocBook in the 21st Century: Yes, Virginia, There is a DocBook, and it is Alive and Well, which talks about the latest version of DocBook, and Getting Started with DocBook, which is aimed at getting attendees up and running with the DocBook schema and stylesheets.

More information about the DocTrain/DITA conference and my talks at my personal blog.

11 April 2009

Better Know a DITA

Filed under: XML Press — Tags: , , — @ 10:05 pm

As a long time DocBook user and advocate, it seemed to me that it was time to learn more about DITA. To that end, I have started two activities on the XML Press website. The first is an ongoing series of articles titled, A DITA Adventure, which follows my attempt to set up and use the DITA Open Toolkit. So far, I have downloaded, installed, and run a rudimentary test. Next up will be to try and generate some different types of output.

I’ve also posted a DITA Information Needs Survey, which is looking for input on what information people are looking for to help them use DITA. XML Press will use the results of that survey to help plan a series of DITA-related publications.

As a thank you to participants, XML Press will send the results of the survey to all participants who choose to leave their email address and will select one participant at random to receive his or her choice of a free copy of my book, Managing Writers: A Real World Guide to Managing Technical Documentation, or XML Press’s first DITA publication (which this survey will help determine).

The survey will be open until May 15.

1 April 2009

Practical DITA

Filed under: Uncategorized — @ 6:25 pm

I just posted a review of Julio Vazquez’s new book, Practical DITA at XML Press.

The short review is that if you are brand new to DITA, but understand at least a little bit about markup languages (basic HTML is probably enough), this is a good place to start. It is a short excursion through the DITA philosophy and basic usage. For my full review, go here.

Powered by WordPress