DITAblogs (installing and upgrading)

Authoring tools

We recommend using a free, free-trial, or inexpensive DITA-aware authoring tool to create your first demo DITA documents; the experience you gain in a simple environment will help you make the intelligent purchase of a more sophisticated editor later on.

We deliberately chose to use an authoring tool that was free (at the time), since we thought many of our readers would be learning about the DITA Open Toolkit as part of an educational or pilot project where cost might be an issue. We also wanted to edit in "raw" XML ourselves so we would understand that technology well. A couple of months into the project we began exploring more advanced DITA-aware authoring tools that would provide us with additional functionality.

Most of our topics were written using Altova XMLSpy, which is "DITA-aware" (that is, it verifies that DITA source files are well-formed and valid). We had problems at first getting XMLSpy to use a catalog for the DITA DTDs, but that problem was solved (for more information, see Configuring your editor).

Because our authoring tool didn't have "plausible preview," we did frequent builds to check the output.