3 ms·
LaTeX. We have academic roots, it works with source control, and the output looks fantastico.
by scottlocklin 11y ago
LaTeX. We have academic roots, it works with source control, and the output looks fantastico.
- brwr 11y agoYou're way more hardcore than I am. I tried LaTeX once. I still have scars.
- MattF 11y agoWe chose LaTeX too for those exact reasons plus: * macros allow us to produce integration-specific installation and user guides * ability to generate HTML and PDF versions Lately though I'm beginning to regret this choice. The owner of the docs isn't allowed to commit to our repo (for good reason), but this means I get changes via the wiki which need to be cut and pasted in. Also, the HTML output was never really good enough, so we've stopped doing that. Getting long tables to look good takes a lot of rebuild-and-check cycles. But my biggest issue is that having a common source for each document with minor version-specific changes sounds great until you try to adjust the page breaks. What looks good for one doc looks bad for another, it's a real nightmare.