DocTrain News & Announcements

Firefox Book Sprint: From Zero to Book in Two Days

2009-03-07T21:00:32+00:00

You are invited to join the Documentation and Training West Conference as a writer in the Firefox BookSprint. Don’t worry, you don’t have to be physically at the conference to participate. You can work remotely, via internet, email and telephone. In return, you’ll learn about writing in a collaborative authoring environment (a wiki), discover the FLOSS Manuals toolkit, participate in a single sourcing/topic-based authoring project, and share your knowledge of Firefox and web browsing so that others may benefit from using free documentation to learn about free software.

Each on-site writer brings his or her own laptop to the sprint. Remote writers will utilize their own laptops or workstations. Since the FLOSS Manuals tool is completely web-based, it does not matter if you use Windows, OSX, or UNIX. The key here is that your participation matters. We have set up the online tools so you can contribute from anywhere around the world.

The outline for the Firefox manual will be completed prior to the Book Sprint, offering a scaffolding for the book. We have gathered documentation wants and needs from the Firefox team and a real book will be available by the end of the two-day Sprint.

The support team consists of members of FLOSS Manuals writing community with Adam Hyde, the founder and Janet Swisher leading this workshop-style event. Chris Hofmann, Director of Engineering at the Mozilla Foundation is joining us as well. Anne Gentle will be participating from her home office in Austin.

To contribute you must register and then select a manual and a chapter to work on. if it is not marked ‘complete’ then press the edit button! It’s as simple as that. Contributions can include cleaning up layout, spell checking, adding images, proof reading, or taking responsibility for writing one of more chapters. You don’t have to be a technical writer or a super geek, you just need to know how to write.

If you need to ask us questions about how to contribute then just ask us. We look forward to your contribution!

Get more information on using FLOSS Manuals.

Escape the Freezing Grip of Winter in Palm Springs, California

2008-12-30T21:48:46+00:00

This year’s Documentation and Training West conference is being held March 17-20, 2009 in majestic Palm Springs, California at the Westin Mission Hills Resort and Spa. Nestled in the heart of the Coachella Valley and set on 360 acres within the Rancho Mirage community, the Westin Mission Hills is surrounded by landscaped courtyards and extensive waterways. The Resort is a premier meeting place with extensive indoor and outdoor venues, two world class golf courses, spas, pools, and is located just moments away from a myriad of famous Palm Springs sights and attractions including shopping, dining and casinos, nature trails, art museums, live entertainment, dancing, and more. And of course, there’s the beautiful weather.

Looking at the Real Cost of Quality

2008-10-29T08:12:11+00:00

When a lot of communication is compromised by being squeezed into 140-character Twitter posts or thumbed into text messages, creative spelling is considered, in some circles, de rigeur. Not in the know? If you need help reading “AMOF, Im OTW where its BAU. Feeling IOMY so IG2R”, relax, there is a dictionary.

These shortcuts do have their consequences, though. Talk to any lawyers, and they’ll tell you the implication of a misplaced comma. It can be expensive, as Roger’s Communications found out the hard way, when a lucrative contract was able to be ended several years early. Or it can be expensive and embarrassing, as well. Just ask tattoo artists Sam Hacker and Alfonse Wingfield, whose misspelled client tattoos netted them lawsuits.

Andrew Bredenkamp of acrolinx has made it his business to understand the many ways that the cost of quality can save a corporation money, and a lot of pain - and every second Thursday, acrolinx offers a seminar that demonstrates the various aspects of language consistency and other aspects of quality. In that same vein, Bredenkamp presents No Metrics, No Quality: Know Metrics, Know Quality! at DocTrain East 2008.

Speaking To - No, Make That With - Your Audience More Effectively

2008-10-29T08:11:57+00:00

It’s been seven years since the publication of the pivotal book, The Cluetrain Manifesto, where the idea of marketing as pushing a message was replaced by the core hypothesis that markets are now conversations between people wanting to quickly share relevant knowledge. The idea that corporations need to engage in a conversation with their customers and potential customers with an authentic voice became an important concept for online communication, in general, and paved the way for much of the work done since then.

This idea has been developed by others since, notably in the book Naked Conversations, which demonstrates how communicating with an authentic voice is critical to success, whether yours is a micro-business or one of the largest technology corporations in the world. One of the big differences today is the new technology facilitating those conversations, and the variety of applications that are available.

David Esrati of The Next Wave understands the connection between blogging, blogging technology, and authentic voice. His own blog, Websiteology, is wealth of information on about the how to - and how not to - of blogging. Billed as a seminar on Web 2.0 for those still struggling with Web 1.0, it has information for bloggers of all levels.

David presents Blogzilla: Why Blogs Are The Monster In The Business Closet: You Are No Longer In Control Of Your Brand at DocTrain East 2008.

Localization Isn’t As Straightforward As It Seems

2008-10-29T08:07:22+00:00

Selling into new foreign markets is usually an exciting prospect for marketing departments, but when the realities of localizing the marketing or technical material hit home, the excitement can turn to panic.

