Search code examples
pdfsvndocumentationuser-guide

What documentation system to use for user guide

I'm currently trying to find a documentation (user guide) system that would have following features:

  • documentation files in text mode (so svn could diff/merge it)
  • possibility to use images, table, cross-references and table of contents
  • export to pdf (or .doc/.odt) that would support cross-references

I tried markdown for documentation source files and pandoc for pdf export but markdown does not support tables.

I really appreciate any help you can provide.

Solution

  • We use Sphinx for this scenario.

    It can generate html, pdf and some other formats from reStructuredText Files.

    And have a look at list-table when you want to add complex tables.