Leximation releases DITA-FMx 1.0

Leximation, Inc. has announced that the DITA-FMx 1.0 plug-in has been released. This plug-in improves upon the DITA support provided with FrameMaker 8, including increased coverage of the DITA specification and improvements to the authoring experience.

The DITA specification presents rather steep challenges to tool implementers. The Leximation plug-in further enhances FrameMaker as an option for DITA authoring and publishing. Given the complexities of XSL-FO for generating PDF output, and the recent uncertainty regarding PDF support in the DITA Open Toolkit, FrameMaker should be especially appealing for organizations that need high-quality PDF output from DITA.

The DITA-FMx 1.0 plug-in supports DITA version 1.0. Support for DITA 1.1 is forthcoming, and will be provided at no charge to those who purchase DITA-FMx 1.0.

Comments

Microsoft patch for infamous FrameMaker/PDF bug

Some users of FrameMaker on Windows XP and Vista (including myself) have been vexed by FrameMaker crashes while generating PDF files, and generated PDF files with missing text (not good). The problem appeared to be random, affecting some systems but not others, and some documents but not others.

The workaround (until now) has been to delete the file “C:\WINDOWS\system32\FNTCACHE.DAT” and reboot. Many FrameMaker users would delete this file regularly, and some did so automatically through a shutdown script.

Mahesh Gupta, Product Manager for Adobe FrameMaker, reports that Microsoft has patched the underlying font management issues that have caused these problems. His post in the Adobe Technical Communication blog provides details of the Microsoft patch.

And there was much rejoicing among FrameMaker users!

Comments (2)

Adventures in Beijing, Part II

In the late 1980’s, I had a work-study job as a computer operator in the School of Computer Science at Carnegie Mellon University (B.S.E.E. 1987, M.A. 1989). That meant keeping the systems operating and loading backup tapes. Lots of backup tapes. One of the projects I supported was a speech recognition effort led by a Carnegie Mellon PhD graduate and assistant professor named Kai-Fu Lee.

Shortly thereafter, I took a staff position there in the research documents group, which was tasked with telling the U.S. Government (primarily DARPA) what we accomplished by spending their money. Again, Dr. Kai-Fu Lee’s project was among those that I supported.

Twenty years later, I find myself in Beijing at the WWW2008 conference, in the audience at the opening keynote, delivered by Dr. Kai-Fu Lee (now Vice President of Engineering at Google). I think it says something about my career that I’m now half-way around the world, attending a keynote by Dr. Lee. Exactly what it says, I’m not sure.

Dr. Kai-Fu Lee at WWW2008

Comments

Adventures in Beijing

Last week I had the privilege of representing the Society for Technical Communication at the semi-annual meeting of the World Wide Web Consortium (W3C) Advisory Committee, this time in Beijing. As a W3C member, the STC participates in W3C governance. Perhaps more importantly, the STC can place members in W3C member-only roles, like participation in W3C working groups. There is substantial interest by the W3C in increasing the participation and support of the STC in its standards development and communication activities.

The W3C is working on standards in several important and exciting areas, including accessibility, mobile devices, the next generation of HTML, and the next generation of the Web itself, the Semantic Web. Leaders from each of these areas are interested in support for drafting specification documents (the W3C calls them Recommendations), and for writing and editing supporting documents to explain W3C Recommendations to appropriate audiences.

More on that later. Until then, a picture (me at the Great Wall, Mutianyu section):

Alan Houser at Great Wall

Comments

Events: Annual European Tour

I enjoy a journey to Europe once or twice a year, and this year is no exception. Over the next two weeks, I will be participating in several events:

  • The annual tekom/TCWorld conference takes place again in the beautiful German city of Wiesbaden, November 7-9. I will be presenting two sessions, Using DITA with FrameMaker, and Developing DITA Maps. This is my third visit to this conference.
  • I am privileged to visit Manchester England on November 10 and 11. I will be supporting the STC UK chapter wth a two-day workshop on DITA, DITA authoring tools, and the DITA Open Toolkit. Participants will have the opportunity to use two popular DITA authoring tools (FrameMaker and XMetaL), use the DITA Open Toolkit for publishing, and develop DITA specializations. Participants will receive a free copy of Mif2Go, a wonderful multi-purpose conversion utility for FrameMaker documents. Mif2Go has recently added unstructured FrameMaker-to-DITA conversion support.
  • November 13 - 14 brings me to Brussels for the annual DITA Europe conference. This is my first time at DITA Europe, but JoAnn Hackos always runs outstanding events. I will present on DITA Rapid Prototyping with the IBM Task Modeler. This is one of my favorite techniques with one of my favorite (and under-publicized) tools, the IBM Task Modeler.

Registration for each event is still open. If you are in Europe and are looking for a relatively low-cost training experience, I especially recommend the STC UK DITA workshop. As usual, I look forward to seeing many of my “virtual” colleagues in person at these events.

Comments

Adobe/Macromedia Synergy for Technical Communicators?

Adobe CS3 Master Edition BoxI was originally skeptical of the Adobe/Macromedia merger. I saw another case of a larger company buying a smaller company purely to stifle competition, usually by killing those pesky competing products. Promises of greater synergy that usually pepper the press releases associated with these mergers are usually unfounded.

