Introduction to Mallard

About this book

This book is a basic introduction to key Mallard concepts that is intended for user documentation writers, who may or may not also be software developers. When you finish this book, you will be able to build a fully-linked Mallard document and integrate it with your Linux application or transform it to HTML.

To use this book, you should have some familiarity with the following:

  • markup languages such as HTML and XML, 
  • the command line, and
  • a Linux operating system.

It would also help (but is not essential) to be acquainted with the GNOME desktop environment for Linux.

This book is not:

  • a comprehensive reference for Mallard vocabulary, 
  • a detailed technical specification of the Mallard language, 
  • a guide to the GNOME desktop environment for Linux, 
  • a guide to better technical writing.

This book is designed to be small and accessible, and there are other references for each the above topics, many of which can be found in the Appendix on further resources.

You can help make this book better by suggesting revisions or reporting errors on the Mallard mailing list. See http://projectmallard.org/about/contact to join the list.