A common misperception is that the vendor can translate what they choose, and by simply hiring someone to translate text into the target language, they’ll be ready to do business. The reality is that professional translation agencies understand the ins and outs of the customs and regulations in various languages and countries. These regulations can get quite complex, and when localization is being done in multiple languages, the permutations and combinations can get out of hand if not properly managed.

To see how a properly managed localization project brings value to an organization, read some of the case studies published by McElroy Translations.

McElroy’s Bob Donaldson presents Theory of Constraints and Project Management: Challenging the Dominant Paradigm at DocTrain East 2008.

Localization Begins at Home: Translating for a Domestic Market

2008-10-28T19:03:58+00:00

Watching the 2008 Olympics in Beijing was, aside from a compelling series of sports events, is also an interesting exercise in the art of localization. As China hosted athletes from over 200 countries, the localization requirements boggle the mind. The Chinese translated signage into the second most common language in the world, English, to make certain that visitors to their country could navigate without the need for a translator. Recognizing that visitors would have trouble reading Chinese signage and understand Chinese instructions was, no doubt, a major factor in localizing material used by tourists and Olympic participants. Being welcoming hosts is an important aspect of Chinese culture.

Likewise, the important of localizing in a domestic market the size of the United States is becoming more important. Demographic trends are pointing to localization as a phenomenon not just for companies doing business in foreign markets, but also for companies doing business at home. Doing an internal audit can be illuminating. For example, an organization that translates only negative messages such as “Wet Floor” and “Shoplifters Prosecuted” sends a very different message than an organization that translates the value-added messages, as well.

To learn about the strategic, as well as technical, side of localizing content, visit the ENLASO Language Center Resource Center for a range of educational resources, from webinars to white papers to case studies.

John Watkins, president of ENLASO, understands the nature of product marketing in a changing domestic consumer market; he presents Reaching Untapped Markets in the US at DocTrain East 2008.

Tools for All: Streaming Language Production

2008-10-05T02:05:05+00:00

If you’re in a smaller company, you’re used to taking a pass on many of the tools and technologies designed to create work efficiencies, no matter how cool, developed by companies that think of scalability in terms of “upward from large to huge”. The good news is that now, smaller companies can take advantage of at least one of the tools that larger companies take advantage of on a routine basis. Across Systems, a developer of translation management software, has developed Across Personal Edition, a standalone application for smaller companies and freelancers.
The importance of extending the potential of streamlining the delivery of translated content has been important to Armin Wahl. He recognizes that the potential of the corporate asset called “content” needs to be available across the board, from multinational corporations to the independent translators hired to service them.

Information about Across Personal Edition, as well as white papers and webinars can be found on the Across Systems site. Wahl, with Across Systems, presents Global Sales in Local Languages: Streamlining Language Production at DocTrain East 2008.

SDK and API Documentation: A Technical Niche

2008-10-05T01:56:07+00:00

One of the techniques to ensuring job security is to specialize in a niche writing area. Creating SDK (Software Development Kit) documentation is one of those areas with seemingly limitless growth. As the drive for a social experience increases, the need for various software applications to inter-operate also increases. Companies are being asked to release their APIs (Application Programming Interface) so that developers of other applications can develop software for their platforms.

Writing in this area takes more than good writing skills. Before developers allow a writer to have access to their code, they want to be sure that the writer understands the importance of what this access means. Writers who can demonstrate an understanding of the landscape have a distinct advantage; the trust factor that the writer can think like a developer to describe the code, and who will not inadvertently create chaos in the code library ensures ongoing access.

Want to be part of the SDK club? Attend Ed Marshall’s session on Breaking into and Succeeding in the API and SDK Specialty Market at DocTrain East 2008.

Multi-channel publishing with Adobe’s Technical Communication Suite

2008-10-04T05:05:44+00:00

More often than note, content is not a single-use commodity. Content is resource-intensive to produce, and it makes good business sense to re-use content wherever possible. This means creating portable content that is able to be integrated with other content, to create a new message each time the content converges in a new constellation. Ask Donna Reynolds, whose articles on the How To Do Things site are not only re-used in multiple categories on the site, they are syndicated to other sites.

Reynolds understands content re-use in the technical arena, as well. She was instrumental in helping implement a single-source solution for technical documentation and training content for a medical device corporation. To learn about Reynold’s team used the Adobe Technical Communication Suite to re-use their corporate content assets to their utmost potential, attend her session, where she presents a case study, How Suite It Is, at DocTrain East 2008.

Training Methods Affect Effectiveness

2008-10-03T18:34:02+00:00

Knowing how to enumerate the benefits of training content and knowing how to go about implementing a training project are two very different kettle of fish. As with any project that involves a technology component, there are multiple ways to handle each aspect. Each organization has different needs, and so will want to derive different benefits from their training content. There are different methods of implementing instructional design, often which require different technologies. Understanding the technologies and their implications is critical, as the pitfalls of going down the wrong path may prevent an organization from deriving the very benefits they set out to achieve. Learn more about, and get the lowdown on, new technologies and how you can benefit from them, on Neil Perlin’s technology blog.

Perlin’s background and experience give him a deep knowledge of the implications of various types of training. If you’ve been thinking of moving towards visuals and away from text, catch Perlin’s presentation, Creating Visual Training Using MadCap Mimic at DocTrain East 2008.