Palimpsest

Unmasking the lizards in tech comm

February 21st, 2012 by Alan Pringle

In the 1983 and 2009 versions of the TV series V, human-looking aliens visit Earth. It turns out those aliens are unfriendly reptilian creatures lurking beneath human shells. Of course, there are dramatic reveals that expose the aliens for what they really are.

In the world of technical content, the lizards in end users come out when they aren’t getting the information they need when they need it. Unhappy customers contact tech support (and subsequently drive up costs) or look for useful information from third parties (which means the official content failed).

To keep those lizards at bay, what can we do in tech comm? Well, we can start by strategically thinking about our content and how we deliver it—without framing the discussion as how Tool X can do this or Tool Y can do that. Sarah O’Keefe has said it a bizillion times, and I’m going to join the chorus: to do an honest assessment of your content, you need to step away from tools.

Just recently, I’ve seen and heard technical communicators immediately attempt to steer content analysis toward a particular tool or process with which they are comfortable. What should be an honest evaluation of the way information is created and distributed becomes a waste of time because writers jump on tools and start jockeying for position as if they were in a horse race.

By focusing immediately on tools, technical communicators do their customers a huge disservice. These communicators make the creation and distribution of content about themselves and not the end users.

That singular focus on tools reveals an inner reptile that reduces the effectiveness of content—and that diminishes the business value of the very services we technical communicators provide.


divider

Webcast: HTML5 and its impact on technical communication

February 16th, 2012 by ScriptoriumTech

In this webcast recording, guest presenter Peter Lubbers gives a fast-paced overview of HTML5 with a focus on how it affects the tech comm field. He covers what exactly HTML5 is, why you should care, and how you can develop with HTML5. The session covers which browsers support which features, and how you can make the new features work in older browsers so you can start using HTML5 today.


divider

Webcast: The Changing Role of the Professional Technical Communicator: What’s Next?

February 15th, 2012 by Sarah O'Keefe

In this webcast recording, Scott Abel, The Content Wrangler, and Val Swisher, CEO of Content Rules, host a lively discussion with technical communication industry professionals Jack Molisani and Sarah O’Keefe. The four discuss the impact of globalization, outsourcing, off-shoring, technological advances, and mobile devices on the technical communication landscape.




divider

Answer seven (or fewer) questions about ebooks to win $50

February 6th, 2012 by Alan Pringle

Recent news about two new ebook formats has made ebook distribution even more challenging for publishers. To gain some clarity on the market for ebooks about tech comm (and to keep ourselves from repeatedly banging our heads against the wall), we’re asking for your input on ebook editions and devices.

Ebook readers

Flickr: TheCreativePenn

Take our short survey, and you’ll be eligible to win a $50 gift certificate from amazon.com:

Ebooks survey

The survey closes on Friday, February 24, so respond soon. Thanks for your help!


divider

Webcast: Trends in technical communication, 2012

February 1st, 2012 by Sarah O'Keefe

In this webcast recording, Sarah O’Keefe and guest presenter Char James-Tanny discuss tech comm trends for the upcoming year and beyond. Topics include use of the cloud, help authoring tool innovation, business value, adoption of standards, shift to mobile, and more.


divider

“Trust me” isn’t a business plan

January 30th, 2012 by Alan Pringle

Knowing you can rely on someone is vital to professional relationships. But when it comes to proposing process change, the words “trust me” are never, ever enough.

For those of us in technical communication, process change often involves selecting new tools and technologies to make creating and distributing content more efficient. If you want to propose changes to your content processes, you need some compelling numbers to back up what you’re suggesting.

Don’t assume that your positive relationships with coworkers and management will guarantee a warm reception to your ideas. Yes, those relationships can help you get your foot in the door to introduce your ideas, but proposing changes without a solid business case can quickly tarnish good relationships. People don’t like having their time wasted—even by good intentions.

Photo of human pyramid

Flickr/notsogoodphotography

