managing technical communicators in an xml environment
DESCRIPTION
Recorded webcast from Sarah O'Keefe. Delivered June 15, 2010TRANSCRIPT
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