Since I seem to have become the doyen of documentation, I figure I should ask: what markup language and/or output formats should we be pursuing for future documentation work?
The FAQ is currently written up in orgmode, which Werner is fond of. What you see on the web is orgmode-text put through an HTML translator. But, it also produces lousy print output. The FSF is really fond of their own standard, texinfo, which they prefer to be used for hardcopy and online documentation. I personally don't like texinfo; some people really like it. In its favor, it produces high-quality print output. It actually looks like a book when you print it off. I'm a big fan of LaTeX and PDF output. With a good layout package (like Tufte-Latex) you can get astonishing print quality and professional-looking layout. However, this comes at the expense of good HTML support. You'd have a hard time reading these docs on mobile devices, or at a text-only terminal that had no PDF reader. Another option: Open Document. For obvious reasons we can't choose Microsoft Word, but there are no liberty-related reasons to avoid Open Document. Does anyone have any particular preferences? _______________________________________________ Gnupg-users mailing list [email protected] http://lists.gnupg.org/mailman/listinfo/gnupg-users