Boost your chances of having your proposal heard and considered by doing some research. Provide answers to tough questions such as:

  • How much time and money will be saved by the content reuse enabled by the new system?
  • What kind of savings will be achieved in automating formatting for the source language and localized content?
  • How long will it take to recoup the cost of the new system?

Even if your proposal is shot down or put on hold because of corporate belt tightening, developing a strong business case demonstrates you have an understanding of your workplace that reaches beyond writing content. That kind of analytical thinking benefits your employer and—more importantly—your career.

Trust me!


divider

Another peril in ebook publishing: Amazon KF8 compatibility

January 24th, 2012 by Alan Pringle

KF8. Nope, it’s not K2‘s long-lost mountain cousin. It’s Amazon’s new ebook format.

While dealing with this new format probably isn’t as daunting as scaling a 28,251 ft. mountain, KF8 is providing a particularly bothersome challenge right out of the gate: it’s not compatible with any Kindle devices other than the Kindle Fire!

Scriptorium Press has already released Kindle editions of Technical Writing 101 and The DITA Style Guide in the AZW format, which is basically a highly compressed MOBI file. Because we have published books in the older format and because I own an e-ink Kindle model that predates the Kindle Fire by a few months, I immediately wanted to know which devices could handle the new KF8 format.

While researching compatibility, I noticed how Amazon’s carefully worded overview of KF8 attempts to skirt the issue: “Kindle Fire is the first Kindle device to support KF8 – in the coming months we will roll out KF8 to our latest generation Kindle e-ink devices as well as our free Kindle reading apps.”

 Still from The Perils of Pauline (1947)

Still from The Perils of Pauline (1947)

This fancy footwork wasn’t lost on writer Guido Henkel, either, who pointed out:

One of the issues that truly and really disturbs me is the lack of support on anything but the Kindle Fire. Although Amazon had initially announced that the current generation Kindles and software readers would be KF8 capable, that statement was simply not true. It has since been revised that these devices will support KF8 some time in the future. In the real world that is a big difference.

In a blog post yesterday, Sarah O’Keefe pointed out how the release of Apple iBooks Author is contributing to the growing pains in the digital publishing industry. The release of KF8 is adding to those pains as well. In fact, Amazon has compounded the challenges by releasing a format that currently doesn’t work across its own Kindle family. I hope Amazon resolves questions about backward compatibility very soon. (Are firmware updates for e-ink models on the horizon, perhaps?)

Like Sarah, I have doubts that the big ebook distributors will graciously adopt a standard such as EPUB to make the lives of both publishers and readers easier. There’s not as much money to be had in adhering to standards. As a result, Scriptorium Press and other publishers will have to figure out how to keep their source content in a neutral(ish?) format that is easily converted to the ebook formats the distributors require. (By the way, we keep our source files in DITA. We transform the files into EPUB, which we sell, and we also use Amazon’s free KindleGen tool to convert the EPUB into the Kindle format.)

Stay tuned for another installment in The Perils of Ebook Publishing! I suspect there are many, many installments to come.

Thanks to Keith Soltys, whose blog got me thinking about KF8 and its impact.


divider

The dawn of digital publishing

January 23rd, 2012 by Sarah O'Keefe

Is a week long enough to gain some perspective on the new landscape in ebook publishing?

If 2010 was the Year of the Many Datasheets, 2012 is looking like the Year of the EBook. We are getting numerous inquiries about how to change publishing processes to accommodate the new requirement to deliver content for EPUB and Kindle. (The Year of the Process Change Driven by New Digital Requirements may be more accurate, but it just doesn’t flow trippingly off the tongue.)

There’s been plenty of technical discussion on other sites of the major new developments: the new Kindle format, the new Apple toolset, and, especially, the licensing restrictions attached to Apple’s new iBooks Author.

[Update: A discussion of the technical problems and why it matters from ZDNet]

Cave painting, Algeria

The artist was probably criticized for the monochromatic palette.

These are all valid issues, but they miss the larger point. We are at the dawn of digital publishing. We have a long way to go before we master our new medium.

