DITA Newsletter Volume 2

October 28th, 2008 by admin

We skipped a couple of months of DITA Newsletter - there did not seem to be much world-shattering news.

Now with DocTrain East 2008 there is a major announcement from MadCap Software about their integration of DITA into their whole tools suite including Flare, Blaze, Analyzer, and Lingo.

So we decided that volume 2, number 1 of the Newsletter will feature that story.

We are looking around for someone to become a regular editor of trhe Newsletter.

If you are interested, contact Bob Doyle.

No More Free Memberships

October 28th, 2008 by admin

Since April 2007, our DITA Users international membership organization has provided basic online DITA editing and a personal workspace folder to hundreds of tech writers around the world getting started with DITA.

DITA Users is NOT a social network (although you can locate other members easily with our private members directory)), it is a productivity tool. It is also not a production environment, it is a learning tool.

DITA Users has now reached 750 members in 36 countries and we are changing our membership options (How To Join.

We have eliminated the free membership program, because it is costly to maintain permanent workspace directories for so many people. We will still offer free access to the DITA Storm Editor in our demo sandbox folder. So new DITA Users can still try out our training tools. Our 5-minute Flash tutorial will remain free, as will access to our DITA Tools from A to Z Survey.

We hope that many of our current free members will join to keep their workspace folders and help support our many resource websites for DITA.

A $150 membership includes the leading book on DITA and a desktop DITA Editor to complement the web-based DITA Storm editor.

A full $100 membership includes the choice of the leading book on DITA or a desktop DITA Editor to complement the web-based DITA Storm editor.

The book (a $50 value) is JoAnn Hackos’ Introduction to DITA - either the original edition by Kylene Bruski and Jennifer Linton or the new Arbortext Edition.

The desktop editor is the $48 Academic Edition of the <oXygen/> XML Editor, now at version 9 with full DITA support.

Desktop editors communicate with web servers via FTP or WebDAV (distributed authoring and versioning). DITA Users can now WebDAV-enable individual members’ workspace folders.

Most DITA authoring tools offer WebDAV, some as a premium only available in their Enterprise Editions (for example, Syntext Serna and XMLmind).

DITA Users still offers a basic $50 membership without the book or desktop editor. Benefits include a WebDAV-enabled folder and discounts on major DITA conferences.

Paid memberships are renewable for $50/year. Free memberships include just one IBM DITA docset.

Anyone with a WebDAV-enabled DITA authoring tool can use it on their DITA Users document sets. These include two docsets from IBM and the docset from Comtech Services in the Introduction to DITA book. They can also create their own projects.

Practically speaking, anyone already invested in an advanced DITA authoring tool may be beyond the need for the “DITA from A to B” learning offered by DITA Users. But the new access method may make online training valuable for small tech pub groups who can now use their familiar tools (like Arbortext Editor or XMetaL Author) on the DITA Users website, as well as use innovative tools like the web-based DITA Storm, while their teams get started with DITA.

In any case, DITA Users member fees underwrite our network of DITA support websites, including this newsletter. So please consider joining today.

Looking for Help with a DITA Tools Survey

April 26th, 2008 by admin

We are preparing the first of an annual survey of DITA Tools, based on the tools listed on DITA News Tools A-Z. http://www.ditanews.com/tools/

We will post the survey to six DITA-related communities,

DITA Users Basic Membership Now Free

January 1st, 2008 by admin

It is now one year since we started developing DITA Users. We wish you a Happy New Year for 2008! To celebrate we are restoring free memberships in DITA Users!

Since we started charging for new memberships, member growth has been very slow. We have added only about 30 new members since October 1, 2007. While we think the annual fee is small considering the benefits, it is obviously not small enough.

When DITA Users Beta membership was free, we grew quickly to nearly 400 members (from 24 countries).

We would like to restore free memberships and get more people starting with DITA and topic-based writing.

A free membership will include the DITA Storm browser-based editor and online DITA Open Toolkit. A workspace folder will have the three sample docsets. It will not include our new WebDAV access to support desktop DITA editors.

A full $100/year membership now includes the choice of the leading book on DITA or a desktop DITA Editor to complement the web-based DITA Storm editor.

The book (a $50 value) is JoAnn Hackos’ Introduction to DITA - either the original edition by Kylene Bruski and Jennifer Linton or the new Arbortext Edition.

The desktop editor is the $48 Academic Edition of the <oXygen/> XML Editor, now at version 9 with full DITA support.

Desktop editors communicate with web servers via FTP or WebDAV (distributed authoring and versioning). DITA Users can now WebDAV enable individual members’ workspace folders.

DITA Users was delighted to learn that SyncRO Soft <oXygen/> supports WebDAV in their $48 Academic Edition. They made an agreement with SyncRO Soft to offer an Academic License to DITA Users for learning DITA online.

Anyone with a WebDAV-enabled DITA authoring tool can use it on their DITA Users document sets. These include two docsets from IBM and the docset from Comtech Services in the Introduction to DITA book. They can also create their own projects.

DITA As Simplified XML

November 18th, 2007 by admin

At DocTrain East 2007, I gave a presentation on DITA with an introduction to DITA Users.

The Powerpoint presentation is here.

October meeting - Amber Swope on Bookmaps

October 25th, 2007 by admin

At the October meeting of the Boston DITA Users Group (held last Thursday evening at the DocTrain East 2007 Conference), Amber Swope of JustSystems reported on the Bookmap specialization in DITA 1.1.

You can find a one-hour Flash movie of Amber’s presentation at

http://www.ditausers.org/tutorials/ditamaps/bookmaps_swope

We had some technical difficulty and Amber had to speak for the
first several minutes without her slides.

The presentation has a table of contents - click on the little page icon -
and can be expanded to full screen from your browser.

Fall meeting of Boston DITA Users Group

September 18th, 2007 by admin

Our first meeting for the Fall was very well attended at PTC Headquarters in Needham, Mass.

Bob Doyle reported on the progress with the DITA Users website, launched in March. It has grown into a network of DITA-related support sites.

Tom Kenslea welcomed the group and provided some perspective on simple starter tools like the open-source DITA Open Toolkit and enterprise-class publishing tools like Arbortext, which are designed for large tech pub teams, hundreds of tech writers with supporting designers.

The main presentation was by Jay Dupont and Paula Ploetz, tech writers at PTC.

Brendan Boyle then demonstrated the Arbortext Editor, working in conjunction with the new Arbortext Content Manager CMS.

Recorded versions of Kenslea’s introduction and the two presentations are online.

Kenslea Introduction

Jay Dupont Presentation

Paula Ploetz Presentation

FrameMaker 8, now with DITA

July 25th, 2007 by annegentle

FrameMaker 8’s release has bloggers writing a few blog entries related to Frame 8’s release.

Notably for DITA authors, DITA is no longer a separate application pack downloaded from Adobe Labs. Previously, installation of that pack had you editing the structapps.fm file by hand and pre- and post-requisite configuration steps, so this integration should make for easier startup for DITA authors in a FrameMaker environment.

It appears that with this release FrameMaker provides a relatively inexpensive print publishing engine option compared to other DITA publishing vendors with the Adobe FrameMaker Server 8 software offering.

So do your homework, read the blog entries and news releases, and see if the FrameMaker and DITA mashup is one you want in your toolkit. DITA info developers, what are your initial thoughts and findings?

ROI on DITA Structured Content

July 20th, 2007 by dita-news

Making the business case for a technology change is primarily about your return on investment (ROI).

Your investment to structure your content is likely to be much greater than the direct costs for a component content publishing system, including the software licenses and the hardware infrastructure needed in IT to support the new software. Your total cost of ownership (TCO) must also include indirect costs for retraining workers to write stand-alone topics using new editing tools and change management costs as a result of unavoidable personnel turnover.

To make the business case for structuring your content, you must align the many advantages of structured content with specific needs in your business or organization.

Structured content has many distinct advantages like modularity, single-sourcing, content reuse, multiple delivery formats and channels, and it facilitates translation.

The new DITA structured content standard also adds benefits like topic-based authoring, conditional processing, task-orientation, component publishing, information typing, minimalism, inheritance, specialization, and simplified XML.

Be aware that structured content also has some significant indirect costs that should figure in your ROI calculations. Some senior writers are likely to resign rather than change their writing style. You’ll also have costs for specialists to help analyze and organize your content for structured delivery.

Let’s take a look at a few identifiable tangible and intangible benefits of structured content:

Modularity–Think of your content creation as an assembly line operation. Large content structures are built from modular components. XML content management systems have enabled modularity for years. Individual elements can be pulled from the XML by XQuery and XPath and then deployed in highly specific publishing instances. Personalization of content, for example, requires a modular design. The payoff is that individual modules are easy to maintain.

Single-source–When you have one source for each piece of content, you get the astonishing ability to change it in one place and have the change propagate everywhere. A product name change becomes much more manageable. Your business-critical marketing messages are standardized everywhere. Some call single source a “single source of truth” because you are assured that your customers are not getting mixed messages that can confuse them, reduce sales, and increase the need for tech support. The ROI on single-source publishing appears to be an intangible when planning a new system. Hard cost savings are hard to calculate. But the ability to make rapid changes in critical content has obvious marketing and sales advantages.

Reuse–The cost savings associated with reuse of content increase greatly when your content goes through a workflow with distinct review and approval stages, for example legal approval. Content that is reused generally can avoid all or most of the extra steps in the workflow that involve accuracy of content. You will still need design approval of the in-context appearance of the reused content.

Partial reuse is when much of your content remains the same in a product life cycle change. In these days of shorter and shorter product release cycles, partial reuse can save not only money but the time needed for production of the revised materials. And time is money.

Multiple Output Formats and Delivery Channels–Assessing the value of multiple formats should be straightforward. If you are doing business only on the web, you may need only XHTML, though PDF output may be valuable for those who want to download your documentation. If your content is overwhelmingly print-based, you may not realize any benefits here.

But if you are an average business with a web presence and a good deal of print content, structured standards like DITA will be a plus and give you the future benefit of preparing online help materials by reusing existing content and easily adapting content for mobile delivery.

Translation –The biggest return on investment from structured reusable content comes from translation savings, especially important for firms competing in today’s global marketplace.

If you have quantitative estimates of your content (number of pages and average words per page), the fraction of your content that can be reused, and the number of localization languages, you might run a simple calculation of your cost savings. The formula is: Number of pages x Average number of words/page x Translation cost per word x Number of languages.

With a translation management system (TMS) you can develop a much more sophisticated estimate of costs and cost savings. For more accurate estimates of the fraction of content that can be reused, a TMS will usually include a tool to calculate simple repetition of words. These words may need only to be translated once.

At the DITA Users member organization, we are now using an Idiom Technologies WorldServer On-Demand globalization management system to help us localize our website into ten languages. We will soon be in a position to report more specific translation savings that come from reusable structured content. ROI matters to us, too and I will give you a report on our ROI experience in an upcoming column.

(www.ditausers.org; www.idiominc.com)

DITA Bloggers Wanted

July 17th, 2007 by admin

Are you interested in writing an occasional blog post on your work with DITA?

Register here and we will make you a contributor to this group blog.

The DITA Blog is syndicated to DITA News.

Do you have your own blog? If you tag your DITA posts, we can syndicate your blog postsĀ  to DITA News.

We can also add you to the DITA Blogroll here.

The DITA Blog is one of a family of DITA-related sites managed by CMS Review, including…

  • DITA Infocenter - an Eclipse Help version of the DITA Specifications and Open Toolkit User Guide.
  • DITA News - the latest news on DITA from many sources, including blog aggregation from prominent DITA bloggers.
  • DITA Users - helping users getting started with topic-based structured writing.
  • DITA Tutor - instructor-led and self-paced tutorials on DITA.
  • DITA Wiki - a knowledge base with discussions and commentary.