The primary goal of any organization is to deliver the right information to the right person at the right time and in the right format and media. IBM is taking steps to establish the Total Information Experience for our customers by uniting all content creators and providers from pre-sales to support. We are defining common processes, developing information standards, and implementing collaborative tools & technologies. In this session, we will provide a global perspective about enabling consistency, integration, and content reuse across our Content community. Come hear us talk about how IBM is converging management and technical aspects into a common goal and how DITA plays in the IBM Total Information Experience.
You've spent time and money to investigate the best solution for a new documentation system. You've decided to migrate your documentation to structured writing and single-sourced content using XML. You've selected the software and are ready to go. You have all the steps in order to implement your content management system.
But what about your writers? How do you get them to go along for the ride?
Change is stressful. For everyone, every time. Small change, dramatic change---it doesn't matter; it stresses people out.
This presentation goes through the people perspective of one company's conversion from using Microsoft Word to an XML authoring tool. It presents processes used to handle the changes and the lessons learned for:
- helping the management team support the process and their employees
- supporting the writers through the process and involving them in the decisions and development
- developing the system to provide the best possible information for the customers
- obtaining the acceptance and support of the stakeholders (the subject matter experts and business owners)
Our presentation includes some best practices for change management as well as provides our successes and challenges as we implemented these best practices.
In an online world where huge amounts of technical content come from blogs, wikis, RSS feeds, and web pages written in HTML, the days of designing online help using proprietary formats available only through proprietary software stored within our product are numbered. Too much of the information we want our customers to access comes from outside our firewalls.
These days, open formats based on open standards, particularly XML-based formats, are becoming increasingly popular, and one of the most popular is DITA - the Darwin Information Typing Architecture - standardized under the aegis of OASIS. At the same time, one of the major open source development platforms is Eclipse, developed by the Eclipse consortium.
This presentation discusses methods for designing a topic-oriented help system through application of the DITA architecture, for designing the correct set of Eclipse plugins in which to organize the help content, for building the plugins using the DITA Open Toolkit, and for introducing custom branding and graphic layouts.
This presentation elaborates on the benefits and challenges when moving from authoring monolithic documents to topic-based writing, with a specific focus on the translation process.
In terms of benefits, Miel will point out that modularization and single sourcing lead to reduced time to market, an increased reuse of content, and consequently to an increased reuse of translations. He will go into detail on how the pre-translation of topics can further reduce the number of words to be translated by the translation office.
Translating topics instead of monolithic documents also creates new challenges, such as determining the target languages of topics, dealing with language independent links, translating illustrations and variables that are embedded in topics, and many more. During his presentation, Miel will not only identify these challenges, but also propose solutions on how to cope with them.
Today there are a wide range of CMS applications to choose from. Selecting the right system to meet your business requirements can be an enormous challenge. The best solution will address your business needs cost effectively. If you feel you are not getting the whole story, or are overwhelmed with the terminology and technology there are a few basic steps to follow. Identifying the optimal system comes down to understanding what to ask. If you are in the market for a CMS, this presentation helps you to understand the different Content Management Application features so that you can generate a complete list of requirements for use in selecting a CMS to address your business needs. We discuss workflow, role management, version control, and single sourcing in the context of Content Management. We also discuss the process of developing system requirements and steps you can take to insure you don’t get stuck with the wrong system. Bring your questions; this session includes many opportunities to address your questions.
Faced with increasing pressures on efficiency and growth globally, Avaya moved from an unstructured authoring and content management environment to a unified, global XML solution. Join this presentation to find out how the solution brings together different silos in the content lifecycle, to provide one end to end solution from authoring through content management, localization and to the publishing of global information.
We use our DITA content analysis and conversion task flow and tools to anchor a discussion of the importance of content analysis. Extensive content analysis allows us to improve our content by
- identifying audiences
- defining deliverables
- focusing on user goals
- applying minimalist writing conventions
- revisiting problematic content
We discuss how manual analysis and conversion provides us with opportunities to help writers with the transition to the new authoring approach. The benefits of including writers in this process include
- increased adoption of the new authoring approach
- continued sense of content ownership
- early exposure to tools and DITA
- increased opportunities for early correction
This presentation provides a "Field Report" presenting two cases of DITA implementation at two large European corporations and view into the work of the DITA Machine Industry Subcommittee.
Case 1: One of the first DITA implementations in Europe for a corporation in the machinery industry. This project has been accomplished in 2005 based on the DITA 1.0 standard and a specialized bookmap DTD from the DITA Open Toolkit.
The solution is based on Documentum as enterprise content management system, the Arbortext Editor as authoring tool and RenderX as PDF render engine.
Case 2: For a proof-of-concept in one of the worldwide largest pharmaceutical corporations we have used Trisoft Infoshare as CMS, the Arbortext Editor as authoring tool and Antennahouse as PDF render engine. This presentation will provide an overview of how we have used the new DITA 1.1 (beta) bookmap DTD and a couple of specializations in that project.
The third part of the presentation is an overview of the work of the DITA Machine Industry Subcommittee, incl. a first preview into a Hazard Statement Domain and the Maintenance Task specialization.
Brandeis University’s Senior Web Architect, David Wisniewski, presents a case study on their Web Content Management System implementation, detailing reasons for moving to a CMS, steps taken to prepare for the integration, implementation goals, project time frames, and team involvement. Specifics on how Brandeis leverages XML and XSL with the CMS to accomplish various organizational objectives, and how their internal processes have changed from manual site management to automation are highlighted. This presentation also demonstrates how the company collaborated with CMS provider Hannon Hill Corporation to train staff and implement the solution, as well as plans that are on the horizon for Brandeis's online presence.
As XML, and specifically DITA, gain momentum in today’s global marketplace, many organizations are trying to get their arms around whether or not to take the leap into a CMS.
The fact is, in any XML environment there are a lot of moving parts that must remain in sync in order for it to be worthwhile: content modeling decisions, specialization considerations, metadata models, publishing tool requirements, and perhaps the most complex decision, a CMS tool. DITA can be successfully implemented without a CMS, but consideration needs to be taken if you plan to implement a CMS at a later date. Join Amber Swope from XMetaL as she discusses the pros and cons of CMS implementations in a DITA environment and provides a step-by-step roadmap for easing into a DITA environment with and without a CMS.
Metadata is arguably the foundation of effective content reuse and thus a successful CMS, enabling information developers to locate/retrieve, track (new, draft, approved), and reuse content. Developing a strong metadata foundation requires a systematic metadata strategy, a robust implementation plan, and ongoing review process to maintain high quality metadata resources.
Hewlett-Packard managers demonstrate practical techniques and proven results through its partnership with Vasont Systems. This hands-on session provides an in-depth view of metadata concepts, approaches, and implementation methods that you can tailor to your organization. Establish a comprehensive approach to metadata in three key areas:
- Systematic Metadata Strategy: A systematic understanding of your metadata requirements is the first step to developing the sound strategy needed to promote mega reuse across your organization. Assemble the right team of participants to gain a complete grasp of your requirements and select appropriate metadata components and lists of terms that can be managed for maximum reuse.
- Robust Implementation Plan: Define who will implement your metadata strategy, how they will carry it out, and when implementation should occur. Implementation initially requires pilot projects that will help you test the usefulness of your metadata components—to verify that they will support specific user search criteria. With evidence that your components facilitate search and retrieval, determine how key players will assign metadata to content modules.
- Ongoing Metadata Review Process: If metadata components are not maintained over time, their usefulness will diminish, inhibiting mega reuse. A management plan that enables designated individuals to monitor the consistent use of metadata components across the enterprise is crucial to effective reuse. Moreover, metadata management ensures that as content changes, metadata lists are updated, distributed to information developers, and monitored for accurate implementation.
A comprehensive consideration of these three key areas enables participants to find ways of using metadata to ensure mega reuse. Attendees will learn how to:
- establish the right team of participants to evaluate requirements
- identify metadata criteria
- determine how to develop a metadata strategy
- understand metadata components
- assess the best approach for testing and implementing the strategy
- engage all members (roles) of your team in implementing and monitoring metadata
- develop an editorial process for managing and modifying metadata
The road to metadata is not an easy one. It requires research, determination, discipline, creativity, and resources. The commitment to metadata, however, can bring significant results—mega reuse that can benefit the bottom line.
Documentation and training organizations have long recognized the value of migrating content to XML to attain the benefits of content reuse, reduced localization costs, and single-source publishing. But, many of these organizations have never been able to justify the high cost and long implementation cycles required to install an in-house XML content management solution.
Recently, a new alternative has emerged – the "Software as a Service (SaaS)" model, which offers a hosted XML content management environment on a subscription basis. According to leading research firm InfoTrends, over 40% of their survey respondents would either “prefer” or “definitely consider” a hosted content management solution.
This session compares and contrasts the differences between a SaaS model and the traditional in-house CMS implementation, and spotlights some recent customer success stories, with an emphasis on the purchasing process, the implementation details, and ROI results.
This session is co-presented with an existing DocZone customer, who will share details of their implementation process and the results achieved from their migration to a hosted CMS environment.
Dan Dube, DocZone
Cathrine McNair, Agfa Healthcare
As companies increase their global operations and interact with more and more target audiences online, the demand for the winning combination of local content and brand control is growing rapidly. In this session, Tridion explains how Web Content Management can help global organizations effectively and efficiently respond to business and marketing needs to better communicate and interact online. By delving into several customer use cases, attendees learn how IT can empower business and marketing teams to create consistent and persuasive online experiences for target audiences across multiple channels, enabling faster time to market for organization’s wanting to effectively manage global and local content.
A team of 6 writers, using RoboHelp, WebWorks Publisher, and FrameMaker, was faced with the challenge of supporting a potentially unlimited number of versions of our software application. Each version had a different look and feel and offered slightly different features. Estimating that there was the opportunity for about 80% re-use of content across versions, we began looking for a tool that could support that re-use, as well as an ever-quickening development cycle.
We had investigated single-sourcing tools in the past but most were too expensive or required too much restructuring of our content to even begin working with them. One tool, AuthorIT, stood out from the rest because of its relatively inexpensive price and Word-like interface.
About a year ago, we converted all our content into AuthorIT and have been actively using it to publish more than a dozen help systems and guides.
Learn how to improve content quality and reduce costs associated with content management and localization. Using a case study Paul Trotter, CEO of AuthorIT Software Corporation, and Scott Ludwigsen, President of Lingo Systems, demonstrate how OSIsoft dramatically reduced their localization and content management costs by implementing AuthorIT.
Paul and Scott discuss the reasons that OSIsoft began an assessment of solutions to their content management and localization needs. The evaluation process is detailed identifying the options available, leading to the reasons for the selection of AuthorIT as the preferred solution. Learn about the 10 step process that Lingo Systems has identified to ensure a smooth content management and localization implementation.
Delta has been a pioneer in developing SGML and XML publishing solutions within the Maintenance and Engineering departments. Delta was one of the first airlines to implement an SGML publishing solution for manuals and task cards in the early 90’s. This created a strong foundation for building XML publishing systems beginning in the late 90’s. Currently Delta is using XML publishing technologies for large technical manuals, maintenance task cards, engineering documents, and portal content.
This presentation highlights Delta’s enterprise publishing strategy with emphasis on publishing system components, styles of publishing, and the advantages in using an XML structured content model.
The Information Engineering team at Teradata, a division of NCR, has adopted DITA and Astoria content management to develop information to support hardware and Operating Systems for massively parallel processing (MPP) computer systems. A major business initiative drove them to evaluate content reuse for more variable product configurations while concurrently adding new models every 18-24 months. Teradata’s case study features the processes they employ to author, review and manage this complex publishing environment and the unanticipated challenges that have arisen since their move to CMS/DITA that confirm the business value of this solution.
This presentation will provide first hand deployment best practices information for users looking to adopt DITA. Provided in a case study format, it will also discuss the original plans vs. actual findings of deploying DITA providing users useful information for planning their own deployments.
How do you get off to the right start in creating your content management strategy and then ensure that you continue moving in the right direction? How do you estimate ROI and measure it over time? How do you determine what content management tools are right for you now and into the future? How do you prepare the writing team and organization for this change and ensure their buy-in and success over time? Oh, so many questions…
It’s time for some answers! Listen as GE Healthcare and Vasont Systems discuss the steps and lessons learned around creating and maintaining a successful content management strategy.
This presentation provides an introduction to writing plugins for the DITA Open Toolkit. Topics covered will include how to take advantage of the preprocess output for resolved conrefs and map traversal, how to create specialization-aware XSLT, how to create the XML files used to register your new plugin code as a new transtype with the Open Toolkit, and how to create Ant tasks that use your plugin. Examples will cover code related to JavaScript TOC generation for the Open Toolkit XHTML output in the tocjs plugin and code for creating a full text search index used in the kindex plugin.
Many writers suffer from the perception that structured writing constrains creativity, and that content management translates to loss of ownership. Ghada Captan dispels these misconceptions and illuminates the freedom that comes from embracing structured writing and content management.
Avaya’s decision to move to structured authoring using DITA has resulted in some creative alternatives for this acronym that provide valuable lessons for moving this effort forward. The first lesson in DITA is, Don’t Intimidate the Authors! In the first part of this presentation, Susan shares how Avaya moved from an unstructured authoring environment into structured authoring. She shares how authors were educated and supported, how adopter projects were selected, and the steps taken to assure that deliverables are met while continuing the transformation of our content.
In the second part of the presentation, Jack Thompson discusses the second lesson in DITA, Deliver Information Targeted at the Audience. Two key factors in the successful implementation of XML/DITA and a CMS are getting customer feedback on the current state of your documentation and then apply minimalist principles to the documents in order to maximize reuse of information, and, effectively meet your customer's needs. Avaya has implemented a customer feedback program to figure out what information customers are using in the manuals, and, found ways to reuse and streamline information.
Research In Motion delivers multi-language content in multiple formats. In this presentation, I will demonstrate how, by using a CMS and the DITA Open Toolkit, we have automated our publishing environment in order to meet the deadlines and customizations required by our customers and partners.
The demonstration will highlight:
- how far we have taken single-sourcing
- an overview of how we manage ditamaps in our CMS
- the integration between our CMS and the DITA-OT
- the modifications that we have made to the DITA-OT
- the advantages of automated publishing
- the trade-offs we have made along the way
This presentation is a case study of how a customer of Translations.com has adapted a content architecture designed originally for only English content to accommodate global/multilingual content.
Areas of emphasis include optimal workflows for time sensitive content, strategies for multilingual search engine optimization, and cost savings through automation and application of language support technologies. The following items are covered:
- Integration of globalization functions into content management system user interfaces and workflows
- Automation of submission, extraction, delivery, reintegration and change management of content with content management systems
- Extending this functionality to other content repositories such as databases or file systems
- Integration of translation memory into content management systems to allow for instant word counting and instant translation of fully leveragable assets
- Content promotion workflow issues, i.e. reading from a production live system, but writing back to development or staging environments
- Meta Data-specific considerations for multilingual search
This presentation uses real life examples of a client's systems, and is co-presented by one client executive representative and one technical representative from Translations.com.
Nearly every major pharmaceutical company in the United States (and several internationally) has instituted a research “knowledge management” program in one form or another. Content Management is often a cornerstone of these programs. Some of these programs succeed, while many do not, but a challenge common to all is the wide disparity in the ways different groups of scientists consume information.
Experience at one such company yielded a specific finding: while a gap in understanding between the different sciences made things difficult, a more subtle (and surprisingly intractable) problem was seen in the divide between younger and older researchers. During this program, it proved difficult to generate a consensus that took advantage of information technology while meeting the requirements of the most experienced colleagues. Unsurprisingly, those with the most experience tended to wield the most power. That power generally pushed against the direction of basic knowledge management trends like self-service, distributed storage, and ad-hoc collaboration. In essence, the way the researchers “do science” was split along generational lines.
Several questions arose from this experience that bear considering by members of both industry and academia in pharmaceutical sciences. What kinds of tools make the best sense for managing and distributing pharmaceutical research content? Is there a common ground in needs between the generations of scientists? One place to look toward the future might be academia, where students today will be tomorrow's research staff. However, the attitudes of these students might surprise, and certainly shed insight on what is most important in content management programs.
One company’s scaled migration from uncontrolled, unstructured FrameMaker desktop publishing to topic-based, structured documentation using DITA in a production environment.
Migration Goals
- Create migration goals to expand the possibilities for using open source and alternative editing, and production tools.
- Implement source and document management principles to help understand and justify the use of a content management system.
- Provide revision controls and manage translation costs.
- Continue to provide release-driven product documentation with minimal impact on budget and no impact on schedule during the migration effort.
Migration Path
Progressive steps in this scaleable migration path include:
1. Unstructured topics –Unstructured document – Unstructured Production. The first step is to break documentation content into standalone topics in the current FrameMaker production environment.
2. Structured topics – Unstructured document – Unstructured Production.
Provide structured topics using DITA/XML document type definition within the Framemaker production environment and provide conversion rules for storing topics in DITA/XML source.
3. Structured topics – Structured document – Structured Production.
Structure the entire document set using DITA architecture, allowing the use of the FrameMaker production environment as well as open source and alternative editing, production, and content management tools.
Most discussions of XML-based projects tend to focus on a few of the major components of the project, such as content authoring or content management. However, few attempt to provide a comprehensive outline of all the components necessary to ensure project success. Rajal Shah (Document Engineering Manager) and Richard Hendricks (Manager, JUNOS Protocols Writing Team) from the Technical Publications department at Juniper Networks share their up-to-the-minute experience of a current conversion project to help you learn the secrets of success and avoid common pitfalls. They also provide a comprehensive outline that you can use to assist you in planning your own FrameMaker-to-XML conversion project.
Technology has improved radically in the past decade, meaning that Content Management investments are less often and to a lesser extent dependent on their technological components, but more dependent on planning, development, and operational factors that are less discrete and thus more difficult to describe and measure.
The definition of many successful CM efforts has broadened to include the impact on and value perceptions of a wide range of contributors and end-users, especially in the growing e-Government world. No matter how technologically solid and well-designed many systems may be, their success will often be defined by whether their intended users accept and use them and whether, by that use, the underlying objectives are brought closer to realization.
A growing initial step in the development of a system and IT investment plan is the discovery and description of the involved user community:
- What are the target user demographics?
- What range and mode of facility with computer systems and the Internet is likely to be present among the user community.
- What user internal and end behavior does the system require for successful operation?
- What is the impact on the organization’s process life cycle of invalid or incomplete user behavior?
- What is the impact, on the strategic objectives, of user failure to engage the system?
Once the general impact universe and functional profiles of the contemplated investment are well understood, the project must adopt or develop ways of managing its actions to meet the defined goals:
- How to ascertain the portions of the information life cycle, from content creation to final consumer participation, which must be included in the definition and measurement of success.
- How to adopt value measurement approaches to each included sector so that the planned investment may be evaluated prior to commitment.
- How to adopt measurement approaches to monitor an investments considered, including approaches to convert the general perception of need into strategic goals and tactical objectives that will form the basis for defining effective investment and measuring all aspects of investment success.
- How to adopt methodologies for dealing with system input from “uncontrolled” users; customers, interested visitors, citizens, voters, subject matter experts, business owners and managers, etc.
This presentation explores the growing influences on successful Content Management planning and implementation, suggesting some concrete ways in which organizations may increase their chances of success.
The promises of XML and DITA include better content quality, lower production costs, better usability and increased collaboration between authors. Are these promises a reality or are there monsters in the closet?
This presentation is based on true DITA implementation stories. It offers remedies and suggestions against monsters that might be haunting writers and sheds some light around scary dark shadows that are lurking to get in your technical departments.
- Hide and Seek:
The story of the vanishing topics and of those whose presence you have never felt.
- The Giant Spider:
Are you going to get caught in the related links spider net?
- The Writer's Death (or More Skeletons in the Closet): There's a horrifying rumour going around about writers dying in agony. They are no longer wanted because structured writing and DITA means that anyone can feed content into predefined topic structures and because a machine can format everything for them.
Simplified Technical English (also known as Controlled English) is a method of writing that makes technical English easy to understand. The use of Simplified Technical English stimulates global acceptance of technical documentation as it improves readability and prevents misunderstandings and misinterpretations.
As today's authoring environment is changing to structured XML and content management, it would only make sense to also adapt controlled terminology and good writing practice rules to further improve reusability and create additional cost savings.
Doing so will not only standardize the content, it will standardize content management in general, create efficiency, and further increase the many benefits content management already offers. Reusability is the key word here, which applies both to the English content, as well as to the translations, which can decrease the content up to 30% AND save translation cost up to 40% per language!
Simplified Technical English is a long-term and comprehensive initiative designed to standardize the way technical publications are written. It facilitates globalization in a reliable, cost-effective and efficient way, and facilitates content management through optimum reusability.
What does the Total Information Experience look like to the practitioner in the lines of business at IBM, to the information developers creating the content for our customers? Line organizations have built communities of practice linked to the various initiatives at the corporate level, to implement processes and standards at an operational level on delivery teams. These teams leverage the collaborative tools and technologies sponsored by the corporate team to create consistent, integrated, reusable content for our global customers. Come hear us talk about how one line organization has created communities of practice linked to corporate initiatives to drive adoption of DITA, integrated information, and new tooling, and the associated cultural change required to be successful.
Tutorials often show users, novice or advanced, how to perform specific product tasks by directly interacting with real-life examples and sample content. Tutorials are usually organized in a logical order with an introduction, modules, lessons, and a summary. Tutorials may also contain building blocks for more formal learning, which may include assessments. The DITA Tutorial specialization includes specialized topic types for each of these pieces of content, making tutorial writing an easy task to accomplish.
Hear how the IBM/Lotus information development team used the DITA Tutorial specialization to create a tutorial that introduces new users to IBM Lotus Component Designer.
Authoring and translating DITA documents can be greatly enhanced by the use of related standards such as XLIFF, TMX, SRX, TBX, GMX-V and xml:tm. These standards should not be viewed in isolation but as an integrated framework which reduces costs and increases choice. This presentation also includes the basic do's and don'ts of XML authoring and translation as well as a summary of the work of the DITA Translation TC.
As anyone who has already chosen to use DITA knows, simply deciding to use this document architecture is only the start of a process to actually usher the first DITA-based publication out to the printers. Implementing new ways of authoring information and new ways to manage DITA content also opens up a number of other possibilities any documentation manager needs to address. Do we convert existing content or redo things from scratch? How much of a change to existing processes will switching to DITA incur and how to take best advantage of that change? How do you minimize the amount of training for your existing technical writers? What are the advantages of deploying a CMS to support DITA content? Where are the savings in using DITA? This case study presentation presents how DITA and a content management solution were introduced within the Documentation and Localization group at ATI Technologies (now a division of AMD). The presentation appeals to anyone who is currently thinking about using DITA and the nitty gritty aspects of what is entailed in implementing it.
While initial DITA implementations have focused primarily on publishing to pre-defined PDF, HTML and Help formats, the real promise of DITA lies in supporting dynamic, personalized content delivery. Based on three specific case studies, this presentation will demonstrate how DITA can be successfully used to (1) produce on-the-fly personalized technical manuals in PDF and HTML, (2) drive highly-personalized real-time content to a financial services company’s web site, and (3) support XQuery-based search with real-time transformation of results to PDF and HTML. It will also describe the business benefits that these three organizations have achieved by using a DITA-based approach.
Translated content can be difficult to manage – no matter what type of system that you use. As part of implementing a content management system at Research In Motion, the Software Documentation group encountered many benefits and faced many challenges when working with content in a number of languages. This session looks at our past methods, our initial CMS translation process, and how we adapted that process as we learned more about our tools. What changes were required for content development? How was linguistic quality assurance incorporated? Where did we change publishing and formatting tools? How did our vendor relationship change? Where do we go from here?
How did Sybase Tech Pubs move on down the road to DITA? By means of our "ruby slippers"-tools and transition.
The road to a successful DITA implementation is fraught with challenges for authors: Rapid Application Development (RAD); product managers, engineers, and others pelting them with continually evolving product requirements, tools, and Eclipse delivery framework; authors and subject matter experts spread across 7 time zones spanning the globe; and a monumental task of transforming volumes of legacy books and topics to topic-based, minimalist, user goal-oriented content.
Like Dorothy, authors can make it to the Emerald City with thorough, thoughtful planning, flexible tools and developers, and, like the Cowardly Lion, a healthy dose of courage to change and to exercise the leadership needed to overcome the "not my doc set" syndrome.
Sybase recognized early that to make it past all the obstacles on our road, we needed a dual focus: tools and author transition. We created an internal Technical Publications Solutions team that not only develops and implements technical requirements, but also aids authors in their transition to DITA through training, documentation, and management.
We tell you how we defined our path to DITA by researching, developing, and documenting how to apply DITA best practices at Sybase. We discuss our internal training program for authors, information architects, and managers. We’ll introduce our mechanisms for collaboration and communication. We talk about the phases in our journey: choosing and initially implementing a tool set, Beta 1 rollout on a live pilot project, Beta 2 rollout with updated tools, training, and guidelines, and Phase 1, the broader rollout to our flagship products.
Literate programming is the software development process in which documentation and source code are written into one source file. In this presentation, Schlumberger Documentation Manager John Cornellier explains how literate programming has been achieved through DITA. John describes what the project requirements were, why DITA was chosen, whether or not it successfully met those requirements, and what the challenges were along the way. John also describes how users were trained to use the new system and where the future lies. During the presentation, see examples of the authoring system and its output.
Once you have done everything right and moved your company to single source XML DITA authoring architecture supported by a multilingual CMS, what do you need to know about the localization process, tools, and techniques? These choices will impact your existing legacy materials and the reusability of years of investment in Translation Memories, Context TM and Translation Management systems.
Perhaps it’s that the stock price of Google has us bamboozled, but our continuing focus on “search” misses the point. Merely being able to find some colossal number of documents across the web is a technical feat that does no one any good. We need to stop focusing on “search” and start focusing on what people are trying to do with information, which is use it in a particular context for a particular purpose. As such, what they need is not a search-based “information dump,” but instead the presentation of only the information that is directly relevant to their tasks. This requires a new generation of content applications based on XML tools and technologies, such as XQuery, that enable the integration of content from different sources, repurposing and delivering content through multiple channels, and mining content to find previously undiscovered information.
Dave Kellogg, CEO of Mark Logic describes how new technologies, combining content integration, content processing, full-text search, and the W3C-standard XQuery language, enable information providers to use their XML content to quickly create a new type of role-based information product, such as an application designed specifically for nurses in an ER. He also explains how the new tools enable companies to experiment with new business models, including Web 2.0 applications, by introducing several products on a single infrastructure, aggregating and transforming content from numerous sources, and repurposing content among various products.
This session explores the use of a policy-based approach to applying presentation and style to DITA topic-based content. This "styling by example" starts from the successful strategy of CSS, XSL-FO, and ODF. In this approach, a specialized DITA policy topic type defines available presentation properties for DITA topics. The style designer defines a style policy document that selects content elements by type or by example and specifies their properties. The writer then applies a particular style policy by choosing from a gallery. That style then gets used across the DITA topic-based content to create a deliverable with a consistent appearance and behavior.
This presentation itself provides its own demo - it uses style policies to present the DITA topic-based presentation content as a slide show!
If Web 2.0 is teaching companies anything, it’s that integration between the technologies used to manage web sites is becoming easier, not harder. Organizations of all sizes are integrating different content management strategies to build cool Web 2.0 applications such as Site Subscription, Email Campaign Management, RSS Feeds, Podcasting, and many more. This session educates attendees in the methods for creating these marketing tools to foster better communication with customers and deliver sales opportunities for their companies.
One would think that with the recent influx of DITA tools into the marketplace it would be easier to justify authoring and storing documents directly in XML using DITA. By now most IT managers have been exposed to the benefits of creating XML content management systems according to some agreed upon set of documentation rules. However, understanding the benefits of this technical approach and being able to justify the expense of implementing it are two different things. This session helps business managers articulate the long-term advantages of converting corporate data repositories to XML using DITA in order to build a suitable business case to get such projects off the ground.
One of the most bewildering experiences that an administrator can suffer is to open a help system and view hundreds of help topics in the table of contents or navigation pane. What to do first? What tasks are required? Do I really need to read all this stuff? What procedures must be completed in order, and what sections are optional? How do I find the related concepts and reference information for the tasks I must perform?
As information architects, our job is to squash the bewilderment factor and enable readers to know what they need to do, when to do it, and how to do it, one step at a time. This session tells the story of how a first-time IBM Task Modeler user was able to analyze meaningful tasks, create topic hierarchies using the Task Modeler, and build a cookbook to successfully install, configure, and manage Lotus Sametime Gateway, a new product from IBM. In addition, this session also discusses a sane approach to topic hierarchies and linking strategies, aided by the Task Modeler. The Task Modeler is a state-of -the-art tool for modeling activity as a hierarchy of tasks and related elements. Technical writers can use the Task Modeler to organize DITA topics, create DITA maps, and create relationship tables for help systems.
OCTANE, built on Microsoft Content Management Server, offers enterprise content management for Windows Live Operations with features such as version control, workflow management, content reuse, and metadata tagging.
Incident Management Console is a tool that has been designed and built to provide an end-to-end Incident Management workflow in the Windows Live Operations Center.
By using web methods and plug-ins to pass data between OCTANE and Incident Management Console, we have automated many standard tasks performed by Operations Analysts and introduced a much more streamlined Incident Management process within the Operations Center. This process will enable the Operations Center to scale to meet the forecast demands of the business over the next two years.
The Aerospace industry can be counted amongst the earliest adopters of markup technologies and this fact can be seen as something of a mixed blessing. On the positive side, aerospace documentation specialists frequently have extensive experience working with SGML and XML and consequently have a solid sense of what works and what does not. On the less positive side, aerospace documentation groups have weathered at least two generations of technology investment and are facing a third wave with the introduction of equipment-oriented modular markup standards - specifically S1000D. The most significant challenge associated with surviving those successive generations of markup technology is that frequently all of them represent ongoing requirements that need to be serviced even as the move is made to more modern standards.
Within projects undertaken for the world's leading aircraft manufacturers and operators, one strategy that has proven consistently successful is leveraging the extensibility framework provided by DITA to subsume the requirements of both new and legacy standards into overarching 'meta-standards' that allow documentation teams to streamline their workload while continuing to satisfy often conflicting legacy requirements. Dubbed 'extreme DITA' by the participants in these projects, the uses made here of DITA fall well outside what was originally envisioned by the originators of DITA and this has itself introduced challenges.
This paper provides a survey of the standards landscape governing the aerospace sector and a history of its investments in markup technology. As its centerpiece, this paper showcases how DITA can be used to solve the very challenging problems encountered when evolving large-scale documentation systems.
Web 2.0 technologies provide real opportunities for collaboration and development in social environments. But there remain real challenges when integrating Web 2.0 approaches into Enterprise strategies:
- how does an information architecture change when applied to a social environment?
- how can content be shared across organizational boundaries and applications?
- how can meaning be preserved across applications to enable robust integration?
DITA provides a natural bridge between informal, social development environments and formal, enterprise-wide content strategies. As an OASIS standard for modular information that can be easily adapted and massively scaled, DITA acts as a semantic life-preserver for strategic content in the Web 2.0 environment.
DITA-XML has moved beyond the point of only appealing to early-adopters and into the mainstream for information development teams. Perhaps one of the most powerful aspects of DITA is the DITA map. The DITA map allows content designers to organize DITA topics in a very flexible way to help better reuse the content elements. One example of how we can use DITA maps to organize content is to apply the DITA map to a workflow procedure. Sometimes when designing content, it is necessary to guide the user through a certain path of the content. This might be due to the user role or the user's product environment. In online environments, a standard method for guiding the user is to use an interview or wizard. In this presentation, I will show you how my team developed a method for using DITA maps to structure content to allow us a very flexible way to create a DITA-based interview. Our method allows us to develop all the topics, and then provide a layer of DITA maps that serve as the pathway to guide the user to a grouping of topics.
The interview uses a series of questions/answers to guide the user through a particular pathway based on their user role, product environment, and other preferences. We then use those collected interview answers to find the topics that would be relevant to the user, and transform the topics into a customized output. The output is made available to the user as XHTML and PDF. In addition, we allow the interview answers to be saved in case the user decides to use the interview again. This presentation walks the audience through our methodology and also provides a live demo of the DITA-based interview.
Due largely to its break with the book paradigm, DITA has revolutionized the way people create and manage content, and end users are already realizing measurable benefits. However DITA is not the only standard that has taken a topic-based approach. S1000D - an international specification used principally by Aerospace and Defense - is also topic based. Some aspects of S1000D are analogous with DITA while others represent interesting and possibly useful departures. This presentation compares and contrasts the two specifications and suggests issues you might want to consider before moving from your legacy world.
|