Like the cave painters, we face enormous technical challenges (them: creating a color palette; us: creating valid EPUB or Kindle formats), archival issues (them: humidity and cracking stone; us: evolving incompatible formats), and new frontiers (them: mastering the illusion of perspective; us: employing effective 3D images).

iBooks Author provides an interesting sandbox for experimentation for publishing professionals, but no more. The current iBooks Author license only allows you to sell through the iBooks store if you develop in iBooks Author. In addition to this silly limitation, the ebook file produced by iBooks Author is not a valid EPUB; the code is full of proprietary extensions.

So what was Apple thinking when they released a beautiful, free MacOS-only application that produces ebooks for iBooks only?

This is about Amazon.

Apple is strong in education and design. Amazon’s Kindle format is doing well in ebooks and particularly cheap, self-published ebooks. Apple, as usual, is going after the high-end, high-margin market: textbooks.

They are attempting to tie up the following:

  1. iPad as a consumption device for textbooks.
  2. iBooks Author to create textbooks.
  3. iBooks Store as the textbook marketplace

“But why would a publisher agree to this? We have to publish to lots of different formats.”

Close-up of Sistine Chapel fresco

Detail from the Sistine Chapel

The publishers are not the target audience for this new approach. The target audience is textbook authors—educators who already live in a MacOS/iPad universe and have no interest in other technologies. Apple’s intent is to eliminate publishers from the equation and pick up those teachers or professors who want to create one textbook for their particular area of expertise. Apple is providing tools that are simple enough for a non-professional content publisher, and that could create high-quality results. (I’m reminded of the release of PageMaker 1.0, which was also quite limited but at the same time revolutionary.)

The negative coverage of the technical details misses the point. Apple is attempting to disrupt the textbook market by:

  • Providing software for content creation that will be compelling to the average textbook author.
  • Providing a venue for distributing content that will be compelling to the average textbook author.
  • Providing a way to produce digital content that will be compelling to the textbook user.

Apple will probably eliminate the licensing restriction within a few months—the format being created won’t render properly in other ebook readers anyway. Don’t expect them to conform too closely to the EPUB specification, though. Making an incompatible format is a competitive advantage.

Will it work? I refer you to the great Browser Wars of yesteryear for a historical (!) context. Back then, the open source movement wasn’t as strong as it is today, though.

I await new developments from Amazon.

What are your thoughts?


divider

Webcast: Content strategy in technical communication

January 20th, 2012 by Sarah O'Keefe

In this webcast recording, Sarah O’Keefe explores how to develop a content strategy specifically for technical content. That means stepping back from the temptation to focus on tools and instead taking a hard look at what the users need and how best to deliver it.


divider

Tempus fugit

January 17th, 2012 by Sarah O'Keefe

I’ve been thinking about how time affects communication. We have constant deadlines, some of which are easier to meet than others. But there are other ways in which time affects content strategy.

Language usage evolves

Today, I can write:

Like the Euro, this [anything] is in deep crisis.

I am confident that my readers will understand the analogy. But ten years from now, the Euro may be back on track (or gone). A reader in 2022 must then recognize that this sentence was written in 2012 to put it in the proper context. It’s likely (unfortunately) that the Euro events will be remembered in 10 years, but what about something like this from Twitter:

@lizzwinstead I would like to see the answer translated into the Kardashian unit of time measurement.

— Melissa (@jamrockstar) January 9, 2012

We use pop culture references because they are entertaining, but they are also obstacles to content longevity.

Language evolves

Language changes over time, and our word choice, even without obvious pop culture references, ties our text to a temporal frame of reference. Take, for example, the word “provisioning.” (Yes, it’s a horrible word. Sorry.)

My most recent encounter with “provisioning” was in the context of digital magazine publishing. My mental model is now that provisioning refers to the process of supplying a user with magazine content based on her subscription status and/or one-off purchases. However, I had trouble finding examples of this definition. For example, Wordnik’s examples for provisioning are mostly in telecommunications and finance:

