The Anatomy of a Real DITA Documentation Project
DITA allows for a lot of flexibility, which translates to a huge number of choices. This is a good thing if you are an advanced DITA user but it may be daunting if you are just getting started or an intermediate user. It is always easier to look at a real example and start from there, rather than starting from scratch.
In this workshop, we will look over a real-world DITA project, see how it is organized, explore the DITA features it uses, how it is setup to keep track of versions, what publishing options are available, how to check documentation quality, and more.
On one hand, this can serve as a starting point (as an example you can follow when you start a new project), and on the other hand, you may also notice some interesting approaches that you can adopt in your own projects.
Another goal is to show you that the latest trends in the documentation world, specifically that “docs like code” ideas, are perfectly compatible with DITA.
XaaS – XML Authoring as a Service
In today’s world, we use more and more services. When we start a project we do it on GitHub, if we want to communicate within that project we create a Slack channel, to automate some tasks we setup Travis to run some scripts, to publish content on the web we can use GitHub Pages, and so on. In this session, we will explore how an XML Authoring service can fit into this services world and various possible use cases.
George Bina is one of the founders of Syncro Soft, the company that develops oXygen XML Editor. He has more than 15 years of experience working with XML and related technologies, including XML-related projects, oXygen XML Editor. He has participated in open source projects, the most notable being oNVDL, an open source implementation of the NVDL standard, now merged into Jing and DITA-NG, the Relax NG-based implementation of DITA, which was adopted as reference schema for DITA in DITA 1.3.