Convert User Manual to LaTex format
Jim suggested LaTex could streamline the user manual update process. Images/screenshots would not be embedded in the document and we could easily produce a PDF - all without MS Word. It is also spiffy, it seems.
#1 Updated by Matt Jones about 9 years ago
That's one possibility. An alternate that is quite a lot more readable in its text form is Restructured Text (RST)/Sphinx. We use this for the DataONE documentation, and it works out nicely in its text, html, and pdf forms. Its basically the same idea as LaTex, but quite a lot easier to work with for people unfamiliar with the syntax (RST syntax is generally what one would use to format a text file anyways). Here's an example of RST in DataONE that is being auto-built from our svn copies of the files: