Le Guide de Style DITA met à disposition des explications détaillées et pratiques sur les éléments et attributs DITA. Initialement rédigé par Tony Self, il comprend des exemples concrets, ainsi que des recommandations claires pour aider les rédacteurs à créer du contenu DITA cohérent et correct d’un point de vue sémantique.
‘Le Guide de Style DITA : Bonnes pratiques pour les rédacteurs’ est conçu pour aider les rédacteurs DITA à utiliser DITA de façon cohérente en offrant une référence faisant autorité (de la même façon que le manuel ‘The Chicago Manual of Style’ constitue une référence en termes de langage, rédaction et style de présentation).
DITA is the best way for businesses to publish smart and captivating technical content. DITA stands for Darwin Information Type Architecture, and is an open XML-based open standard for managing, creating, and publishing content. Defined and maintained by the OASIS DITA Technical Committee, DITA uses topics, maps, and output formats to generate documents. Simply put: it helps companies streamline technical documentation processes.
There are several sound business reasons for wanting to work with an open, structured content standard. One of the obvious benefits is that an open standard that has successfully been deployed by other organizations for at least a decade has already been vetted from a business perspective. In other words, all the hard work has already been done by other companies. Your company can gain the benefits of the business “smarts” that has already been built into the standard. These benefits include:
Other key reasons for wanting to go with an open, structured content standard include:
In addition to these points, you are also future-proofing your content, paving the way for new interactive technologies like chatbots that are being built on open structured content standards.
Within Darwin Information Typing Architecture, each piece of content represents a unique XML file. The XML-based open standard allows for maximum content reuse across multiple publications, including tablets, mobile phones, and for desktop. Unlike a Word document, where content simply exists (like a rock), DITA content is dynamic. In an instant, you can publish a document to PDF, PowerPoint, RTF, or mobile—without ever having to cut and paste! A DITA content management system allows you to standardize and leverage content with effective reuse, publish to multiple platforms, and translate large batches of content with ease.
CCMS stands for « component content management software. » Instead of managing content at the document level, a CCMS manages content on a granular scale. Words, photos, phrases, chapters, and even entire procedures are stored in a central repository for maximum content reuse. Components are only stored once. This creates a consistent and trusted source that can be published across all platforms, including PDF, mobile, and print.
Within a DITA content management system, you can search for a word, group of words, or phrase in a certain version of a document. You will get a result containing the search term. Unlike other systems where you must manually locate the file and link to its path, this happens at the press of a button, making content reuse easy.
Inside a component content management system, document versions are traced and recorded. Components can be tracked individually or as an entire documentation set. This ensures full transparency when it comes to the edit and review process.
Let’s say your company manufactures cell phones on a mass scale. Like most products, cell phones come with a user manual (that thing you so often toss out and three months later wish you hadn’t).
In preparation for the release of phone X, your technical documentation teams work towards creating and publishing a user guide. This manual will be delivered in multiple formats, including: as a printed booklet, an online document on your website, and as a PDF embedded on the phone itself. It will also be translated into Japanese, German, and French.
Next quarter, you will go through the same process for phone Y.
Is your head spinning yet?
A CCMS simplifies the process by offering a solution that covers technical documentation from A to Z. IXIASOFT CCMS provides an easy-to-use interface guaranteed to improve collaboration at all levels, and is the only 100% DITA-compliant component content management system.
Now, team members can contribute to reviewing, creating, and publishing documents. Not only is content available for print, is is also available to your end-users on the web, their mobile app, or through a QR code.
IXIASOFT CCMS allows one to manage and automate parallel and multiple deliveries, or even continuous deliveries, while maximizing reuse. All bits of content are stored in a central repository, and can be re-purposed for publishing in several publications, products and languages. This provides a single, trusted source of content (referential). The CCMS is designed with an easy-to-use interface that can easily be adopted by anyone—even non-DITA users.
What’s more, you can filter and create targeted content depending on the product options! This creates slimmer but more targeted guides. End-users won’t need to skim through non-applicable or unnecessary content.
Click here to learn more about which leading companies are using IXIASOFT CCMS.