Overview of DITA and XML

The Darwin Information Typing Architecture (DITA) is a framework for authoring and publishing documentation using Extensible Markup Language (XML). XML is the markup language that includes the tags used to create links to websites, bold or italicize text, or create lists. The basic structure of a document includes several files: ditamap, concept, task, and reference that are the code and content to produce a document. These files are then transformed, or published, to create the output in various formats such as XHTML or PDF.

Continue reading “Overview of DITA and XML”

Why You Need to Hire a Technical Writer

Introduction

I have spent most of my professional life in information technology (IT) doing various technical support roles and technical writing. One thing I learned is that documentation is critical and therefore technical writers are necessary. The sad reality is that many companies think that technical writing is a luxury or something that can be done in someone’s spare time. The misplaced assumption that technical writing is not real work. The fact of the matter is that good documentation solves problems, saves time and money, and will reduce technical support calls.

Continue reading “Why You Need to Hire a Technical Writer”