Not quite two years later, I’m a convert. I just received my copy of the Adobe Creative Suite 3, Master Collection. This package includes the key Adobe and former Macromedia products for image production, vector-based illustration, layout-intensive print production, Web content development, Flash authoring and production, as well as video and audio editing. Twelve major products in all, plus some ancillary goodies.

It’s notable that Adobe has chosen to maintain and improve Dreamweaver over GoLive. To call Dreamweaver a Web authoring tool is a massive understatement. Perhaps Web development environment is more appropriate. Dreamweaver was always a step or two (or three) ahead of GoLive in feature set and capabilities, and Adobe made the right choice here.

It’s all here — in on package, one installer. I suspect it’s not lost on the Adobe bean-counters that the cost of this suite is comparable to the cost of a computer with the required hardware to run it. Separately, however, the cost of these products would be several times that of the suite price.

I see similar synergy in Adobe’s technical communication products. FrameMaker for conventional and XML-based authoring and publishing, RoboHelp for online help development, Captivate for animations, tutorials, and simulations, and Acrobat for review, collaboration, approval, and distribution. Adobe can now cover a wide range of capabilities for technical communicators. And Adobe product managers are speaking of increasing cross-product integration. It will be interesting to see where this goes.

Comments (5)

Adobe Technical Communication FAQ comes to Fruition

On July 23, Adobe announced the release of FrameMaker 8, which began to ship a week later. New features of FrameMaker 8 include Unicode, DITA, ability to embed “active” Flash and 3D objects in PDF, text-edit tracking, improved conditional text support, and attribute-based filtering. A review is available here.

In a first for Adobe, the company had provided some prior information about this release of FrameMaker. In the Adobe Technical Communication FAQ (PDF version), Adobe stated that “our [Adobe’s] current assumption is that the next major release of FrameMaker will be in the first half of 2007.” Given the complexity of the FrameMaker application and of software development in general, missing this target by a month isn’t too shabby.

Adobe posted the Technical Communication FAQ in July 2006. This action was very highly unusual — Adobe usually holds plans for new product features and release plans in extreme secrecy. However, at that time Adobe was facing market skepticism over its revival of Robohelp, as well as lingering rumors about the future of FrameMaker. The Adobe FAQ, and Adobe’s execution of the plans it outlined, have helped to assuage this skepticism.

Technical communication tools development has been relatively stagnant for the past several years. These are exciting times for technical communicators, with renewed activity (and competition) in the tools development space. Let’s hope that Adobe (and other tools vendors) will continue to share some of their future plans with us.

Comments

Tale of the Type(face)

If you enjoyed the film Helvetica (or at least find it interesting that somebody produced a documentary about a typeface), you may enjoy The Road to Clarity in the Sunday, August 12 New York Times Magazine section (registration required). The article tells the story of the development and current deployment of Clearview, a new typeface designed specifically for highway signage.

Central to the story is how typographic details like counter shapes (the closed spaces inside lower-case a, e, and o) and x-height (the height of the lower-case x) can have a profound effect on readability under real-world highway conditions (e.g., distance and darkness).

In user tests, signs that were legible at 700 feet in the current standard signage typeface, Highway Gothic, were readable in Clearview at 900-1,000 feet.

Thus far, 20 U.S. states have adopted Clearview, and are deploying the new typeface as current signs are replaced.

Comments (1)

Usability Profession Featured in New York Times

I was pleased to see the usability profession featured in this morning’s New York Times. See Technology’s Untanglers: They Make It Really Work (New York Times, Sunday, July 8, 2007). The article appeared in the Times’ Fresh Starts, a monthly column about “emerging jobs and job trends.”

The (quite positive) article includes several quotes from usability legend Ginny Redish. Watch this space for a review of Dr. Redish’ most recent book, Letting Go of the Words: Writing Web Content that Works.

Comments

Choosing a Technical Communication Conference

I attend (and present at) a lot of conferences. They are a great way to stay on top of what’s going on in the field, a great way to find out what’s new in tools and technologies, a great way to meet people who are doing interesting things, and a great source for new ideas to bring back to your workplace.

Technical communication conferences tend to be clustered in the early and later parts of the year (I’m avoiding the terms “Spring” and “Fall” in deference to readers in the southern hemisphere). Sometimes too clustered. In a five-week stretch in October and early November 2007, there are six potential conferences on my calendar. At least none overlap directly.

Each conference has its own strengths, its own flavor, its own personality. The following are several of the ones at which I’ve presented and participated in the past year or two, along with a few observations.

WritersUA

This may be my favorite of all technical communication conferences. It draws a substantial crowd (more than 400); enough to feel like a major-league event. Although the conference draws all experience levels, senior writers and managers tend to be well-represented. The sessions are hand-picked by the conference organizer, Joe Welinske, and the material is top-notch. Another interesting twist: Joe does not allow presentations by tools vendors. If you are hearing a presentation about a tool, be assured that it’s being delivered by a practitioner, not the tool’s product marketing manager.