“It is hard to envisage duct access providing both Carphone and Sky with even half of their long-term provisioning requirements.”
Latest financial, market & economic news and analysis | guardian.co.uk

[...]

“BBVA said it had to set aside an extra € 198 million as a result of the change in provisioning rules.”
The Wall Street Journal: Financial Briefing Book: Oct. 28

But scroll down the page to the Twitter examples, and you see something different:

das iOS Provisioning Portal darf ruhig mal von einem apple usibility team unter die lupe genommen werden.”
@nordpixel

“Guh, somehow Xcode nuked all my provisioning profiles.”
@jstr

“Блин, в iTunes Connect черт ногу сломит – уже минут 40 пытаюсь вспомнить где находится управление provisioning профилями. Безрезультатно.”
@KirkFawkes

Here, the usage for “provisioning” is all about telecommunications and a little bit of iOS.

From there, I backtracked to Wikipedia:

In telecommunicationprovisioning is the process of preparing and equipping a network to allow it to provide (new) services to its users. In NS/EP telecommunications services,“provisioning” equates to “initiation” and includes altering the state of an existing priority service or capability.[1]

There is also a reference to mobile content provisioning later in the article, but this turns out to be quite a different definition from what I expected:

This refers to delivering mobile content, such as mobile internet to a mobile phone, agnostic of the features of said device.

Finally, I consulted the Oxford English Dictionary:

The supplying, stocking up, or making of provisions; the action of provision v.
1787    A. Hawkins tr. V. Mignot Hist. Turkish Empire I. 306   His opposition in the council to the provisioning of Rhodes [Fr. le conseil à ce que Rhodes fût approvisionnée] when war was not yet declared‥had raised suspicions.
None of the OED examples are related to technology; instead, they reflect the military usage where this word originated.
I conclude that “provisioning” for digital content is a new usage of the term, which means that I probably need to explain it in any content that I’m creating. And that brings me to a third issue.

The reader evolves

In the early days of graphical user interfaces, it was quite common to include basic information about mouse operation in technical documentation manuals. When was the last time you saw something like this in technical content?

http://tech.tln.lib.mi.us/tutor/intro4.htm

The baseline assumptions we make about audience knowledge have changed. Knowledge that starts out as highly specialized (like my unorthodox definition of “provisioning”) may, over time, become general knowledge. Consider the evolution from “smartphone application” to “mobile application” to “mobile app” to just “app.”

This implies that we can, over time, remove information from our content. Phone companies do not explain the concept of an area code. Actually, it’s worse than that. AT&T’s instructions do provide a link in case you don’t know what an area code is:

Let’s assume you need further explanation of “the area code” above. This is what you get:

Uh, thanks? I don’t think this is going to help someone who doesn’t know what an area code is. So, I did what we all do and tried a Google search for “what is an area code?” and got this at position #3, from WiseGeek:

An area code is a section of a telephone number which denotes the broad area that the phone receiving the call is based in. The area code is the section just before the local number, and just after both the access and country codes. An area code usually doesn’t need to be dialed if the number being called is in the same area as the number making the call, unlike the local number, which must always be dialed in its entirety.

In the United States, an area code is a three digit number that comes before the seven digits that make up the local number, three for the prefix and four for the suffix. While the prefix of the local number gives an idea of the more specific area, such as town or neighborhood, the areacode denotes the larger region, either a whole segment of a city, or even an entire county of part of a state.

Once again, unofficial third-party content wins. But I digress. The point, as always, is that you need to know your audience. The category of “people who don’t know what an area code is” do not need a technical discussion of the finer points of area codes. They need a clear explanation of (what we consider) basic phone number concepts.

What information is in our content today that will be irrelevant in a few years because it will have become general knowledge? Can we identify that information ahead of time? How do we plan for information decay?


divider

Tech comm problems? Contact us.
Effective October 27, 2011, our physical address is changing to 2327 Englert Drive, Suite 206, Durham, NC 27713
Scriptorium Publishing | Post Office Box 12761 Research Triangle Park, NC 27709 | (919) 481 2701 | info@scriptorium.com