21
Managing in an XML environment Sarah O’Keefe, Scriptorium Publishing background image flickr: thelastminute Tuesday, June 15, 2010

Managing technical communicators in an XML environment

Embed Size (px)

DESCRIPTION

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

Citation preview

Page 1: Managing technical communicators in an XML environment

Managing in an XML environment

Sarah O’Keefe, Scriptorium Publishing

background imageflickr: thelastminute

Tuesday, June 15, 2010

Page 2: Managing technical communicators in an XML environment

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

Page 3: Managing technical communicators in an XML environment

This session is not about XML implementation.

flickr: thelastminute

Tuesday, June 15, 2010

Page 4: Managing technical communicators in an XML environment

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

flickr: soschilds

Tuesday, June 15, 2010

Page 5: Managing technical communicators in an XML environment

Technical communication is evolving.

flickr: leafbug

Tuesday, June 15, 2010

Page 6: Managing technical communicators in an XML environment

Automation requires compromises.

flickr: rtpeat

Tuesday, June 15, 2010

Page 7: Managing technical communicators in an XML environment

XML changes tech comm management.❖ Transparency

❖ Accountability

❖ Metrics

❖ Skill sets

❖ Collaboration

Tuesday, June 15, 2010

Page 8: Managing technical communicators in an XML environment

XML increases transparency.

flickr: groundzero

Tuesday, June 15, 2010

Page 9: Managing technical communicators in an XML environment

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

Page 10: Managing technical communicators in an XML environment

High-quality content

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

❖ Formatting: Attractive, consistent, well-executed

❖ Searchable, findable, discoverable

Tuesday, June 15, 2010

Page 11: Managing technical communicators in an XML environment

Transparency means accountability.

flickr: leafbug

Tuesday, June 15, 2010

Page 12: Managing technical communicators in an XML environment

Seductive metricsflickr: oriananash

Tuesday, June 15, 2010

Page 13: Managing technical communicators in an XML environment

Useful metrics

flickr: garryknight

Tuesday, June 15, 2010

Page 14: Managing technical communicators in an XML environment

The writing quality equation: QUACK

flickr: law_keven

Tuesday, June 15, 2010

Page 15: Managing technical communicators in an XML environment

If it looks like a duck…

Quality + Usability + Accuracy + Completeness + KoncisenessCost

Tuesday, June 15, 2010

Page 16: Managing technical communicators in an XML environment

Writing in XML changes the mix of skills needed.

Writing abilityToolsDomainPeople skills

Writing abilityToolsDomainPeople skills

Traditional XML

Tuesday, June 15, 2010

Page 17: Managing technical communicators in an XML environment

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

deliverable focus

❖ Looking for excuses to avoid reuse

Tuesday, June 15, 2010

Page 18: Managing technical communicators in an XML environment

Don’t succumb to BOSSY.

flickr: kandypics

Tuesday, June 15, 2010

Page 19: Managing technical communicators in an XML environment

CROC is your friend.

flickr: tambako

Tuesday, June 15, 2010

Page 20: Managing technical communicators in an XML environment

Summary

❖ Learn to QUACK.

❖ Don’t be BOSSY.

❖ Make friends with CROC.

Tuesday, June 15, 2010

Page 21: Managing technical communicators in an XML environment

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