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.

Final meeting of Boston DITA Users Group

June 14th, 2007 by boston-dita

The final topic for 2006-2007 was High Tech Tools for Low Tech People.Neil Perlin discussed DITA for non-technical authors. David Pearson described development of a technology planning tool. And Susan Czerepak showed her Eclipse Help project for the DITA Manager on DITA Users.Perlin is a certified trainer for Adobe RoboHelp and Captivate, as well as Madcap Flare and Mimic. See http://www.hyperword.com/. Sixty percent of his clients are low-tech. There is widespread ignorance of DITA and structured authoring among them. They don’t know what DITA is or the benefits needed to make the business case.

He recommends we evangelize DITA by selling the benefits. Establish whether the company needs reuse. Nancy Harrison added translation as a big benefit.

Perlin says forget about XML initially. Don’t show them the underlying code. Start with Word-style (WYSIWYG) tools, or tools that integrate DITA into Word, like Information Mapping’s ContentMapper.

Neil’s powerpoint slides are online at DITA.XML.org/boston.

David Pearson showed his projects with DITA Storm on the DITA Users website. He is developing a general template for technology planning. http://www.ditausers.org/Users/dpearson/

David’s presentation is online at http://www.shawmuteducation.org/ (http://tinyurl.com/yvht4w)

Susan Czerepak showed her draft DITA Manager User Guide pages. They are visible as online help at http://www.ditausers.org/eclipse

Bob Doyle presented the results of a survey of possible presentation topics for the coming year. Poll results are at http://www.ditausers.org/topics.html. The most popular topic was Stylesheets. Next were Conditional Processing, Reuse, Relation Tables, DITA CMS, DITA Maps, Publishing, and Help Authoring.

Stan Doherty announced a summer project in DITA 1.1 Reuse techniques. It will include a library of sample files, ready-to-build demos, and supporting explanations. Contact him at stanley dot doherty at sun.com if you would like to participate.

eLearning Content

June 6th, 2007 by dita-tutor

This year is the tenth anniversary of the Defense Department’s development of the Sharable Content Object Reference Model and SCORM is on its way to dominating the content marketplace for on-line courseware, both educational and corporate. SCORM is now managed by the Advanced Distributed Learning (ADL) Initiative, a part of the office of the Secretary of Defense, which now requires that all eLearning materials be SCORM compliant.

This could have a huge impact on content providers, especially those using the latest structured authoring tools based on DITA to develop reusable content. The philosophy behind a SCO and a DITA topic is the same: Author a stand-alone piece of content so it can be assembled into a book, a website, or an on-line course and later be reused in other books or courses as desired.Most content in today’s on-line courses is not reusable. It is also highly proprietary. Proprietary courseware can function only in the Learning Management System (LMS) it was written for. An LMS is a Content Management System with support for sequencing through lesson materials, grading, branching depending on performance, etc.

If a course is developed at Ohio State and Wisconsin would like to offer it to their students, they are out of luck unless they own the same proprietary LMS–or if the course has been written (or rewritten) to the SCORM standard. SCORM courses can play in any SCORM-compliant LMS, an increasing number of which are open-source tools.

Chalk One Up for LMS
The leading proprietary LMS is Blackboard, which in 2006 was granted a very suspect patent on some eLearning technology and acquired its major competitor WebCT, the first virtual learning environment that was a commercial success. WebCT had an estimated 10 million student users in 2003. The educational community was up in arms at the attempt to patent on-line learning techniques, some of which had been in use for decades. Blackboard responded by pledging never to sue the open-source LMS developers.

The leading open-source LMS, Moodle, is growing exponentially. It is used by over 10 million students registered in over a million courses, and was recently adopted by the Open University of the UK, which has 180,000 students on-line.

Proprietary LMS Vendors like Blackboard and open-source developers like Moodle have all banded together in an industry association called the IMS Global Learning Consortium, including over 50 major players like Apple, Cisco, IBM, Microsoft, Sun, several large publishers, and a few big universities. IMS Common Cartridge is a proposal for a single LMS standard.

When computer-based training (CBT) was distributed on CD-ROM, the leading development tools were Adobe Authorware (Macromind-Paracomp > Macromedia) and SumTotal Systems Toolbook (Asymmetrix > Click2Learn). Both of these tools are fully SCORM compliant and support online course development, but their strength is still in older media formats.

Today, most simple page-oriented courseware is being prepared in Powerpoint and Dreamweaver. More sophisticated interactive animations use SCORM-compliant tools like TechSmith Camtasia and Adobe Captivate (formerly Macromedia RoboDemo).

Learning All About DITA
At last month’s meeting of the Boston DITA Users Group, John Hunt of IBM described a new OASIS initiative to develop a DITA specialization topic for eLearning. Hunt’s Learning Content Subcommittee is studying the Cisco/Clark model of Reusable Information Objects (RIO), similar in ways to DITA topics, assembled into a sequence of seven plus or minus two RIOs, which becomes a Reusable Learning Object (RLO).

Cisco Systems worked with Dr. Ruth Clark to create a reusable object strategy. They identified five core content types–concept, fact, procedure, principle, and process–based on established information types developed in the nineteen-sixties by Dr. Robert Horn at Information Mapping.

The DITA Learning Content Subcommittee, with members from Comtech Services, IBM, IXIASOFT, PTC/Arbortext, Sun, and JustSystems, hopes to complete an eLearning specification by early 2008. The effort will result in a set of specialized learning topic types that represent the information types needed for learning content and a map domain to structure them as learning objects.

The goal is to enable hundreds of thousands of technical writers moving to structured content to be producing SCORM-compliant corporate learning materials with the same tools they use today for technical documentation.

On a personal note, SCORM was created a decade ago by an old business colleague of mine, Philip Dodds, who helped develop pioneering electronic music synthesizers and the first digital piano, at Kurzweil Music Systems and ARP Instruments. At ARP he worked with two friends who helped me build the first hand-held electronic games in the nineteen-seventies, Christopher Wright and Michael Suchoff.

Dodds is now chief architect for the Advanced Distributed Learning Initiative. At the recent ADL Summit in Alexandria, VA, John Hunt’s OASIS DITA team presented the preliminary plans for integrating the DITA “holy grail of content reuse” into the world of SCORM and eLearning.