How to Stay Sane in An Insane Economy

Transcription

How to Stay Sane in An Insane Economy
AUGUST 2003
VOLUME 5, NUMBER 4
How to Stay Sane in An Insane Economy
Helen Sullivan, Director of Technical Career Development, Collin County Community College District
There’s no doubt about it. We live in crazy
times. Some may call them insane.
And one of the craziest places to be these
days is at work.
You find pressure and stress everywhere
you look:
impossible deadlines, and no recognition
for work done under increasingly stressful
circumstances.
No Wonder I’m Depressed!
How you feel about these events and circumstances often determines how you respond to
♦ Last year, the government exercised very
them. In other words, your attitude plays a sigvisible public pressure on corporations to
nificant role in how you handle life’s unexcorrect suspect accounting
pected curve balls.
practices. This shake-up in
How do these reactions and
corporations may have
feelings about negative events
started at the top, but you’d
and circumstances manifest
“…your
better believe that this presthemselves in the workplace?
attitude plays
sure rolled downhill to the
See if any of the following
lowliest person on the corresonate with you:
a significant
porate totem pole.
role in how
♦ Procrastination—Do you
♦ Although 2003 hasn’t seen as
habitually arrive late for
you handle
significant a number of laywork or miss deadlines?
offs as 2002, the economy
life’s
♦ Emotions on the edge—Do
still has areas of instability,
unexpected
you snap at co-workers or
and no one really considers
customers and find yourself
curve
balls.”
his or her job totally secure.
in ongoing conflicts with
♦ Some companies are still
other departments?
struggling to stay in business, and others
♦ Frustration from lack of control over cirwho had planned to flex their entreprecumstances—Do you have more health
neurial muscles have decided to postpone
issues than are normal for you, or do you
investing in new ventures. As a result,
find that you are seeking comfort in alcoalong with earlier downsizing, out-ofhol, drugs, or excessive eating?
work employees have flooded a tight job
market.
♦ Survivors of layoffs may have kept their
jobs, but at what price? They are under
incredible pressure to perform, not only
their normal work but also the work that
remained from employees who left voluntarily or involuntarily.
♦ Add to these factors the regular garden
variety of negative circumstances that
haven’t gone away—office politics, a difficult boss or co-worker, boring work,
♦ Inflexibility—Do you cling to old ways of
doing things, or do you revert to your
default personality type?
CONTENTS
How to Stay Sane in An
Insane Economy
page 93
From the Director
page 94
CASE STUDY
Single Sourcing HTML and
PDF with FrameMaker and
WebWorks
page 98
CASE STUDY
Usability, Knowledge
Management, and the
Bottom Line
page 103
CONTENT MANAGER’S NOTEBOOK
Intellectual Property:
Culture, Commerce, and
Digital Rights Management
page 107
TOOLS AND TECHNOLOGY
The Growth of ASP Content
Management
page 112
TOOLS AND TECHNOLOGY
Enabling Language
Translation with XML Tools
and Standards
page 115
BOOK REVIEW
What’s in The Rise of the
Creative Class for Technical
Communicators?
page 121
Manager’s Calendar
page 124
Choose Your ‘Tude, Dude!
“Now that I’m all depressed thinking about
my stressors and what I’m not doing to address
them, is there anything I can do about them?”
Yes. I’m here to tell you that you can do
something very effective… you can choose
your attitude. Believe it or not, your choice of
Continued on page 96.
The Center for Information-Development Management
710 Kipling Street • Suite 400 • Denver, CO 80215
93
FROM THE DIRECTOR
From the Director
JoAnn Hackos
Best Practices Newsletter
A publication of the Center for
Information-Development
Management.
710 Kipling Street, Suite 400
Denver, CO 80215
Phone: 303/232-7586
Fax: 303/232-0659
www.infomanagementcenter.com
Publisher and
Center Director
JoAnn Hackos, PhD
joann.hackos@comtech-serv.com
Managing Editor
Tina Hedlund
tina.hedlund@comtech-serv.com
Production Manager
Lori Maberry
lori.maberry@comtech-serv.com
Information Developer
Christina Meyer
christina.meyer@comtechserv.com
How to subscribe: a one-year subscription (6 issues) is $99.
Subscribers outside the US add
$10 (US funds only).
Contact Lisa Odneal
303/232-7586, or send email to
lisa.odneal@comtech-serv.com
How to submit an article: contact
Tina Hedlund
tina.hedlund@comtech-serv.com
How to join the Center:
call JoAnn Hackos at
303/232-7586,
or send email to
joann.hackos@comtech-serv.com
©2003 Comtech Services, Inc.
All rights reserved.
Printed in the USA.
94
Dear Friends,
As I’m sure you all know, the theme of the
2003 Best Practices conference is Innovation:
Making It Happen. The emphasis of the conference is on the “making it happen” part. We
can all happily dream up new things to do in
our organizations, but actually proposing the
right innovations and then getting people to
adopt them often proves difficult and frustrating.
With the Innovator’s Forum, immediately
following the conference, we will help put concrete plans together to support new ideas. As
part of the planning, I’ve been reading many
articles on successful change. One of my favorites is “Tipping Point Leadership,” by W.
Chan Kim and Renee Mauborgne (Harvard
Business Review, April 2003, Product 3353).
Kim and Mauborgne are management professors at Insead in Fontainebleau, France.
To prepare their article, they conducted
an in-depth study of William Bratton, who
served as police commissioner in New York
City in the 1990s and was instrumental in
lowering the city’s crime rate. They sought to
understand how he accomplished the turnaround, especially in such a politically charged
environment as New York. The tag line of the
article reads
“How can you catapult your organization
to high performance when time and
money are scarce? Police Chief Bill Bratton has pulled that off again and again.”
In my welcome address at the Best Practices conference, I will discuss in some depth
the four steps that Kim and Mauborgne outline. These steps are distilled from Bratton’s
work and help us transform the tipping point
from an interesting concept into a workable
program for change.
I’m most interested, at present, in the first
step in the process, called Breaking through
the Cognitive Hurdle. The authors explain
that most people involved in decision-making
about a change don’t respond to sensible arguments, extended examples, or even dollars and
cents. Even the bean counters, who complain
that they are interested in the numbers, won’t
act if they don’t understand the problem or
believe that any change is necessary.
Bratton’s technique, at the core of tipping
point leadership, is to help key decision makers
actually experience the problem. Without a
lesson in reality, the need for innovation never
catches on. For example, Bratton decided that
he had to convince his senior staff that the
public’s complaints about the subways were
meaningful. They simply didn’t think the
problem was that serious. Besides—New Yorkers always carp about the subway. Big deal.
Convinced that making the subway safe
was the highest priority in the turnaround,
Bratton required that all his transit police
officers commute by subway, himself included.
None of them had ridden the subway in years.
Not until they saw the graffiti, experienced the
lawlessness of the gangs, and got mired in nonworking equipment themselves did they
understand the public’s point of view. And,
only then did they agree that something
needed to be done.
Bratton had gotten his officers over the
cognitive hurdle. They had to gain a visceral
and cerebral understanding of the problem
before they were ready to respond to new
ideas. A colleague of mine used a similar tactic
a few years ago to convince his mechanical
engineering staff that they had to redesign a
critical piece of equipment used in treating
gravely ill patients. He had feedback from
users that the equipment was difficult and slow
to adjust, resulting in unnecessarily long treatment times. They reported that patients,
already anxious about their illnesses, were fur-
BEST PRACTICES • AUGUST 2003
FROM THE DIRECTOR
ther stressed by the ill-adjusted and awkward
equipment.
His problem—the engineers weren’t especially concerned. So the technicians had a
problem with the usability of the equipment.
Couldn’t they just be trained better? Our colleague used a drastic approach to move his
engineers through the cognitive hurdle. He
took them out to customer sites and had them
experience the problem firsthand.
If this sounds somewhat like a customer
site visit as part of a usability study, you’re
right. That’s exactly what occurred. The engineers observed the users trying to adjust the
equipment. They played the roles of patients,
enduring the long adjustment periods flat on
their backs with heavy lead weights on their
bodies. It wasn’t pretty. The experience
changed their entire perception of the problem. They came back committed and energized about redesigning the equipment
immediately and correcting all the adjustment
problems.
Experiencing a problem firsthand can be a
life-altering experience. I worked with a team
of software programmers designing a medicalrecords system. It was clear from a first view of
the prototype software that they were completely oblivious about the users’ world. The
prototype was completely unusable to anyone
but the designers. I suggested that they visit
some users, conveniently located across the
street from the software-development department. They took me up on the suggestion.
Months later, meeting the same programmers over lunch in the cafeteria, they told me
that the meetings with users and the direct
observations of their work had “changed their
lives.” These were senior professionals, committed to doing good work. They simply
needed to break through the cognitive hurdle.
I invite you to consider ways in which you
can help decision makers in your organization
overcome their reluctance to support innovation and change. Have they tried to find information on the corporate Web site? Do they
know how it feels to use the products the company develops? Have they seen people at work
having difficulty learning what to do?
In information development, we tend to
be a bunch of introverts who sincerely believe
that if we work hard and keep our noses to the
grindstone, someone will notice our good
work and reward us. Well folks—it ain’t gonna
happen. We need to sell the ideas we have for
making things better, after we’re certain, of
course, that the ideas are better for the customers and the company, not just for us.
Because this is the last issue before the
September Best Practices conference, you’ll
have to attend to hear my view of the rest of
the hurdles. Register today at <www.infomanagementcenter.com/conference.htm>.
I hope I’ve given you a bit of an experience, though vicarious, about change management. Please join me and your colleagues for
more real-life stories. See you in Seattle.
JoAnn
Tipping Point Leadership
Kim and Maugorgne, studying the techniques used by Bill Bratton, former police chief in New York
City, identified four hurdles to be overcome in implementing change:
Cognitive hurdle
Our staff members respond best when they experience directly the problems
our customers have in finding and using information to perform tasks or
solve problems.
Resource hurdle
By targeting our resources on contributions that add value to the organization, we make best use of what we already have.
Motivational hurdle
Political hurdle
Reforming everyone and everything at once may be appealing, but it’s
doomed to failure. We need to solve problems with key influencers who can
help to spread the message.
Powerful interests, such as product developers and marketing managers,
often resist change. We must identify the naysayers and find ways to silence
them.
Center Associates
Henry Korman
Wordplay
korman@wp-consulting.com
Ginny Redish, PhD
Redish & Associates, Inc.
ginny@redish.net
Jonathan Price
The Communication Circle
jprice@swcp.com
David Walske
David Walske, Inc.
david@walske.com
Advisory Council
Bill Gearhart
BMC Software
william_gearhart@bmc.com
Julie Bradbury
Independent
Diane Davis
Synopsys
ddavis@synopsys.com
Vesa Purho
Nokia
vesa.purho@nokia.com
Daphne Walmer
Medtronic
daphne.walmer@medtronic.com
Palmer Pearson
Cadence Design Systems
palmer@cadence.com
CIDM Vendor Members
Arbortext
PG Bartlett
pgb@arbortext.com
Progressive Information
Technologies
Suzanne Mescan
smescan@pit-magnus.com
Innodata
Toni Sydor
toni_sydor@inod.com
ISOGEN International
Marit Mobedjina
maritm@isogen.com
We can apply the four-step “tipping point” strategy to the challenges of an information-development
and instructional-design environment. Learn to recognize the hurdles in your organization and discover how information managers have successfully overcome them.
AUGUST 2003 • BEST PRACTICES
95
HOW TO STAY SANE IN AN INSANE ECONOMY
Resources for Further
Study
How to Stay Sane in An Insane Economy, continued from page 93.
The following books are some of
my favorites that have helped me
through tough times. Maybe they
will speak to you.
When they change their thinking and discover
attitude can change your circumstances. One
that there’s more than one way to find cheese,
of the key elements of this choice is separating
their perspective on life changes.
your emotions from your circumstances.
In my own work experience, I found a
Abraham Maslow said, “One can spend a
good teacher of attitude at my first job. I
lifetime assigning blame, finding the cause ‘out
worked for a small daily newspaper where regthere’ for all troubles that exist. Contrast this
ular complaints were phoned in to the circulawith the ‘responsible attitude’ of confronting
tion department. Customers couldn’t find
the situation, bad or good, and instead of asktheir papers, the newspaper landed in a puding ‘What caused the trouble? Who was to
dle, the dog ate it, someone stole it—you
blame?’ Asking ‘How can I handle this present
name it, someone was always unhappy about
situation to make the most of it? What can I
some aspect of their service.
salvage here?’”
The circulation manager lisThere are examples all
tened patiently to each complaint
around us of how a difference in
over the phone and commiserated
attitude impacted a circum“…[as] a
with what the customer was going
stance.
manager in
through. By the end of the converIf you read Main Street, a
sation, this manager not only
classic novel by Sinclair Lewis,
your
made the customer feel better but
and contrast the reactions of
organization,
he also followed through on each
Carol and Bea to the small town
complaint and left the customer
where they live, you’ll see that
…you have a
feeling satisfied. In other words,
one woman hated the town
powerful
he changed their attitude.
because of what it didn’t have
influence over
and the other one loved it
because of what it did.
Am I the Problem or the
your group,
One of my favorite Mary
Solution?
and you set the If you are a manager in your orgaTyler Moore Show episodes featured the irrepressible Ted Baxnization, then you have a powerful
tone for your
ter, the buffoonish TV
influence over your group, and
organization.” you set the tone for your organizaanchorman who didn’t possess
many brain cells. One day, Mary
tion. If your organization seems to
was feeling depressed because
have a negative atmosphere, look
her life seemed to be in a rut. Ted told her that
at your attitudes first before you start addresshe felt the same way until he woke up one
ing your group’s collective attitude.
morning and everything he did he did with
Think about the following:
enthusiasm—it was the same daily routine,
♦ I can’t control the actions of others, but I
only he took joy in every task. (It’s not humorcan control my reaction to them.
ous to read about it here, so you’ll just have to
♦ Am I willing to take a risk to make some
see the episode in re-runs on cable.)
changes in myself?
Two good books that have striking exam♦
Do I have any false or unrealistic expectaples about changes in attitude are Zapp! The
tions?
Lightning of Empowerment by William C.
Byham and Jeff Cox and Who Moved My
♦ Do I have any significant turnover in my
Cheese? by Spencer Johnson. The first book
group, and do I understand the reason for
details a workplace that is drained by repressive
this turnover?
working conditions but is turned around when
the employees are empowered to do their jobs.
Here Are Some Options To Consider
The second book is a brief story about mice
After you’ve cleaned up any negative attitudes
who go to the same spot daily looking for their
of your own, look externally to factors that
cheese but find out one day that it is gone.
may be affecting your group.
Leadership books
The 21 Irrefutable Laws of
Leadership
John C. Maxwell
The Leadership Challenge
James M. Kouzes and Barry Z.
Posner
Leadership When the Heat’s On
Danny Cox and John Hoover
Leading Change
John P. Kotter
Principle-Centered Leadership
Stephen R. Covey
Work environment
Zapp! The Lightning of
Empowerment
William C. Byham and Jeff Cox
Toxic Work
Barbara Bailey Reinhold
Seize the Day
Danny Cox and John Hoover
Who Moved My Cheese?
Spencer Johnson
Difficult Conversations
Douglas Stone, Bruce Patton, and
Sheila Heen
1001 Ways to Energize Employees
Bob Nelson
More good stuff
Getting to YES
Roger Fisher and William Ury
You Don’t Have To Go Home from
Work Exhausted!
Ann McGee-Cooper
Your Personality Prescription
Roberta Schwartz Wennik (based
upon Myers-Briggs)
Influence Without Authority
Allan R. Cohen and David L.
Bradford
Working with Difficult People
Muriel Solomon
Whale Done!
Ken Blanchard
Quotes and Quips (Franklin Covey)
96
BEST PRACTICES • AUGUST 2003
HOW TO STAY SANE IN AN INSANE ECONOMY
♦ If you are the manager of a group that has
been impacted by downsizing, you can
provide a stable influence that can help
your group. To counter layoff fears and
the economic realities surrounding your
group, don’t pick extremes when responding to employees—go for the stable middle ground. You can still deliver a realistic
message to your group; you just don’t
have to use inflammatory words to deliver
it.
♦ Employees are looking to you for guidance and stability in tough times. Take
care of yourself so you can provide that
guidance and stability to others.
♦ Revisit the basics of what makes you a
great manager. What are your strengths? Is
it teambuilding, mentoring, career guidance, planning? Play to those strengths
while you shore up your areas of weakness.
♦ Where would you like to improve? Tackle
one thing at a time. Now is the time when
great leadership skills get a real workout.
Practice situational leadership.
♦ Learn all you can about your company, its
customers, and the state of the market so
you can answer employee questions and
help them understand how they fit into
the big picture.
♦ Revisit personality profiles and communication methods. Remember that office
politics revolve around relationships, and
relationships are tempered by personality
types.
♦ Have your listening skills taken a beating
lately? Listen and then test for understanding. This is such a no-brainer, but
when we are under stress, it’s one of the
first skills to go out the window.
♦ Be honest and authentic. You can be real
and professional at the same time.
♦ Foster strengths in your team, just like
you are reinforcing your own strengths.
People like to feel good about themselves
and their talent.
♦ Adversity can pull a group together. A
trainer one time joked to me that his
group performed at a high level when they
AUGUST 2003 • BEST PRACTICES
fought a common “enemy.” Sometimes in
the most stressful situations, the greatest
creativity surfaces.
Get Those Creative Juices Flowing
If you need some help to get started in examining where you may have attitude issues with
yourself or your group, try the following exercise.
Spend a few minutes answering the following questions and see if they lead you to
Helen Sullivan
some solutions:
Director of Technical Career
♦ Pick a circumstance or event where you
Development
remember that you were happy or content. What were the circumstances? What Collin County Community
College District
was your attitude? What affected your
attitude that caused you to be happy?
(Was it an internal change or an external
influence?)
♦ Pick a circumstance or event when you
were unhappy or discontent. What were
the circumstances? What was your attitude? What affected your attitude that
caused you to be unhappy? (Was it an
internal change or an external influence?)
♦ Pick an attitude at work that you exhibit
that you would like to change. (Some
examples: intimidated, bored, depressed,
frustrated, snappy, judgmental, victimized.)
How does this attitude impact how you
relate to others? Do you exhibit a behavior
that causes someone else to have a bad
attitude?
♦ Is there a bad attitude at work exhibited
by an individual or group? Name it. What
is the cause of this attitude? What changes
could be put in place to turn around this
attitude?
♦ Do you have an experience where you,
someone else, or a group did something
that changed a bad attitude or working
environment? Describe it.
♦ Brainstorm a list of ideas on how you can
get your employees involved in changing
the work environment (attitudes). What
would this new environment look like or
feel like?
A good attitude may not be the most important trait a person develops, but it ranks right
at the top of the list.
HIRISHK@aol.com
Helen Sullivan is Director of
Technical Career Development
for the Collin County
Community College District,
which is north of Dallas, with
a student population of 30,000
across five campuses. She
directs a National Science
Foundation grant to promote
careers in science and
technology by partnering with
a consortium of four colleges
and universities and by
working with advisory
councils in technology
corporations.
She formerly was Director of
Training and Documentation
Services at Nortel Networks,
with her 15-year career in
information development
starting at NEC America.
She holds a bachelor’s degree
in math from the University of
Texas at Austin and began
graduate work in journalism at
the University of North Texas
before launching her first
career as a newspaper
reporter and editor.
She is a member of the
Society for Technical
Communication (STC) and a
conference speaker on quality
processes and measurements.
97
CASE STUDY
C A S E
S T U D Y
Single Sourcing HTML and PDF with FrameMaker
and WebWorks
Peter Dykstra, Director of Product Information, Donovan Data Systems, Inc.
Peter Dykstra
Director of Product
Information
Donovan Data Systems, Inc.
peter.dykstra@
donovandata.com.
Peter Dykstra is director of
product information at
Donovan Data Systems, Inc.
in New York. He has over 20
years’ experience as a writer,
editor, and software product
manager.
Interested in publishing to the Web but not
ready to install a full XML content-management system? That was our situation. Facing
complaints and usability issues with our library
of legacy PDFs, we decided to add HTML
support to our existing publishing environment, extending rather than replacing our current tools. The approach has let us achieve the
benefits of Web-based publishing for endusers. In the process, we’ve also laid the
groundwork for further development of our
content-management architecture and started
to think and write in content-management
terms.
We now use an automated system based
on Automap, the server-based version of
Quadralay WebWorks, to translate Adobe
FrameMaker files to HTML. The system supports HTML versions of about 50 manuals,
representing more than 10,000 pages of documentation for our core products, available to
clients on the Web. WebWorks automatically
updates the HTML library from FrameMaker
books as writers make changes to books.
Background
New product information for our company’s
software products is developed from the
ground up to be online, either built into the
products or on our support Web site. But we
also have a sizable library of information that
was published originally as books before the
days of online documentation. The bulk of
this information—any document longer than
several pages—is maintained in FrameMaker
and published on our Web site in PDF format.
People rely heavily on this information; the
online library of PDF manuals is the most visited destination area on our Web site.
Problems with PDF
Though PDF documents provide several
major benefits (such as central access to current documents, strong support for printing,
and reduced printing cost), they have several
drawbacks for online use. Our users (especially
experts who use documents frequently) com-
98
plain that PDF access is cumbersome and
inconvenient. Some specific complaints
include the following:
♦ Finding information is hard if you don’t
know which document you need. The
Web site allows searching for PDF documents that contain a phrase, for example,
but after you find a list of documents containing your phrase, you still have to
download and search each document
individually to find specific references.
♦ To look at a single topic, you have to
download the entire document. Because
manuals are generally several hundred
pages long, this is cumbersome, even with
a fast Web connection.
♦ Pages are laid out based on the pre-existing “printed page” format. Text is often
either too small to read or (if you enlarge
it) runs off the edge of the screen.
♦ PDF requires readers to switch back and
forth between the standard browser-based
interface and the Acrobat Reader interface. One sample complaint—page numbers in the original document don’t match
the PDF-assigned page numbers—creates
confusion about page references.
Overall, navigating among PDF documents
slows people down, results in unsuccessful
searches for information, and reduces performance and satisfaction.
The HTML alternative
A way to address the above issues is to publish
documents as native HTML pages on the
Web. Many people find these easier to read
online. With JavaScript or Java, it’s also possible to provide powerful search and navigation
capabilities for faster access to topics, providing a generally more responsive user interface.
The main issue in developing a large
HTML-based Web site is content management. Each page has to be created, managed,
and presented to the user as a separate file. For
BEST PRACTICES • AUGUST 2003
CASE STUDY
pages are created automatically, the software
us, this requires storing and managing thouwriters don’t have to deal with HTML or other
sands of HTML files, as well as a framework
Web technology directly.
for navigation.
A high-end approach would be to convert
all text to an XML-based content-management
Why Users Like It
and publishing system. But that’s a major
The initial release of HTML-based versions
undertaking, difficult to justify for an existing
received an extremely positive response from
library. Another, more accessible approach for
some of the heaviest users of existing PDF
FrameMaker users is to continue to maintain
manuals in our client support groups. The
manuals in FrameMaker and convert them to
general reaction was that the HTML versions
HTML for the Web. WebWorks software is
are much easier to use online than PDF. See
designed to work with FrameMaker to do this.
Figure 2. Features cited include the following:
This provides the main advantages of HTML
♦ cross-document search
publishing for the Web but is
across all documents in a
easier than switching to native
library or set
HTML or XML—for one thing,
“…[a]
more
writers can continue to use their
♦ combined table of contents
accessible
existing tools.
for multiple related books in
the same library
approach for
Our Approach
♦ responsiveness, with quick
FrameMaker
Several years ago, our publishing
jumps to any page
group decided to explore the use
users is to
♦ screen-based formatting,
of WebWorks to convert
continue to
which adjusts lines to the
FrameMaker manuals into
maintain
size of the current window
HTML, allowing us to produce
without changing font size
both output formats—HTML
manuals in
and PDF—from the same source
FrameMaker
documents. See Figure 1. We
Project Recap
already used WebWorks to proand convert
Requirements
duce HTML Help files, which
A pilot project with a small set of
them
to
were written from scratch for
established agreement
online delivery. Converting the
HTML for the manuals
among managers that documenexisting books to HTML was
Web.”
tation in HTML format would
simple in concept—we would
be beneficial, but before proceedsimply use a different Webing, we had to assess whether we
Works template to produce HTML rather
could support this on a production basis.
than Help projects. But implementation also
To be worth doing, conversion would
involved a number of significant practical
have to support HTML access to a broad
issues. We would be converting a significant
range of our legacy documentation (approxiamount of text, which had not been written
mately 50 main manuals in the US and Canfor online delivery. We had to adapt the supada). It would also have to be accessible
plied WebWorks template to work with the
through standard browsers supported by our
existing books. And we needed an infrastruccompany’s Web site. The HTML documents
ture that would allow multiple teams to pubwould have to be integrated with the existing
lish books to a single centralized library on the
Web site so users could still go to one place for
Web and update the HTML as FrameMaker
product information. (HTML would not
books were updated—all quite different from
replace PDFs, which are still useful to print
producing separate Help projects.
manuals.)
We now publish FrameMaker documents
From a production perspective, the
as both PDF and HTML. The HTML docuHTML conversion would have to work in our
ments produced by WebWorks include a comdecentralized writing environment, giving
bination of HTML and XML, with Java- or
each writer independent control over converJavaScript-based components that provide
sion of individual books but also be easy for
search and navigation. Because the coded
AUGUST 2003 • BEST PRACTICES
99
CASE STUDY
Figure 1. The Strategy: One Source, Two Publishing Formats
FrameMaker source files for each book are used to produce two different output formats.
Figure 2. HTML-Based Books on the Web
Users see a single table of contents and index for a multi-book set and can search for text across all HTML books. Unlike with
PDFs, the reader can jump directly to any topic in any book and see the page quickly.
100
BEST PRACTICES • AUGUST 2003
CASE STUDY
writers to use, allowing writers to work essentially as they did before, without becoming
HTML or XML experts or spending time
managing document conversion.
We wanted conversion to be unattended,
which meant we also needed a quality assurance (QA) strategy to monitor the process,
spotting errors in conversion caused by errors
in books.
We also needed an audit trail so that writers could easily tell which books had been
updated to the Web, with ability to track version status and history for a book, a set, and
the product library as a whole, with centralized
QA and a way to monitor use.
We moved all documentation files from a
Novell server to an NT-based server that could
run Automap. Quadralay provided sample
batch files for controlling unattended operation. We set up batch files that writers can use
to mark books that require updating and
extended these to provide logging and posting
of updated files to the public Web server outside the firewall.
Features
The HTML library provides the features
described below for end-users, writers, and
production managers.
For users
Implementation process
HTML books are accessible to
Based on a sampling of our
users who have passwords to our
books, we concluded that most
Web site. The output format supbooks could be converted to
ports Netscape 4+ and IE 4+
“Once in the
HTML with an acceptable level
browsers on Windows and the
of effort. We also concluded that,
Mac, accessible to most users.
HTML
once each book had been set up
Users can jump to their choice of
library, they
for conversion, the idea of updatHTML or PDF versions for each
can search and book. Once in the HTML
ing HTML in the background as
the book was updated was feasilibrary, they can search and navinavigate
ble, using WebWorks’
gate quickly across the entire
quickly across
server-based version, Automap,
HTML library. (In tests we sucwhich runs as a batch process on
cessfully set up 50 books with a
the entire
a server.
single navigation window but
HTML
The first step was to develop
found this unwieldy. We ended
library.”
a WebWorks template to support
up with multiple book sets, each
our company’s FrameMaker doccontaining 6 to 10 related books
ument templates. We developed
with common TOC, search, and
this by modifying a template proindex. We didn’t use an available
vided by WebWorks, adding HTML formatfeature that lets users mark favorite pages
ting for styles in the FrameMaker templates,
because of concern that bookmarks would
including elements such as paragraphs and
become obsolete as libraries are updated.)
character formats, cross references, and graphFor writers
ics. Development of the template was an iteraSetup for each manual requires a general scan
tive process, based on testing with multiple
for formatting issues, an initial test conversion,
manuals.
and a process of cleaning up formatting probBased on the tests, we set up a QA guide
lems. Non-standard FrameMaker formatting
that writers can use to prepare and test a manthat might work with a “printed page” format
ual for conversion. (In practice, our producin PDF often does not convert cleanly to
tion editor became an expert and a central
HTML. Most problems can be fixed by folresource for setting up books and working
lowing published tips. But some can require
with writers needing assistance.)
some painful repairs. For example, complex
We added several new elements to the
graphics with multiple layers and callouts conFrameMaker template to support HTML—
vert flawlessly if set up correctly, but if individmainly custom markers to support navigation
ual graphic elements are not placed in an
links from within the HTML pages to the releanchored frame in FrameMaker they end up
vant pages on our Web site. Adding these to
garbled or missing in HTML even though
each manual became part of the set-up process.
AUGUST 2003 • BEST PRACTICES
101
CASE STUDY
In the process, we’ve also cleaned up documentation files because product teams
worked together to identify the core set of
information that would be in the HTML
library.
By extending FrameMaker with WebWorks’ technology, we’ve leveraged existing
resources to produce an HTML-based library
more quickly and with less cost than possible
otherwise. Because we had to learn about the
technology to apply it to our environment, we
now have an infrastructure that’s
Behind the scenes
suited to our requirements and the
A series of batch files developed
understanding we need to support
in consultation with Quadralay
and extend it.
automates the conversion pro“…users have
In the process, we also learned
cess. A scheduled task runs on
about
some of the limitations
made it clear in
the server every 10 minutes,
inherent in our current tools and
checking for books that need
initial
documents. It’s easier to see benean update and launching batch
fits of XML-based documents and
reactions
that
jobs to convert individual
separating content from publishbooks as needed. HTML files
they now have of
ing, which our current system does
are posted to an internal Web
faster and
only in limited ways.
server so writers can check their
By adding a publishing format
easier access to
HTML output within 15 minthat depends on automated translautes after requesting a converinformation— tion, we’ve also added a set of QA
sion. The updated HTML is
requirements. Now when we write
the explicit
copied through the firewall to
a manual, it has to work as HTML.
the main Web server overnight
purpose of the
As a result, we know that our docuusing a scheduled task.
ments conform to a common strucproject.
Central log files allow
ture. This consistency can serve us
monitoring and debugging of
in various ways. For example, preproblems with individual book
sentation of information is more uniform. We
conversions (though these have been rare). A
can update document formats centrally. If we
batch command allows an administrator to
do decide to move to an XML-based system in
scan conversion logs to check for errors in all
the future, we have a common starting point,
current books in a single action. Existing Web
which would make that step much easier.
tools allow us to monitor usage levels of the
The jury is still out on how many people
HTML books on the server.
will actually use HTML in place of PDF. We’re
monitoring its use, and have added HTML
Assessment
manuals as a topic for discussion at informal
What have we accomplished? First of all, a sigroundtable assessments of product informanificant number of users have made it clear in
tion to learn which aspects users like and what
initial reactions that they now have faster and
their remaining issues are. We already have a
easier access to information—the explicit purwish list of features for the next release.
pose of the project.
they may look fine on the page in
FrameMaker.
To update a book once it’s been set up, the
writer simply clicks on a batch file in the
book’s directory on the LAN. This sets a flag
marking the book for update. A status history
file and a copy of the conversion log in each
book’s directory track when HTML updates
were requested and when they were actually
run and let a writer check directly for conversion errors detected by Automap.
102
BEST PRACTICES • AUGUST 2003
CASE STUDY
C A S E
S T U D Y
Usability, Knowledge Management, and the Bottom Line
Elsa Bethanis, Technical Writer, re:Member Data Services, Inc.
Consider this example of how poor
Imagine an auto factory with parts scattered in
knowledge management can affect anybody
random boxes. Parts are missing, in the wrong
who needs to communicate information
boxes, unlabeled, mislabeled, outdated, and
within a company. At our hypothetical comchanging constantly. Sometimes the parts sit in
pany, consultants make up a good percentage
rooms apart from the machines where they’re
of the staff and have communication tools that
used, and sometimes they are in the right
no one else has, so they can share information
room. Every now and then, someone dumps a
among themselves, but people who want to
truckload of new parts in the factory, and peowork with them do not have the necessary
ple grab a few and run off with them. Is that
tools. The consultants are locked out of the
an efficient auto factory? Of course not. And
“official” tool that employees use to communiit’s not a cost-effective one, either.
cate because it contains some confidential corSo, what’s your factory like? For knowlporate information. Some employees
edge workers, the factory is
don’t like the official tool and won’t
your company’s internal inforuse it, and other employees use only
mation structure; the people
the official tool and avoid alternative
are the machines. A company
“For
forms of communication. No intrathat’s designing software or
knowledge
net exists until some employees, desworking with highly intangiworkers, the
perate to communicate, build one,
ble intellectual assets needs
people to use that information
factory is your ad hoc. Because management doesn’t
really approve of the intranet and
efficiently. Companies that
company’s
sanctions only the official tool, only
pay attention to and tend
the people who know about the
their information gain
internal
intranet use it. Because it is worked
increased productivity; cominformation
on furtively and randomly, the ad
panies that place little value
hoc intranet is a mess, filled with
on their information are like
structure; the
irrelevant information as well as very
that disorganized factory.
people are the
relevant information, and it is diffiWho can help make the facmachines.”
cult to navigate. Information is diffitory more efficient? People
cult to find in the official tool as well
who understand information
because attempts to manage inforand usability.
mation in the tool are half-hearted and spoUsability goes hand in hand with knowlradic.
edge management. When usability experts
Because information exists in so many
make a business case for usable systems (Help
formats, it is replicated, and then, of course,
systems or other software systems), they tend
changed by whoever has it in a format that
to focus on the time end-users spend trying to
could be edited. So, a question of validity of
make a poorly designed system work. Or they
information comes up constantly. What is offifocus on the training efforts that need to be
cial? Employees spend so much time chasing
implemented to get people to use the system,
information that producing anything is diffithe cost of support, and other factors relating
cult and far more time-consuming than necesto conversions and training. But experts don’t
sary. A technical writer’s real challenge is not to
often focus on the effects that poor usability,
add to the mess of information but to centralparticularly for internal systems like intranets,
ize and organize it.
has on knowledge management and how
Say that this company has 200 employees.
knowledge management, in turn, affects the
And let’s say that those employees spend 15
bottom line.
minutes a day trying to find information and
AUGUST 2003 • BEST PRACTICES
Elsa Bethanis
Technical Writer
re:Member Data Services,
Inc.
ebethanis@remember.com
Elsa Bethanis is a technical
writer for re:Member Data
Services in Indianapolis. She
has eight years of technical
writing experience for a
variety of software products.
She also worked as an editor
for Macmillan Computer
Publishing and earned an
MFA from the University of
Massachusetts at Amherst.
Her special interests in
technical writing include
knowledge management and
its relation to content
management, information
architecture, and the role of
technical writers in software
development processes.
103
CASE STUDY
45 minutes a day verifying information
(checking validity, trying to find who wrote
something, meeting to discuss information
that already exists, and so on). That’s one hour
a day of information gathering.
Sound unreasonable? Consider this very
plausible scenario, which all of us have
encountered in some capacity:
♦ Joe Software needs a detailed piece of
information to write some code. He does
not know whom to ask. He fires off an
email to his boss or another worker to
determine who has that information. (5
minutes for both his time and the other
worker’s time)
♦ Fortunately, he lucks out and is told that
the information he needs is documented
and on the intranet. After poking around
a bit, he finds the document. It is written
in a program he doesn’t have, but he’s a
clever knowledge worker and figures out a
way to read it without the program. (5
minutes)
♦ Joe Software spends 10 minutes trying to
understand the document. It is badly
written, but he is able to make do. Still, it
seems wrong somehow. Or he has an idea
and wants to clarify that his idea will
work. Better call the person who wrote
the original document. But who is it? (10
minutes)
♦ He calls the person who is likely to have
written the doc. But that person was not
the writer. That person writes three emails
to attempt to help Joe identify likely document authors. (10 minutes for his time
plus the time of the people trying to help
him)
♦ It turns out, finally, that the document
author is no longer with the company. Joe
Software fires an email to three people to
ask for help in clarifying the information.
(5 minutes for everybody’s time)
♦ He receives responses from three people,
plus another person who is likely to be
able to help. (5 minutes for everybody’s
time, conservatively speaking)
♦ The project was passed along to someone
new. That person completely reworked
the original document, but he didn’t
104
know that the original information was
still floating around. So, he sends Joe the
new document. (5 minutes from both
people)
♦ Joe reads the new document. The new
writer left out some information that the
original writer had included. That information was valuable. Joe emails the new
writer to ask why the original information
was left out. Just as he sends the email, he
receives an email from someone else
explaining exactly that point. (5 minutes,
from all involved)
♦ Jill Software also needs the information
Joe needs. She finds the outdated document on the intranet and assumes it’s current. She winds up working with the
outdated information and gives Joe her
deliverable. He calls her to explain what’s
changed. (10 minutes)
♦ Joe removes the old document from the
intranet and posts the new one. But he
forgot about the email that he received
from the new author that explained some
differences. The new author is hit with
questions about the same point that confused Joe. (10 minutes)
♦ Meanwhile, another person in the company saw the original document, assumed
it was current, and spent half an hour creating information that was built on the
original document. About 10 percent of
that new information is wrong.
So here we are, at more than an hour of “information gathering” time. Many of us play one
or more of these roles multiple times per day.
The more unlucky among us might spend all
or most of our days essentially chasing information around.
Let’s look at cost. If an employee is paid
$25 per hour on average, works 50 weeks a
year, and works 40 hours a week, a lost hour
per day for that employee means that the company is losing $6250 per year to unproductive
time just for that employee. If you multiply
that number by 200 employees, that is
$1,250,000 in lost productivity. Or to go back
to the factory analogy, that’s time the factory
employees spent moving parts from room to
room and box to box, not time spent actually
building anything!
BEST PRACTICES • AUGUST 2003
CASE STUDY
issue because there are so many deliverables.
But before encouraging a single-source solution for information, it’s worthwhile to consider not just how people use the deliverable
once they find it but also how—and
whether—they find it in the first place.
♦ the amount of time people spend looking
When people can’t find the information,
for the information
eventually they give up and may simply rewrite
information that may actually be available
♦ the amount of time people spend rewrit(and better written) but is unusable because it
ing and reworking information because
can’t be located. That’s additional wasted time.
they can’t find what they need
And because now the information is repli♦ the amount of time people spend quescated, users and writers just added to the pile
tioning and trying to verify the validity of
of information about a particular
the information
subject matter. Everybody must
spend more time verifying what
♦ the additional problems
“…usability
the official source of information
that develop from dupliis, question discrepancies between
cated, outdated, and ad
experts and
sources, and maintain information
hoc information
technical
that’s constantly outdated.
♦ the problems of security
A knowledge-managementwriters
need
to
risks that occur when
oriented technical writer or usabileverybody is allowed to put
consider
ity expert needs to watch to see
information wherever they
whether
their
where information surfaces and
want
why it surfaces there. Sometimes,
business cases
the information surfaces because
A special note about single
for more
it’s needed. More often, it surfaces
sourcing: sometimes singlebecause someone was trying to
sourcing problems are really
usable
make sense of information that
knowledge-management probsoftware and
already existed or because that perlems. When you’re investigating
son could not find the deliverable
an apparent single-sourcing
better
that he or she needed.
issue, you need to ask, “What is
information
A company filled with knowlthe core issue? Are people really
include
edge workers should eventually be
looking for the same or very
able to use its knowledge to prosimilar information in a variety
knowledgeduce new products of similar or
of formats?” If so, you are lookmanagement
greater difficulty with increasing
ing at a true single-sourcing
ease and less cost. When employees
issue.
factors.”
must spend most of their time repBut over time, I’ve come to
licating information just so they
consider that the preceding sort
have something to work with instead of using
of problem is not all that common. People neiinformation as a base for new solutions, you
ther want nor need the information in a variare running a factory where some parts are
ety of formats. One deliverable, properly
made at overcapacity and certain key parts are
placed, serves the need. The issue is that peonever made. Technical writers and usability
ple cannot find the deliverable in the corporate
experts can organize the factory and make the
infrastructure, so someone creates another
production of information dependable and
deliverable with similar content, and then
efficient. We can also help when the factory
someone else creates one, and then someone
has to reorganize to make new products—
else creates one… and suddenly, there are mulkeeping information available for people who
tiple deliverables in multiple locations, all at
need it.
various points of needing to be updated. So,
the problem appears to be a single-sourcing
So, usability experts and technical writers
need to consider whether their business cases
for more usable software and better information include knowledge-management factors.
We need to include
AUGUST 2003 • BEST PRACTICES
105
BEST PRACTICES 2003
Innovation: Making It Happen
Best Practices 2003 Conference—September 22–24, 2003
Innovations are easy to imagine and difficult to make happen. At the Best Practices conference, experience how fellow information managers make a difference in their organizations:
♦ Learn to cope by bringing current resources to bear on solving problems.
♦ Help key managers and staff understand your vision.
♦ Identify your key team members who can help everyone understand the need for change.
♦ Disarm the naysayers and laggards.
The Best Practices conference provides a forum for senior managers in information development, training, and content management to share ideas, discuss issues, solve day-to-day problems, set long-term strategies, keep abreast of new developments
and technologies, and network with a community of professional colleagues from around the world.
Prepare for the challenges of Tipping Point Leadership in introducing innovations and making the changes that your team
needs to succeed in tough economic times.
Join us for the most valuable management conference in your profession.
Innovator’s Forum—September 25–26, 2003
The Innovator's Forum is a new addition to the CIDM Best Practices conference. It provides a year-long opportunity for you
to work on an innovation and change project of your own.
♦ One and one-half day workshop immediately following the Best Practices conference (Thursday through Friday noon) to
prepare your plan to introduce an innovation to your organization
♦ Support by professional colleagues and CIDM mentors at the workshop
♦ Ongoing support through a special Forum listserv and group calls throughout the year
♦ Follow-up two-day workshop to discuss progress and challenges and to generate new ideas for success
♦ Accumulated knowledge and experience in a White Paper report to the participants
♦ Best Practices 2004 presentation of Forum results
Plan now to extend your conference experience in this stimulating professional activity. Bring back concrete results to your
team and your management from the conference.
If two people from your department attend the conference and forum, you will receive a CIDM membership for one year.
Join the Innovator’s Forum immediately following the Best Practices conference. Turn your ideas into reality.
Outstanding Speakers, Sessions, and Location
Join us at the water’s edge. The Edgewater hotel overlooks Puget Sound in downtown Seattle, Washington. It's down the hill
from historic Pike Place Market, the locale of the FISH! philosophy—last year's theme. As you prepare to attend in 2003, read
Malcolm Gladwell's The Tipping Point: How Little Things Can Make a Big Difference (Back Bay 2002), this year's theme book.
Register for the conference and forum at www.infomanagementcenter.com/conference.htm.
106
BEST PRACTICES • AUGUST 2003
CONTENT MANAGER’S NOTEBOOK
C O N T E N T M A N A G E R ’S N O T E B O O K
Intellectual Property: Culture, Commerce, and
Digital Rights Management
David Walske, David Walske, Inc.
Mortal Consequence
I stood alone on the stage, save for the accompanist whom I had met moments earlier, having greeted him nervously with a
concatenated, “Hi how are you nice to meet
you,” as I handed my sheet music over the top
of an old stage-battered piano. Before me, in
an auditorium that might otherwise hold an
audience of many, stood a lone figure, Alexander Ruggieri, director of the West Hollywood Chorale.
“Please begin.” His voice resonated with
the unmistakable timber of stern authority. I
hesitated, wondering at that instant what had
possessed me to audition. Ruggieri, a man
known more for professionalism than
patience, unhesitatingly jarred me out of my
stupefaction. “And what is it that we shall hear
you sing tonight?” he asked.
For my audition piece, I had chosen, Let
the River Run, a song you may remember as
having been popularized by Carley Simon
some years ago. I began, faltering on the opening note but quickly getting a vocal grasp on
the piece, a song I had spent many hours practicing with Carley on CD.
Cruentus
I thoroughly enjoyed singing in live performances while I was a member of the chorale.
But the truth is, I would have happily attended
the rehearsals even if there never were to be a
performance. Alexander Ruggieri provided
more than musical direction. He was a fountainhead of musicological knowledge that I
found engrossing, even hypnotic. From time
to time, he would pause between songs to
impart a small measure of that knowledge,
some bit of background information pertaining to the music we were rehearsing.
Once, while rehearsing for a Mozart concert, he spoke to us of the mensural notation
sprinkled throughout a difficult piece we were
attempting to master. Mensural notation, originating in the 13th century, is a musical codification that lets composers assign a specific
AUGUST 2003 • BEST PRACTICES
fixed time value to individual notes within a
piece of music. In the time of Mozart, these
notes were commonly scribed in red ink, setting them apart from the other notes penned
in black so that their unique time values would
not be overlooked. According to Ruggieri, the
term mensural derives from a reference to the
blood-like color of the red ink.
So fine
Mensural notation is uncommon in modern
music, subsumed largely by counterpoint, and
when it does appear in print, such as in a modern publishing of Mozart’s works, it does not
generally appear in blood-red ink. However,
modern music is not without its own kind of
sanguinity. Musical composition is sometimes
the object of dispute in figuratively bloody
battles over intellectual property ownership.
In 1970, Apple Records released George
Harrison’s well-received solo album, All Things
Must Pass. While not his first solo effort, many
regard the album as fundamental to the successful launch of Harrison’s post-Beatles career.
The centerpiece song of the album, My Sweet
Lord, enjoyed great popularity in its release as a
single. Unfortunately even as My Sweet Lord
was flying high on music charts worldwide, the
copyright holders of Lonnie Mack's He's So
Fine were bringing a plagiarism suit against
Harrison. The plaintiffs alleged that Harrison’s
hit song was based on Mack’s earlier work,
which had been a chart-topping hit in 1963,
recorded by The Chiffons.
The ensuing legal battle played out over
many years. Although the exact determination
of damages—how much should be paid to
whom—remained in dispute for decades, a
1976 court judgment determined that an
infringement of copyright had indeed
occurred. The court agreed with the plaintiffs’
assertion that Harrison’s use of short repeated
musical phrases, or motifs, that were common
to both songs constituted infringement.
Although the two musical compositions
were in many ways differentiable from each
David Walske
David Walske, Inc.
dwalske@walske.com
<www.walske.com>
David Walske has over
twelve years of experience in
the software industry. As an
independent consultant, he
specializes in information
architecture and content
management. He has
developed single-source
solutions, online information
systems, and Web sites for
software, fashion, retail, and
publishing clients. David
teaches workshops in Help,
Web, and content authoring
tools. His client list includes
industry leaders such as
Microsoft, Symantec,
Xircom, LASTC, and UCLA.
David is a regular speaker at
events such as the
WinWriters Online Help
Conference, the Help
Technology Conference, the
STC Pan-Pacific conference,
and SingleSource
conferences. Quadralay
Software has named David a
Certified WebWorks Wizard.
107
CONTENT MANAGER’S NOTEBOOK
A Different Approach
Best selling author Seth
Godin has taken a somewhat
unconventional approach in
respect to preservation of
copyrights in his book,
Unleashing the Ideavirus.
Reminiscent of
Abbie Hoffman’s radical book
title, Steal this Book, the
opening pages of Godin’s
book encourage the reader
to, “Steal this idea!”
“An idea that just sits there
is worthless. But an idea that
moves and grows and infects
everyone it touches… that’s
an ideavirus. In the old days,
there was a limit on how
many people you could feed
with the corn from your farm
or the widgets from your
factory. But ideas not only
replicate easily and well,
they get more powerful and
more valuable as you deliver
them to more people.” (p.3)
—Seth Godin
Unleashing the Ideavirus
Seth Godin
Hyperion
NY:2001
ISBN: 0786887176
other, the inclusion of the common motifs
provided sufficient grounds for the court to
rule against Harrison and his associates. Viewing this case in the context of the world of
online information and structured content, it
is not difficult to draw a parallel. The musical
motifs that became the basis of the decision
were shared sub-elements of the larger structure of both songs. This is really not all that
different in principle from the use of shared
elements across documents in multiple information databases.
Copyright
The concept of copyright began as a simple
idea: literally, “the right to make copies.” The
notion of protecting intellectual property dates
back at least as far as 18th century Britain, as is
evidenced by the Statute of Anne, dated April
10th, 1710, that states, “…the author of any
book… shall have the sole liberty of printing
and reprinting such book… for the term of
fourteen years….” In the United States, copyright can be traced back to 1776 as defined in
Article 1, Section 8, Clause 8 of the United
States Constitution which states, “…the Congress shall have power… to promote the
progress of science and useful arts, by securing
for limited times to authors and inventors the
exclusive right to their respective writings and
discoveries.” It is generally understood today
that an author possesses copyright to his or her
own work beginning at the very instant it is
created, whether or not any formal or informal
actions are taken to secure that right. Of
course, proving and defending copyright can
be another matter entirely: potentially a matter
of serious and mortal consequence.
Ownership
The framers of the Constitution believed in
the importance of protecting intellectual property rights. Clearly, to encourage authors and
others to produce creative works, they needed
to grant them exclusive rights to such works.
In time, all copyrighted works enter the public
domain—by constitutional definition, copyrights are valid only for a limited time. The
copyright holder benefits through remuneration during a fair period of ownership, and
society at large benefits through enrichment by
creative works. Creative productivity is good
for both culture and commerce.
108
Who owns what?
Technical documentation, whether created by
direct employees or independent contractors,
generally falls into the category of “work-forhire.” This means that the company for which
the work is completed retains all rights of
intellectual property and all copyrights. In this
context of work-for hire, the term author refers
to the company, not the individual content
developer. As a documentation manager, you
likely look to a company legal department for
clarification on issues of intellectual property.
But even though the decisions behind such
clarifications may be out of your hands, as a
manager of content, it is vital that you understand such issues and how they play out in the
day-to-day world of information development.
Today’s copyright law affords authors full
copyright protection—that is, the rights to
make and distribute copies, create derivative
works, and publicly display or perform written
works—for the author’s life plus 70 years.
However, the simple concepts of copyright
envisioned by the founding fathers have grown
into a labyrinth of complexities. No longer a
matter of simply who is allowed to make a
copy, intellectual property concepts circumnavigate print, electronic, and subsidiary issues
and are further complicated by an increasingly
distributed electronic information base. As we
breach the intellectual corporate firewall to
reach out to a worldwide distributed knowledge base, understanding how to manage intellectual property rights at a more granular level
becomes necessary.
Digital Rights Management
Digital rights management (DRM) provides a
means for granular control of intellectual
property rights based both on generally applicable copyright laws and on contractual agreements defined by licensing. Your first
encounter with this concept may have come in
the form of an introduction to some kind of
DRM software application. Therefore, thinking of DRM solely from a tools perspective
might be tempting. But effective implementation of DRM—like content management
(CM)—requires careful consideration and
planning built upon a cumulative layered
approach, the final layer of which includes
software tools.
BEST PRACTICES • AUGUST 2003
CONTENT MANAGER’S NOTEBOOK
Effective DRM requires
♦ a well-defined intellectual property and
contract rights policy
♦ the technology to represent these rights
digitally
♦ the ability to tag and track content
granularly
♦ the software tools to apply DRM
technology
Because the underlying body of rights is likely
to vary widely as defined by each company’s
legal department, in this article I won’t speak
to the specifics of those rights but rather I’ll
focus on the technologies of tagging and tracking content for DRM. Issues of DRM may
also include those of patents, trade secrets, and
trademarks.
ISBN
No doubt you have come into contact with
ISBN (International Standard Book Number)
identifiers, perhaps without even realizing the
purpose or meaning of this system of identification. This standard has been in existence for
over 30 years and is used in the United States
and 158 other countries worldwide as a means
of positive identification for books and other
printed and electronic publications.
The 10-digit ISBN number, an ISO
(International Standards Organization) standard currently in transition to an expanded
13-digit format, provides a set of one billion
unique identifiers for cataloging an everexpanding worldwide collection of published
material. This collection is growing at the rate
of over 50,000 new titles per year. The
planned update to a 13-digit format will help
to ensure a continued supply of new, unique
ISBN numbers for assignment to future publications and makes the standard more compati-
Creative Commons
Concepts of copyright are necessarily absolute in their application. Copyrights are legally enforceable rights and therefore
should be expressed as clearly and unambiguously as possible. An author may or may not decide to claim copyright to a given
work, but such a claim is implicitly granted nonetheless.
An author can choose to retain or sell some or all of the copyrights to a given work. Or an author can choose to renounce
all copyrights, placing a work immediately into the public domain for the greater good. But these choices are rather disparate.
What if an author wants to distribute works free of charge, contributing them as objects of culture rather than of commerce
but without giving up all rights of control?
Creative Commons is a not-for-profit organization that promotes a moderate approach somewhere between “All rights
reserved,” and “Steal this idea.” This organization proposes a “spectrum of rights” that authors can mix and match in multiple
combinations to express a degree of retention of rights to their works. The Creative Commons logo—displayed in the works of
authors using this type of licensing—declares, “Some rights reserved.”
The “attribution” right specifies that those who reuse content so marked
must credit the original author. By the way, Creative Commons is the author
of the graphic to the left of this text.
The “noncommercial” right specifies that content so marked must not be
reused for commercial purposes without specific authorization from the original author.
The “no derivative works” right specifies that content so marked may only be
used intact and in its entirety unless the author has agreed otherwise.
The “share alike” right specifies that all of the rights stipulated in content so
marked must also be stipulated in the work of those who reuse it.
AUGUST 2003 • BEST PRACTICES
109
CONTENT MANAGER’S NOTEBOOK
ble with the 13-digit EAN-UCC international
product coding system of bar codes. See Figure
1. ISBN will continue to support existing tendigit numbers by prefixing them with an EAN
number 978. The EAN number used in standard bar code numbers specifies the type of
product represented in the bar code, in this
instance: books. For example the existing tendigit ISBN 0-349840-23-1 becomes ISBN
978-0-349840-23-1. When the 13-digit format is officially adopted in 2005, new ISBN
numbers will be prefixed with an EAN number of 979, effectively doubling the total of all
possible ISBN numbers to two billion.
Each hyphenated segment of the ISBN represents a
specific type of identifying information.
The check digit is used as a checksum to avoid errors in transmission
of the ISBN. A specific mathematical formula is applied to all but the
last digit. The numerical result of that calculation is assigned to the
final digit of the number: the check digit. If, after the ISBN has been
transmitted, the formula returns the same value as before, then the
ISBN has been sent and received without error.
Figure 1. A standard 10-digit ISBN represented as a 13-digit bar code.
When words collide
A personal note from the
author
Intellectual property
ownership has become
somewhat of a controversial
issue. Major media interests
seek to gain control over the
content they produce and
deliver. Opponents of this
viewpoint seek a world in
which content is more an
element of culture than it is a
product of commerce. They
favor more open access and
oppose enhancement of
intellectual property
ownership rights and
technologies. It is not my
intent in this article to take
either side in this debate but
rather to present information
about the current state of
digital rights management
technologies. You can find
links to additional
information on both sides of
this issue at
<www.walske.com>.
110
The ISBN system has proven to be a reliable
system for tagging and tracking intellectual
property. Bar code system software and peripheral hardware components are used to successfully manage virtually all published content of
every type and format, from publication
through distribution and beyond; a Herculean
task to say the least. But does the ISBN standard satisfy our previously stated set of DRM
requirements? It does, with one exception.
ISBN numbers identify content at the book or
volume level. Our need for tagging and tracking of intellectual property demands a much
finer granularity.
DOI
The DOI (Digital Object Identifier) system
provides a method of granular tagging and
tracking of intellectual property. DOI does not
supplant the ISBN system but rather is auxiliary to and compatible with it. The International DOI Foundation (IDF), created in
1998 to support the needs of the intellectual
property community in the digital environment, is participating in the ISO Working
Group for the ISBN revision project.
DOI numbers are an implementation of
the URI (Uniform Resource Identifier) standard and are used as a method of persistent
interoperable identification of intellectual
property at all levels of granularity in physical,
digital, and abstract forms. DOI is fully com-
patible with and expressible within XML
(EXtensible Markup Language).
The DOI number format combines a prefix and suffix to create a unique identifier. See
Figure 2. All DOI numbers begin with 10,
which declares that the number is a DOI. This
is not uncommon in unique numeric identifiers--all Visa® credit card numbers begin with 4
and all Master Card® numbers begin with 5.
The remaining numbers in the prefix, assigned
by the IDF, identify the intellectual property
owner—a publishing house, record company,
software publisher, or other organization. An
organization may have more than one prefix.
The suffix is assigned by the intellectual property owner organization and can be any alphanumeric string of any length. The IDF
Directory server resolves the entire DOI alphanumeric string to a specific digital resource.
Because both the DOI prefix and suffix
can be of any length, there are an unlimited
number of possible DOI numbers, precluding
the need for future expansion projects of the
type currently in progress to extend the ISBN
standard. And because DOI numbers are
opaque—that is, the numbers are meaningless
until resolved to a digital identifier, such as a
Web address or other resource—they are persistent and always provide current information. The DOI number remains static once
BEST PRACTICES • AUGUST 2003
CONTENT MANAGER’S NOTEBOOK
Figure 2. The IDF Directory server resolves DOI numbers to a specific digital resource.
assigned, but the information it represents is
updated as necessary.
XrML
EXtensible Rights Markup Language (XrML)
is an XML-based language specification for
expressing intellectual property rights associated with digital content and other digital
resources. XrML has been submitted for consideration as an official standard and is likely
to be accepted as such toward the end of 2003.
There are several advantages to using
XrML. Of course, it fulfills our stated DRM
requirements, but beyond that, because it is
native XML, using XrML includes all of the
advantages of XML, such as precision, extensibility, interoperability, and security to name
but a few. Some software publishers, such as
Microsoft for example, have already standardized on XrML. The XrML model views DRM
in terms of grants. In essence, an XrML grant
is a sentence in which the intellectual property
owner specifies who may take what action with
what object under what circumstances. See
Table 1.
Principle
Subject
David Walske
Right
Verb
may edit
Resource
Object
article.xml
Condition
Modifier
until August 1, 2003.
Table 1. XrML grant “parts of speech”
A principle is an identified party, authenticated
by one or more secure methods. A right is a
AUGUST 2003 • BEST PRACTICES
verb that describes an action that the principle
has been granted permission to perform, such
as view, copy, or loan. A resource is an identifiable digital object of any kind. A condition is
the expression of the terms of the grant, typically a limitation of some kind, often a measure of time. An XrML grant uses a specific
XML code syntax to authenticate users and
then grant specific rights as defined by the policy of the intellectual property owner.
Keys to Successful Content
Management
The expanding reach of technology continues
to shrink our world. Information that was
once occult has become freely available to all
those who care to partake, opening up new vistas of shared knowledge and information. But
to successfully share information in such an
open environment, we must be very clear
about our actions and intentions and respect
intellectual property ownership. And we must
be able to swap information with total strangers confident not only in the veracity of the
information we receive but also in the security
of the transaction by which we receive it. In
this article, I provide a brief glimpse into some
of the underlying principles and technologies
that can be put into play by executing a wellconsidered and carefully planned DRM system. Creating a secure interoperable environment that promotes the untrammeled
exchange of information is one of the keys to
successful content management.
111
TOOLS AND TECHNOLOGY
T O O L S
A N D
T E C H N O L O G Y
The Growth of ASP Content Management
John Girard, CEO, Clickability
John Girard
CEO
Clickability, Inc.
john@clickability.com
112
structure remotely. The next logical step: why
The content-management space has followed a
not contract with the software developer
predictable trajectory as far as enterprise softdirectly to maintain the infrastructure and
ware goes. Several early market entrants grew
software? Who would know better than the
to take a large share of the market. And in the
developer how to optimize the solution?
past few years, newcomers have exploded,
With this insight, the ASP was born.
leading now to inevitable industry consolidation.
The first ASPs, then, were simply compaOutside the traditional drivers in the
nies that delivered business applications (often
enterprise software market, though, a larger
mission-critical) over the Web. All the applicaindustry pressure looms that has the potential
tion logic and data in an ASP is stored at the
to change not just how content management,
vendor’s data center. ASP customers access all
but how enterprise software, more generally is
application functions over the Web, typically
purchased and deployed. This pressure comes
using nothing more than the Web
from the unlikely resurgence
browser. No software to install, no
of a kind of business thought
hardware to install, and no mainteto have been wiped out by the
nance—not a bad proposition!
“…a larger
collapse of Web businesses
industry
Core-Business and the ASP
over the last few years: the ASP
business justification of the
(Application Service Provider).
pressure looms The
ASP model is straightforward and
It turns out, as the old
that has the
would be recognizable even to busisaying goes, that rumors of the
ness thinkers from a century ago. At
death of the ASP model have
potential to
its simplest, the ASP model plays on
been greatly exaggerated. To
change …how
the fundamental tension between
understand how the ASP
core- and non-core business funcmodel is poised to shake up
enterprise
tions. Most businesses, so the reathe world of content managesoftware more
soning goes, are very good at only a
ment, a little background on
small handful of business functions.
the ASP phenomenon is
generally is
This group of functions is the “core
important.
purchased and business” and anything not related
The Birth of a New
directly to the core business may be
deployed.”
a good candidate for outsourcing to
Business Model
another company. (“Your back
As the Web exploded, people
office is someone else’s front office”
first began to think seriously
is a saying that conveys that idea neatly.)
about alternatives to traditional software delivTo take a business school approach to the
ery. Firms like EDS had pioneered indepenquestion, let’s examine a turn-of-the-century
dently “managed” software solutions, but that
newspaper publisher as an example. What is
entailed little more than changing the physical
the publisher’s core business? Early newspaper
location of the installed software. Servers and
publishers saw their core business as “creating a
software licenses still had to be purchased, softnewspaper.” In this context, it made sense for
ware had to be installed and configured, and
the publisher to build and maintain a printing
there were significant ongoing maintenance
press and perhaps even have a hand in creating
costs to keep the infrastructure up and runthe raw materials (paper and ink). But no one
ning.
The Web offered a shift in this paradigm.
would expect the publisher to own the forest
or lumber mills that are instrumental in turnLarge enterprises were comfortable contracting
ing trees to paper—both are too far removed
with outside firms to manage their entire IT
from the core business and so are outsourced.
infrastructure (often off-site) and typically
gave individual employees access to that infra-
BEST PRACTICES • AUGUST 2003
TOOLS AND TECHNOLOGY
Soon, some publishers realized that they
weren’t really in the business of creating newspapers after all. They were actually in the business of creating content. And so they focused
on that core business, building impressive
news staffs and editorial services and beginning to outsource the non-core business—by
contracting with independent printers and distributors for the delivery of the final product.
And finally, some newspapers eventually
realized they weren’t really in the content business at all. Rather, they were in the business of
aggregating local audiences to sell to local
advertisers. So, they outsourced the non-core
functions of printing (to independent printers)
and even much of the content creation (to
content syndicators like the Associated Press
and Reuters) and focused efforts on the core
business of selling newspaper ads.
ASPs look for similar dynamics in the
markets they serve. When does an industry’s
business shift in such a way that certain information technology functions are no longer
core? I’ll answer that question with regard to
Web content management in just a minute.
ASP, Hosted Applications,
MSP—Different Terms, Same Idea
Between 1998 and 2000, ASPs attracted a lot
of attention. The proposed benefits were staggering: dramatically lower total cost of ownership and a single monthly fee that
encompassed hardware, software, maintenance
and service. Venture money poured into startups pursuing the ASP model.
And then the bottom dropped out. As the
capital markets collapsed, ASPs that had not
yet achieved enough momentum to support
operations independent of their venture capital
lifeline disappeared overnight. For customers
of many ASPs, the unthinkable happened as
mission critical data was wiped out or locked
up during lengthy bankruptcy proceedings. I
know one CEO who flew to San Francisco,
marched up to the (mostly empty) offices of an
ASP where much of his company’s billing
information was stored, and didn’t leave until
he had the data he needed on a floppy disk in
his briefcase.
In the blink of an eye, ASP became a bad
word, virtually synonymous with the over-exuberance of the dot.com era.
But even a basic analysis of the economics
underlying the software industry revealed to a
lot of people that the ASP model is quite
AUGUST 2003 • BEST PRACTICES
sound, and so the experimentation has gone
on quietly in the last few years.
While the central tenets of the model persisted, the name ASP was dropped like a hot
potato in favor of such terms as hosted software, MSP (Managed Service Provider), and
most recently Software-as-a-Service. At the
core, of course, all of these terms really mean
the same thing—someone else besides the enduser (or his or her company) is responsible for
maintaining the infrastructure required to
deliver the software.
The New ASP Pioneers
Largely because of the different terms that are
used to describe hosted software solutions, an
awful lot of activity is happening across many
different categories of enterprise class software
that has stayed below the radar.
For instance, with as much noise as a
company like SalesForce.com has made in the
sales force automation (SFA) and customer
relationship management (CRM) space, it’s
only now attracting the interest of the press as
an example of how the ASP model can be successfully applied to a well-established enterprise software category.
And while the SFA and CRM spaces have
provided fertile ground for companies like
SalesForce.com (and the followers it has created), it turns out that there are plenty of other
categories of enterprise software that are well
suited for vendors interested in deploying ASP
solutions. One of the most interesting categories in this respect is Web content management.
Hosted Content Management Basics
It can be argued that, of all the categories of
enterprise software, Web content-management
software is the one best suited for delivery in a
hosted format.
First, in most industries, Web content
management tends to pass the usual tests in
evaluating core versus non-core business functions with flying colors. Even traditional media
companies publishing on the Web, for example, increasingly look at their core businesses as
“creating content” and not “creating a Web
site.” The printing press analogy is a good one
here—once it becomes clear what is core and
what is not, the non-core is most likely fated
for outsourcing.
With Web content management, hosted
(ASP) solutions are simply the most efficient
and elegant way to outsource the function.
113
TOOLS AND TECHNOLOGY
A hosted Web content-management system usually looks no different to the end-user
(the everyday site administrator or editor, for
instance) than an installed solution. Many
applications in the enterprise today have Web
browser (or browser-like) interfaces. And
because of the efficiencies of the Internet, it
doesn’t really matter to the user whether the
program driving that interface is next door or
across the country.
In some ways then, the hosted versus
installed question is more semantic than anything. A CTO I know is fond of saying “in the
end, all enterprise software is ‘hosted.’ The
only question is who is doing the hosting.”
The Real Benefits of a Hosted CMS
There are two primary ways that hosted Web
CMSs are deployed in the enterprise today: as
a platform for the entire Web content-management infrastructure and as a complement to an
existing Web CMS installation.
The benefits of the “platform” approach
to a Web CMS are just what might be
expected of an outsourced provider. Chiefly,
because maintaining a sophisticated Web
CMS platform is a hosted CMS vendor’s core
business, a good vendor is typically able to
deliver a much higher quality service than the
equivalent function run in-house.
Put it this way: if your company’s Web
site goes down, the rest of the company keeps
going. If all of a Web CMS vendor’s customer
sites go down, that vendor is in big trouble.
Because hosting a Web content management
solution is the vendor’s core business, that vendor is likely to be more concerned about getting the job done right. Indeed, the business’s
very existence depends on it.
The cost differences between hosted and
installed Web CMS solutions can be enormous
too, especially when considering one of the
biggest efficiencies gained in this kind of
deployment: it becomes possible for a business
to have access to all the benefits of a scalable,
robust platform running a high-performance,
enterprise-class CMS application while paying
for only a fraction of the retail costs of those
benefits. Returning to our printing press analogy, it becomes possible for a company to pay,
say, 1/20th the total cost for a top-of-the-line
printing press and have (time limited) access to
100 percent of the machine. (1/20th of a
printing press wouldn’t be very useful would
it?)
114
The upshot here is that clients of ASP
content-management vendors can effectively
“rent” some space on a network that would
otherwise cost hundreds of thousands of dollars to build—for prices as low as $1,000 per
month.
The second way that enterprises use
hosted content-management systems these
days is to complement existing CMS implementations. For instance, for a variety of reasons many of the installed CMS solutions lack
even basic support for email newsletters.
Meanwhile, most hosted Web CMS vendors
provide built-in support for email newsletters,
and, as a result, many organizations that are
not ready to make a full platform switch elect
to use hosted CMS platforms that support
email newsletters as a complement to their
existing Web CMS applications.
The beauty of hosted solutions is that
they typically integrate very well with existing
Web CMSs and can add functionality at very
reasonable price points.
Thinking Long Term
Even the big software companies are beginning
to share a vision of a world where software
looks more like a utility and less like a locally
installed and managed application. Over the
long term, these experts argue, we will treat
applications the way we treat electricity or
(perhaps more aptly) pay television—we simply plug into the wall and are charged by how
much of the service we use.
Companies like Microsoft, Intuit, and
IBM have begun to experiment with this kind
of software delivery, in at least some part
because of the success of upstart ASP companies that have captured significant share in big
enterprise software segments at alarming rates.
SFA and CRM are two related spaces where a
lot of the early battles have been fought. The
recent surge in the success of hosted contentmanagement vendors suggests that it will be
one of the next categories to embrace the ASP.
Regardless of what is happening at the
industry level, though, any organization that is
thinking critically about content management
needs to seriously consider hosted content
management. Through an insource the core
and outsource the non-core evaluation, many
companies will find that going with an ASP for
Web content management will help keep Web
costs extremely low and keep the business
focused on the elements that ultimately drive
long-term success.
BEST PRACTICES • AUGUST 2003
TOOLS AND TECHNOLOGY
T O O L S
A N D
T E C H N O L O G Y
Enabling Language Translation with XML Tools and
Standards
Bryan Schnabel, XML Information Architect, Tektronix, Inc. with Gail Toft-Vizzini, ed.
Maintaining consistency between a source
document and its translated counterparts can
be complex and troublesome. Innumerable
challenges can arise with character sets, version
control, text in graphics, tables, expansion of
text, updates, and so on. Using XML for translation can help overcome some of these challenges.
In this article, I explain how XML tools
and standards can help remedy tricky issues
related to translation.
The Traditional Approaches
Typically, each of these approaches has to grapple with content and format being intertwined.
XML is a Natural Migration
Many companies have implemented XML to
make their documentation process more efficient. Their motives usually include
♦ efficient layout
♦ single sourcing
♦ automation
♦ data exchange
Because the challenge of translating documentation is not new, there are a number of tradi♦ e-commerce
tional approaches. With the traditional
♦ customer requirements
approaches, the content to be translated is
embedded in a desktop publishing, word pro♦ government requirements
cessing, or graphic illustration
XML can be a key to solving diffisoftware product. One of two
culties associated with translation
things typically happens.
Either the translator must
“XML can be a because it effectively separates content from format and enables the
translate the content in the
key to solving
translator to focus on the translasoftware product, or custom
tion, not the software package the
programming must be done to
difficulties
content is embedded in.
perform a kind of automated
associated with
XML offers operating system
text extraction and post-translation recomposition.
translation….” independence (Mac, Linux, Unix,
Windows). Usually, authors write
Three traditional
in their word processing or desktop
approaches to translation are
publishing software of choice. If the translator
♦ a supplier uses a potentially complex deskneeds to translate the content on a different
top publishing or graphics tool for layout
operating system, a potential risk of data coror uses a custom text extraction and
ruption arises when the characters are moved
recomposition tool
from one operating system to the next. XML is
operating system neutral, thereby mitigating
♦ an in-house localization department uses
this risk.
a potentially complex desktop publishing
A similar risk exists when the author and
or graphics tool for layout or uses a custranslator use different software packages. The
tom text extraction and recomposition
author might use his favorite word processing
tool
or desktop publishing software. Or a graphics
♦ a hapless document writer uses a cut-andillustrator might use her favorite graphics softpaste method to piece together a transware. The files might then be saved or filtered
lated document
into a different package for the translator.
XML is vendor independent, thereby mitigating this risk as well.
AUGUST 2003 • BEST PRACTICES
Bryan Schnabel
XML Information Architect
Tektronix, Inc.
bryan.s.schnabel@
exgate.tek.com
Bryan Schnabel is the XML
Information Architect for
Tektronix, Inc. As a world leader
in test, measurement, and
monitoring, Tektronix is one of
the principal players in enabling
the coming together of
computers and communications.
Bryan is a seasoned XML
practitioner. He embraces XML
as a portable, scalable platform
and vendor-independent means
to best utilize and protect a
company’s valuable data. Upon
completing his Bachelor of
Science and Master’s degree at
Central Michigan University,
Bryan began information
architecting for the automotive
industry. He began solving
problems with standards-based
technology early on, first with
SGML, then with XML. His
accomplishments include
serving on the J2008
Automotive Standard
Committee, being the Detroit
Director of the Midwest SGML
Forum, establishing and
directing the OregonXML
Forum, and serving on the
OASIS XLIFF Technical
Committee.
115
TOOLS AND TECHNOLOGY
XML has universal character support. It is
based in Unicode, which becomes very useful
once translation is required in non-Latin characters.
XML has standards-based facilities for
manipulating content, like XSL, XSLT, and
XPath, and standards-based facilities for
enforcing structure, like XML schema and
DTDs.
When XML is used for translation it can
♦ reduce the number of steps in the translation process
♦ help translators zero-in on the work they
have to do
♦ make it easier to update translations when
the source changes
All these benefits can result in cost and timeto-market savings for the translation process.
And an XML solution, because it is standards-based, is a portable, scaleable solution.
Applying XML to Images
XML provides an excellent way of describing
and modeling data. That model and description can be processed by a computer to produce desirable effects. Consider the following
simple XML as a way to model or mark up an
image.
<?xml version="1.0" encoding="utf-8"?>
<ImageFile>
<Circle id="c1" size="2in"
brdr="off" fill="red" loc="ctr" />
<TextBox>
<PositionRelation
CenterTo-id="c1" OffsetXdim="0"
OffsetYdim="0" />
<text id="t1">This is the picture
on my ski</text>
</TextBox>
</ImageFile>
You see that metadata provides detail about the
geometry of the elements that could be used to
create an image. You also see that the string of
text is marked up as content in the <text> element.
Graphics software designed to process
XML might render the previous code example
like the image in Figure 1.
116
Figure 1. If graphics software could render
XML
XML could be used to model data that
could be processed by graphics software. It is
also reasonable to expect that XML could be
used to model data that could be easily processed by software designed for translators.
Consider the following simple example.
The previous graphic image XML file could be
transformed through XSLT to a format more
easily processed by translation tools. The goal
of this XML format is to isolate and preserve
the hierarchy data from the translator and
present text in a useful, accessible way to the
translator.
<TransDoc>
<Wrap name="Circle" Watt1="c1"
Watt2="2in" Watt3="off"
Watt4="red" Watt5="ctr">
<Wrap name="TextBox" trans-unitref="t1">
<Meta name="PositionRelation"
at1="c1" at2="0" at3="0" />
</Wrap>
</Wrap>
<trans-unit idref="t1">
<source lang="en">This is the picture on my ski</source>
<target lang="de">This is the picture on my ski</target>
</trans-unit>
</TransDoc>
The metadata preserves the detail about the
geometry of the elements that were used by the
graphic image XML. The string of text is
marked up as content in the <trans-unit>
element. In this case, the string is presented in
a way that could be made available to a translator. A source string is provided in the
<source> element (“This is the picture on my
ski”), along with an attribute that says the
source language is English. The target string is
BEST PRACTICES • AUGUST 2003
TOOLS AND TECHNOLOGY
provided in the <target> element, along with
an attribute that prescribes the target language
to be German (de).
The translator would be shielded from the
hierarchy data and would edit only the target
text string.
<TransDoc>
<Wrap name="Circle" Watt1="c1"
Watt2="2in" Watt3="off"
Watt4="red" Watt5="ctr">
<Wrap name="TextBox" trans-unitref="t1">
<Meta name="PositionRelation"
at1="c110" at2="0" at3="0" />
</Wrap>
</Wrap>
<trans-unit idref="t1">
<source lang="en">This is the picture on my ski</source>
<target lang="de">Dieses ist die
Abbildung auf meinem Ski</target>
</trans-unit>
</TransDoc>
An XSL (eXtensible Stylesheet Language)
transformation could be applied to get the
translated text back into the
image format.
<?xml version="1.0"
encoding="utf-8"?>
<ImageFile>
<Circle id="c1"
size="2in" brdr="off"
fill="red" loc="ctr" />
<TextBox>
<PositionRelation
CenterTo-id="c1" OffsetXdim="0" OffsetYdim="0" />
<text id="t1">Dieses
ist die Abbildung auf
meinem
Figure 2. If graphics software could render
translated XML
These homegrown document types could
be made to work, but it might cause a problem
down the road. That is to say, with joint development and customization, Company A and
Translation Vendor A might develop a way to
use the homegrown ImageFile and TransDoc
document types. But what if Company A
needs to work with Translation Vendor B?
Almost certainly there would need to be more
development and more training to get everyone up to speed on the custom document
types.
“…industry
standards
…facilitate
efficiency,
portability,
and
interchangeability.”
Ski</text>
The Value of XML
Standard Doctypes
Today, there are a couple of
industry-standard document
types that provide the means to
enable language translation in
graphics files using XML tools
and standards:
♦ Scalable Vector Graphics
(SVG)
♦ eXtensible Localisation
Interchange File Format
(XLIFF)
Some advantages come with using XML:
</TextBox>
♦ content separated from format
</ImageFile>
♦ universal character support (UTF)
Then, the graphics software could render the
same image, only this time it would have
translated text, as shown in Figure 2.
While the previous example made use of
XML and XML tools, it also made use of
“home-grown” XML document types called
ImageFile and TransDoc.
AUGUST 2003 • BEST PRACTICES
♦ no dependency on proprietary formats
And by using industry standards for translation, you gain advantages because the standards facilitate efficiency, portability, and
interchangeability.
117
TOOLS AND TECHNOLOGY
What Exactly are SVG and XLIFF?
Strictly speaking, SVG and XLIFF are XML
applications, complete with validating DTDs
or XML schemas. Therefore, each can be
transformed with XML tools that implement
XML standards, like XSLT and XPath.
SVG is a language for describing twodimensional graphics in XML. SVG allows for
three types of graphic objects: vector graphic
shapes, images, and text. Graphical objects can
be grouped, styled, transformed, and composited into previously rendered objects.
SVG has several strengths worth noting:
♦ It is a World Wide Web Consortium standard.
♦ It is an XML document.
♦ It is a nonproprietary image format.
♦ SVG can be opened, manipulated, and
saved in popular graphics packages like
Adobe Illustrator, Corel Draw, and Visio.
♦ SVG can be processed with XML tools
and standards.
♦ SVG can be viewed in a browser.
XLIFF (XML Localization Interchange File
Format) defines a specification for an extensible localization interchange format that will
allow any software provider to produce a single
interchange format that can be delivered to
and understood by any localization service
provider. The format is tool-independent,
standardized, and supports the entire localization process.
XLIFF has several strengths worth noting:
♦ It is a standard of OASIS (Organization
for the Advancement of Structured Information Standards).
♦ It is an XML document.
♦ It is a nonproprietary document format.
♦ XLIFF can be opened, manipulated, and
saved in popular XML packages like
ArborText, XML Spy, and NotePad.
♦ XLIFF is being developed by translators,
tool vendors, and documentation experts.
♦ Tools in a translator's toolbox will be
XLIFF compliant.
The XML Round Trip
To use XML tools and standards to enable language translation, a round trip of the content
occurs.
With an admittedly not-so-trivial upfront
development, the nuts and bolts are pretty
straightforward. Each step below corresponds
with the number in the diagram. See Figure 3.
1 The image is created in a graphics software package (example, Adobe Illustrator). The file is saved as SVG.
2 An XSLT script is invoked that transforms
the SVG XML instance to an XLIFF
XML instance.
3 The XLIFF is delivered to the translation
vendor. The translation vendor uses its
XLIFF-enabled tools to translate the text
(optionally having the capability to view
the SVG for strings of text, in context).
The translation vendor returns the translated XLIFF instance.
4 An XSLT script is invoked that transforms
the translated XLIFF XML instance back
to an SVG XML instance.
5 The translated image file is maintained
and saved as an SVG XML instance.
Using SVG and XLIFF for
Translation: An Example
The following image was created in Adobe
Illustrator and saved as SVG. See Figure 4.
Figure 3. XML Roundtrip
118
BEST PRACTICES • AUGUST 2003
TOOLS AND TECHNOLOGY
Here’s a snip of the SVG XML code:
<switch i:knockout="Off"
i:objectNS="&ns_flows;" i:objectType="pointText">
<foreignObject requiredExtensions="&ns_flows;" x="0" y="0"
width="1" height="1" overflow="visible"><flowDef
xmlns="&ns_flows;">
<region><path
d="M127.89,175.478"/></
region><flow xmlns="&ns_flows;"
font-family="'Helvetica-Condensed'" font-size="9" textalign="center" text-alignlast="center">
<p><span>Processor board assembly</span></p>
</flow>
</flowDef>
<x:targetRef
xlink:href="#XMLID_1_" /></foreignObject>
Figure 4. Sample of Line Art saved as SVG
<text id="XMLID_1_" transform="matrix(1 0 0 1 80.6636
175.4775)"><tspan x="0" y="0"
font-family="'Helvetica-Condensed'" font-size="9">
Processor board assembly</
tspan></text>
</switch>
The second step is to transform the SVG to
XLIFF. Figure 5 shows the transformed XML,
as it looks in Arbortext Epic, with simple
screen styling.
The strings of text are presented to the translator. In its untranslated state, the source and
target elements contain matching English text.
The third step is for the translation vendor to translate the target strings, as shown in
Figure 6. The XML tool could be adapted to
display translated strings in a different style or
color for the convenience of the translator.
The fourth step is to transform the translated XLIFF XML instance to an SVG XML
instance.
Here’s a snip of the SVG XML code, with
the text stings translated to French:
Figure 5. Untranslated XLIF
<switch i:knockout="Off"
i:objectNS="&ns_flows;" i:objectType="pointText">
<foreignObject requiredExtensions="&ns_flows;" x="0" y="0"
width="1" height="1" over-
AUGUST 2003 • BEST PRACTICES
Figure 6. Translated XLIF
119
TOOLS AND TECHNOLOGY
flow="visible"><flowDef
xmlns="&ns_flows;">
<region><path
d="M127.89,175.478"/></
region><flow xmlns="&ns_flows;"
font-family="'Helvetica-Condensed'" font-size="9" textalign="center" text-alignlast="center">
<p><span>Panneau de processeur</
span></p>
</flow>
</flowDef>
<x:targetRef
xlink:href="#XMLID_1_" /></foreignObject>
<text id="XMLID_1_" transform="matrix(1 0 0 1 80.6636
175.4775)"><tspan x="0" y="0"
font-family="'Helvetica-Condensed'" font-size="9">
Panneau de processeur</tspan></
text>
</switch>
Conclusion
Translating documentation will always be a
tricky process. Documentation groups continue to improve processes, tools, and workflows. Content-management systems, be they
a straightforward use of high-end software
packages or optimized workflow practices, are
continuously being refined to meet the translation challenge. Translation operations are
maturing and improving, developing practices
and tools, such as translation memory, to take
on the unique dimensions that language translation brings to the table.
The choice of XML makes tools and standards more successful. Using standards that
reflect the experience and expertise from a
number of connected industries is a terrific
start, but casting the standard in XML brings
additional efficiency. The input of the group
brings robustness and strength to the standard,
while the use of XML provides portability,
scalability, universality, and stability to the
process of managing documentation.
The SVG could then be viewed in the graphics
software or in the browser. See Figure 7.
120
BEST PRACTICES • AUGUST 2003
BOOK REVIEW
B O O K
R E V I E W
What’s in The Rise of the Creative Class for Technical
Communicators?
Jean Richardson, Consultant, BJR Communications
Richard Florida’s The Rise of the Creative Class:
And How It’s Transforming Work, Leisure, Community and Everyday Life has taken the US economic development industry by storm. This
professor of Regional Economic Development
at Carnegie Mellon University in Pittsburgh,
Pennsylvania, entered the discussion of “what
now?” and “what next?” as the high-tech stock
market was making its rough ride to the bottom and America was reconsidering its deconstruction of the military/industrial complex in
favor of consumer products. His fresh writing
style and data-driven analysis appeal both to
the armchair economist and the popular culture watcher.
His thesis? There is a significant contingent in the 18 to 35-year-old demographic
that is quietly having a large impact on the
future of the development of products and
ideas in this country, and their potential to
shape our culture is just beginning to be
revealed. If properly identified as one of our
richest natural resources and employed in the
context of economic recovery, this resource,
which is flocking to certain locales throughout
the country, has the vitality and promise we are
looking for in the current recession.
Why is recognizing this contingent
important to managers of knowledge generation and management functions? Because the
creative class that Florida describes is largely
composed of people in these functions. He
looks at how their values, level of self-direction, portability, and social mores impact
attracting, retaining, and applying their talents
from a regional standpoint. He also discusses
how their lifestyles and work styles coalesce
and how they are motivated—largely by their
curiosity and opportunities to express their
creativity. His analysis of their sometimes surprisingly conservative values, preference for
loosely coupled relationships, and focus on
place is peppered with numerous insights into
working with and motivating these valuable
human resources.
AUGUST 2003 • BEST PRACTICES
In summary, this 404-page book, with
index, covers the topic in four parts and 15
chapters. Appendices beginning on page 327
show the cities and various indices he uses in
evaluating certain locations’ attractions for this
class of worker.
Part One: The Creative Age
These three chapters provide the obligatory,
and somewhat scholarly, backward glance to
give context for the rest of the discussion. This
is great reading if you are interested in economic and social history, as I am. In Chapter
Four, Florida explains his working definition
of “creative class” and how it relates to similar
analyses of work culture by other scholars:
The rise of the Creative Economy has had
a profound effect on the sorting of people
into social groups or classes. Others have
speculated over the years on the rise of
new classes in the advanced industrial
economies. During the 1960s, Peter
Drucker and Fritz Machlup described the
growing role and importance of the new
group of workers they dubbed “knowledge workers.” Writing in the 1970s,
Daniel Bell pointed to a new, more meritocratic class structure of scientists, engineers, managers, and administrators
brought on by the shift from a manufacturing to a “postindustrial” economy. The
sociologist Erik Olin Wright has written
for decades about the rise of what he
called a new “professional-managerial”
class. Robert Reich more recently
advanced the term “symbolic analysts” to
describe the members of the workforce
who manipulate ideas and symbols. All of
these observers caught economic aspects
of the emerging class structure that I
describe here. (p. 67)
Jean Richardson
Consultant
BJR Communications
jean@bjrcom.com
www.bjrcom.com
Jean Richardson is a
communication consultant in
private practice. She focuses
on hardware, software, and
Web-development. She is a
past president of the
Willamette Valley Chapter of
the Society for Technical
Communication in Portland,
Oregon, as well as a Better
Business Bureau Arbitrator,
and a Multnomah County
Court Mediator. With her
associate, Lisa Burk, she
trains other technical
professionals on conflict
management skills.
Part Two: Work
This section begins to cover the social and cultural differences between the creative class,
their parents, and their peers—including what
121
BOOK REVIEW
may be a few surprises. In a section on managing creativity, Florida discusses human
resource management strategies as they have
emerged in high-tech companies. Then, he
makes an interesting observation:
And these practices offered one great efficiency to firms—and one incredible
advantage to capitalism—which ultimately assured their further diffusion.
They enabled firms and the economy as a
whole to capture the creative talents of
people who would have been considered
oddballs, eccentrics or worse during the
high period of the organizational age.
Richard Lloyd quotes the founder of one
of the Chicago high-tech firms studied as
saying: “Lots of people who fell between
the cracks in another generation and who
were more marginalized are [now] highly
employable and catered to by businesses
that tend to be flexible with their lifestyles
and lifecycles.” (p. 140)
And later, he makes some observations about
managing creativity in high-tech companies
that may not surprise you:
We selected an edgy high-tech company
as the venue for our workshop and invited
two of their top executives to join in the
discussion…. As we got further into it,
the two high-tech executives began to
chime in with their views, which essentially amounted to a high-tech version of
“management by stress”—working people as long and as hard as they could
stand. It quickly became clear to the
group that these two did not have the foggiest idea of how to motivate or even treat
creative people, let alone build an effective
and enduring organizational culture.
(p. 142)
Part Three: Life and Leisure
In section three, composed of two chapters
“The Experiential Life” and “The Big Morph
(a Rant),” Florida goes deeper into how lifestyle and work intersect in the creative economy. In the first chapter, Florida describes the
kind of experientially rich communities and
workplaces members of the creative class tend
to choose. In the second chapter, Florida discusses the tension between the Protestant work
ethic and the bohemian ethic that the creative
class successfully embodies. While this chapter
is, indeed, a rant, it is also a good read:
122
What happened instead was neither sixties
nor eighties, neither bourgeois nor bohemian, but the opening of a path to something new. The great cultural legacy of the
sixties, as it turned out, was not Woodstock after all, but something that had
evolved at the other end of the continent.
It was Silicon Valley. This place in the
very heart of the San Francisco Bay area
became the proving ground for the new
ethos of creativity. If work could be made
more aesthetic and experiential; if it could
be spiritual and “useful” in the poetic
sense rather than in the duty-bound sense;
if the organizational strictures and rigidity
of the old system could be transcended; if
bohemian values like individuality—
which also happens to be a tried-and-true
all-American value—could be brought to
the workplace, then we could move
beyond the old categories. (p. 202)
It is worthwhile to note here that Florida
spends basically no time looking at how this
idealism contributed to the rise and fall of the
dot-bombs.
Part Four: Community
In this section, Florida talks about the importance of place to this demographic—and to
creative workand he talks about how a spirit
of tolerance acts almost as a cradle for creativity. He discusses creative class members’ preference for loosely coupled interpersonal
commitments rather than the tightly coupled
group affiliations of the previous generations’
sense of social capital and some of the implications of this change. This chapter may be the
most data-based in the book because he classifies hundreds of communities into Classic
Social Capital Communities, Organizational
Age Communities, Nerdistans, and Creative
Centers. Odds are, if you are living in a community of any size, you’ll find your community ranked in the related appendix. Even
Yakima, Washington, comes into the discussion.
In an industry where distributed and virtual teams are increasingly the norm, this focus
on place is particularly interesting. Many people have very strong feelings about the way
computer-mediated communication impacts
working relationships. In the section called
“The World of Weak Ties,” Florida states,
“Practically all of us have at least a few such
relationships. According to sociologists who
study networks, most people have and can
BEST PRACTICES • AUGUST 2003
BOOK REVIEW
manage between five and ten strong-tie relationships.” But, he counters, “weak ties are
often more important… research on social
networks has shown that weak ties are the key
mechanism for mobilizing resources, ideas,
and information, whether for finding a job,
solving a problem, launching a new product,
or establishing a new enterprise. A key reason
that weak ties are important is that we can
manage many more of them.” (p. 276—277)
This strategy of maintaining many weak ties to
facilitate creative connection is supported by
tools like contact databases, email, automatic
task reminder systems, and various remote
communication and collaboration technologies.
What If You’re Not
(Chronologically) a Kid Anymore?
Further, true to his creative class values, he
goes on to warn about emerging class divides.
America is far from a unified society….
The worsening divides in our society are
not merely a problem of social equity;
they are economically inefficient for the
nation as a whole…. Why, then, should
promoting creativity everywhere be a
main theme of our policies and our lives?
Why not focus on promoting some
attribute that seems to be more universally positive and beneficial—say, spiritual
growth, or civility? Wouldn’t that, over
the long run, make us better people who
can more wisely direct the creative
impulse that flows so naturally? My
answer is that of course, we should cultivate both of those virtues. But neither of
them is an economic force that increases
the resources with which we may do good
in the world. Creativity is. (p. 320—325)
Reference
The Rise of the Creative
Class: And How It’s
Transforming Work, Leisure,
Community and Everyday Life
Richard Florida
Basic Books
2002, New York, NY
ISBN: 0465024769
As the Biography page on Florida’s site at
CMU states, “He is widely regarded as one of
the most influential academics on the shift to
the new, knowledge economy and has spearManagers of knowledge workers in the current
headed national debates on industrial competieconomy, particularly managers of those worktiveness, high-technology
ers in high-tech companies, have
industries, and the globalization
seen their ranks drastically
of industry.” What about those
thinned. This downsizing is
“…those of us
of us over 35? While Florida conironic in the face of the compelcentrates on this demographic
ling argument that Florida details
who identify
through most of the book, the
in this book. But it is not surprisprimarily as
last chapter, “The Creative Class
ing when this book is read conGrows Up,” focuses on what
templatively.
writers have
needs to be done to ensure that
We knowledge workers, as a
never really
the creative class—the knowledge
class, don’t know who we are.
workers you may be managing
And those of us who identify pribeen able to
even now—is properly fostered
marily as writers have never really
characterize
in the US. Generally, building
been able to characterize our
wisdom seems to take time,
value to corporate America.
our value to
though the passage of time is far
Wherever there is a successful
corporate
from a guarantee of the developorganization, though, there are
ment of wisdom. The developwriters—perhaps they go by
America.”
ment of wisdom requires paying
other titles, but they are there.
attention, something that Florida
Preoccupied by our bohemian
believes this class of workers has
druthers, apologetic for our lack of eloquence
not done well.
in the face of bean counting skepticism about
our value, we bow and scrape by, often bowing
Vast numbers of Creative Class people are
out the door when the going gets tough for the
concerned mainly with building their
organization—never knowing that, increasresumes, building their bodies and acquiringly, we have spun the thread and woven the
ing the status kit of our age: a stylishly
cloth the corporation has made its expensive
renovated home with a Sub-Zero refrigersuit from.
ator, Viking stove and an SUV in the
I think Florida would point out downsizdrive. They naively assume that if they
ing
writers
as a critical lapse in business
take care of their own business, the rest of
sense—on
our
part, as much as the
the world will take care of itself and concorporation’s.
tinue to provide the environment they
need to prosper. (p. 316)
AUGUST 2003 • BEST PRACTICES
123
MANAGER’S CALENDAR
M A N A G E R ’ S
Please visit our Web site
<www.
infomanagementcenter.com>
for more information on these
and other events.
C A L E N D A R
ROI Competency Building
Workshop. August 21–22, 2003, Reston,
VA. September 2–3, 2003, Hampton, VA.
September 10–11, 2003, Nashville, TN. September 25–26, 2003, Alexandria, VA. Sponsored by the ASTD ROI Network.
<roi.astd.org/events/ROIWorkshops.aspx>
Minimalism: Creating Manuals
That People Will Use. August 26–27,
2003, Montreal, Canada. October 7–8, 2003,
Lexington, KY. November 6–7, 2003, Atlanta,
GA. Sponsored by Seminars in Usable Design.
Taught by JoAnn Hackos, PhD.
303-234-0123 <www.usabledesign.com>
Structured Writing for Single
Sourcing. September 9–10, 2003, Columbus, OH. September 16–17, 2003, San Jose,
CA. Sponsored by Seminars in Usable Design.
Taught by JoAnn Hackos, PhD. 303-2340123 <www.usabledesign.com>
Best Practices 2003 Conference.
September 22–24, 2003, Seattle, WA. Innovator’s Forum. September 25–26, 2003, Seattle,
WA. Sponsored by the CIDM.303-232-7586
<www.infomanagementcenter.com/
conference.htm>
Pacific Northwest Software
Quality Conference. October 13–15,
2003, Portland, OR. Sponsored by the
PNSQC. <www.pnsqc.org>
KM World & Intranets 2003
Conference & Exposition. October
14–16, 2003, Santa Clara, CA. Sponsored by
KM World. <www.kmworld-intranets.com>
Managing Your Documentation
Projects. October 16–17, 2003, Phoenix,
AZ. Sponsored by Seminars in Usable Design.
Taught by Bill Hackos, PhD. 303-234-0123
<www.usabledesign.com>
124
HITS 2003: Humans Interaction
Technology Strategy. October 16–17,
2003, Chicago, IL. Sponsored by the Institute
of Design. <www.id.iit.edu/events/hits/>
forUse 2003: 2nd International
Conference on Usage-Centered
Design. October 19–22, 2003, Portsmouth, NH. Sponsored by Constantine and
Lockwood, Ltd. <www.foruse.com/2003/>
Developing Online Information
for Help and Web-Based Delivery.
October 21–22, 2003, New Orleans, LA.
Sponsored by Seminars in Usable Design.
Taught by JoAnn Hackos, PhD. 303-2340123 <www.usabledesign.com>
2003 FrameUsers Conference.
October 27–29, 2003, Palm Beach, FL.
<www.FrameUsers.com>
Online Information 2003. December 2–4, 2003, London, UK. Sponsored by
Learned Information.
<www.online-information.co.uk>
Content Management Europe
2003. December 2–4, 2003, London, UK.
Sponsored by Imark Communications, Ltd.
<www.cme-expo.co.uk>
Information Technology for
Non-IT Managers. December 15–17,
2003, Chicago, IL. Sponsored by University of
Chicago Graduate School of Business.
<www.chicagoexec.net>
Knowledge Management
International Conference and
Exhibition. February 13–15, 2004, Penang, Malaysia. Sponsored by the School of IT,
Universiti Utara Malaysia.
<www.kmice.uum.edu.my>
BEST PRACTICES • AUGUST 2003