WritersUA does all things well, and some things exceptionally well. Attendees receive bound volumes of hand-outs for all presentations at the beginning of the conference. You can use the hand-outs to decide which sessions to attend, take notes on the hand-outs, and read the materials from the sessions that you miss. WritersUA is also particularly effective at evaluating speakers, sharing those evaluations with the speakers, and using the results of the evaluations to shape future conferences.

WritersUA is usually held in March or April. The 2008 WritersUA conference has not yet been finalized. (Update, 19 June 2007: WritersUA 2008 has been scheduled for Portland, Oregon, March 16-19 2008).

Cons: Fewer vendors than I would like to see at an event of this size. However, all of the major tools vendors (Adobe, MadCap, ComponentOne) are represented in the exhibit hall.

DocTrain

If you want to know what’s next in our field, this is the place to go. Web 2.0, content management, folksonomies, wikis and blogs feature strongly in the program. A mid-size conference (150 - 200 people). An impressive exhibit hall for a conference of this size. The next DocTrain is scheduled for my former home of Lowell, Massachusetts, October 16-20 2007.

Cons: The conference organizers practice what they preach — even the speaker evaluation process is through a Web 2.0 site. Unfortunately, the evaluation process exhibits the classic downsides of Web 2.0. You must register at the site to leave an evaluation. Evaluations are heavily represented by conference insiders. Poor evaluations are available for the world to see. And the number of evaluations submitted was relatively small. If it weren’t for a glowing mention of my Information Modeling workshop in one of Tom Johnson’s podcasts, I would have no feedback about how my workshop was received.

Society for Technical Communication

The largest technical communication conference in the Western Hemisphere, perhaps in the world. It’s a big show with a big exhibit hall in a big venue, either a large conference hotel or a convention center. The 2007 Summit in Minneapolis drew nearly 1500 people. If you want maximum choices and maximum sensory input, this is probably the place for you. The 2008 STC Conference is in Philadelphia, Pennsylvania, June 1-4.

(Update, 19 June 2007: Germany’s Tekom tcworld event claims the title of largest technical communication conference in the world, with 2400 attendees. See below for my Tekom observations).

Cons: In past years, the STC conference tended to serve the needs of beginning to intermediate-level technical communicators. That changed substantially this year, with more high-profile speakers and more advanced topics. It’s a big conference, with many choices (often 12 concurrent sessions). Some people will like this, others might prefer a smaller event. The conference is also run by a committee, and this sometimes shows. However, I think the committee did a very good job this year (full disclosure: I served on the 2007 STC conference committee, and will do so again for the 2008 conference in Philadelphia).

Lavacon

A relatively small conference, targeted to the professional needs of very senior technical communicators and documentation managers. If you spend much of your day doing cost/benefit analysis, need to increase the efficiency of your technical communication department, or need to trim your translation budget without sacrificing quality, this is the conference for you. Not a large crowd, but a good crowd to be part of. The next Lavacon is scheduled for New Orleans, Louisiana, October 27–30, 2007.

Cons: You won’t be listening to the keynote speaker in a packed auditorium with hundreds of other people. A relatively small event, but a very high percentage of managers and senior technical communicators.

Tekom

Tekom is a Germany-based professional organization of technical communicators. I’ve been privileged to participate in this conference the previous two years, and will be traveling to Germany again for Tekom’s tcworld 2007 event. Decision-makers in the STC would do well to look at what Tekom has done to promote the profession to German industry, to provide services of value to industry (like certification) and to make money hosting conferences (hint: the exhibit hall is really impressive).

Cons: It’s in Germany, which is actually a tremendous “pro” if you live in North America and can swing the trip. Although there is a substantial English-language track, more than half of the presentations are in German.

FrameMaker Chautauqua

My first conference speaking experiences were at the old FrameUsers conference series in the late 1990s and early this decade. The FrameUser conference series has folded, but FrameMaker Chautauqua has taken its place. A relatively small event, but still the place to go if you want to learn and use FrameMaker more effectively.

The next FrameMaker Chatauqua is scheduled for October 22-24, 2007, in Raleigh, North Carolina.

Cons: The 2007 conference is scheduled to be held in a college conference center, and area hotels are somewhat scattered. This somewhat limits the ad hoc networking that happens in restaurants and bars at the conference hotel. If you want to connect with colleagues in the evening, after the day’s events, you need to do a bit of coordinating.

Honorable mention

CIDM

This is an excellent conference series, hosted by JoAnn Hackos’ company. The CIDM conferences feature sessions on content management, best practices, and DITA. I last attended several years ago. Unfortunately, the 2007 CIDM/DITA conference conflicted directly with WritersUA.

DITA 2007 - East

A small conference that appears to attract many top names in the DITA field. Although I participate in the DITA Technical Committee, I have not yet personally attended a conference in this series.

XML 2007

My favorite “general” XML conference. Although the conference has drifted away from its publishing roots in past years, the 2006 event re-introduced a dedicated publishing track. This conference is usually held in the Northeast U.S., nearly always in November or December. XML 2007 is scheduled for Boston, MA, December 3 - 5. Boston is very pretty, and a lot of fun, near the holiday season.

Comments (5)

« Previous entries