# Best practices references

What resources (online or otherwise) exist that give good advice on best practices for TeX, etc.? I'm looking particularly for things that assume you already know TeX or LaTeX, and aim to help you achieve better results, with rationales explained. Resources with some specific focus are welcome. I'll start a list with two suggestions of my own so you can see what I mean.

Somewhat to my surprise I haven't found this question asked here already. (Please point me to it if I'm wrong!) Note that what I'm asking is somewhat different from What is the best book to start learning LaTeX? and What are other good resources on-line for information about TeX, LaTeX and friends?, although there's lots of room for overlapping answers.

-

The Essential Guide to LaTeX2ε Usage (l2tabu) explains some of the most common mistakes in LaTeX usage.

-
Yeah, it's a great document, though these days several (not all) of the obsolete commands they warn against have thankfully become obscure and you wouldn't hear of them unless you read this document. :-) –  ShreevatsaR Jul 29 '10 at 15:47
Wait, \begin{displaymath} is bad? Whoohoo! I've broken a best practices in past! Now I have to map [ to something more legible for when I want something without a number beside it. –  Canageek Sep 29 '11 at 22:06
@Carnageek: \begin{displaymath} is good. $$...$$ should be replaced by it, in fact. Noting this to make sure readers don't get as confused as I was about your comment! –  Doggie52 May 2 '12 at 8:45

There was a similar question on Stack Overflow: Best practices in LaTeX [closed]

-
The question appears to have been removed. –  T. Verron Sep 8 '14 at 9:09

The AMS's Short Math Guide for LaTeX, besides being a good summary of math support (both native to (La)TeX and in the AMS's packages), includes a lot of good advice about typesetting math with LaTeX.

-
For anyone knowing German I would also recoomend the following pdf: www2.informatik.hu-berlin.de/~piefel/LaTeX-PS/V16-mathe.pdf –  matth Nov 10 '11 at 10:05

The Beamer User Guide spends a lot of time on best practices both on using the Beamer package specifically, and more generally on writing presentations. (Personally I find its tone somewhat off-puttingly preachy at times, but the advice is good.)

-
Given the number of awful presentations/seminars I've attended (with or without a computer), I find I can forgive his preachy tone! –  Loop Space Jul 29 '10 at 15:25

A. J. Hildebrand has an extensive list of very useful "best practices" LaTeX tips.

-

I just stumbled upon the booktabs manual, which discusses best practices for designing tables.

-
+1, probably the most cited reference in questions on tabulars on tex.sx :) –  doncherry Oct 16 '12 at 3:10

I'll stick in the PGF package manual as well as it contains a fair amount of advice about how to prepare graphics and what makes a good graphic.

(NB One thing I find particularly good about advice is that even if I disagree with it, it makes me think about why I disagree with it and that makes me better at whatever it is.)

-
Re the NB: this is why I especially like advice that comes with a rationale. –  Mark Meckes Jul 29 '10 at 15:32
It's by the same author as Beamer (Till Tantau) BTW. Similar good advice. :-) –  ShreevatsaR Aug 6 '10 at 4:33

This may be off-topic, but chapter 2 of the KOMA-script-guide is a good introduction to constructing a typographically sound page layout.

-
Hmmm, I'll take that "under advisement" –  Brent.Longborough Sep 29 '11 at 18:55

TeX by Topic – a TeXnician's Reference by Victor Eijkhout probably is a must read to reach unexpected results and developments.

-

This is probably a fairly niche market but Philipp Lehman's Font Installation Guide or texdoc fontinstall contains a lot of really helpful information about using fonts with LaTeX (and pdfLaTeX). In particular, it covers installing type1 fonts, although it can be fairly easily adapted to truetype fonts (pdfLaTeX only).

I think the nice thing about this guide is that it helps to make clear why things are set up in particular ways and why you should configure things in one way rather than another if you are trying to create support files for a font in LaTeX.

fontname is useful in this respect, as well, and helps decode the cryptic font names many packages use.

psnfss gives basic information about using standard type 1 fonts (as opposed to installing them).

-

I made a introduction for phd students -- I tried to show the best practise based on recent books and the discussions on the de.comp.text.tex (dctt). I also read the l2tabu.pdf of course.

Here's the material - maybe somebody finds it still useful.

It is in German but there are many code examples (LaTeX code vs. result). The handout always consists of the full code. The slides sometimes only show a partial code.

The course took about 5 hours. If you really try to do it by yourself step-by-step then you should calculate about 2-3 days.

-

The book LaTeX: A Document Preparation System by Leslie Lamport is very easy to use and contains very concise explanations with practical examples.

-