Managing technical communicators in an XML environment

Post on 15-Jan-2015

2.448 views 1 download

Tags:

description

Recorded webcast from Sarah O'Keefe. Delivered June 15, 2010

Transcript of Managing technical communicators in an XML environment

Managing in an XML environment

Sarah O’Keefe, Scriptorium Publishing

background imageflickr: thelastminute

Tuesday, June 15, 2010

Housekeeping notes

❖ Everyone is muted except for the presenter

❖ Please ask your questions through the Questions area in the webcast interface

❖ The presentation is being recorded; attendees do not appear in the recording.

Tuesday, June 15, 2010

This session is not about XML implementation.

flickr: thelastminute

Tuesday, June 15, 2010

It’s about what happens after the transition to XML.

flickr: soschilds

Tuesday, June 15, 2010

Technical communication is evolving.

flickr: leafbug

Tuesday, June 15, 2010

Automation requires compromises.

flickr: rtpeat

Tuesday, June 15, 2010

XML changes tech comm management.❖ Transparency

❖ Accountability

❖ Metrics

❖ Skill sets

❖ Collaboration

Tuesday, June 15, 2010

XML increases transparency.

flickr: groundzero

Tuesday, June 15, 2010

How do you measure high-quality content?❖ Writing: clear, concise, audience-

appropriate, accurate (!), up-to-date

❖ Formatting: Attractive, consistent, well-executed

❖ Searchable, findable, discoverable

Tuesday, June 15, 2010

High-quality content

❖ Writing: clear, concise, audience-appropriate, accurate (!), up-to-date

❖ Formatting: Attractive, consistent, well-executed

❖ Searchable, findable, discoverable

Tuesday, June 15, 2010

Transparency means accountability.

flickr: leafbug

Tuesday, June 15, 2010

Seductive metricsflickr: oriananash

Tuesday, June 15, 2010

Useful metrics

flickr: garryknight

Tuesday, June 15, 2010

The writing quality equation: QUACK

flickr: law_keven

Tuesday, June 15, 2010

If it looks like a duck…

Quality + Usability + Accuracy + Completeness + KoncisenessCost

Tuesday, June 15, 2010

Writing in XML changes the mix of skills needed.

Writing abilityToolsDomainPeople skills

Writing abilityToolsDomainPeople skills

Traditional XML

Tuesday, June 15, 2010

The biggest hurdle: Collaboration❖ Shift to topic focus rather than

deliverable focus

❖ Looking for excuses to avoid reuse

Tuesday, June 15, 2010

Don’t succumb to BOSSY.

flickr: kandypics

Tuesday, June 15, 2010

CROC is your friend.

flickr: tambako

Tuesday, June 15, 2010

Summary

❖ Learn to QUACK.

❖ Don’t be BOSSY.

❖ Make friends with CROC.

Tuesday, June 15, 2010

Final notes

❖ scriptorium.com/resources/webcasts for the webcast recording (allow three business days)

❖ Check scriptorium.com/events for upcoming events

Tuesday, June 15, 2010