Writing tips for LaTeX writers who want to convert to DocOnce and generate other formats

• doconce latex2doconce helps the translation
• Use \[ \], equation, equation*, align, align* and nothing more for equations
• Figures: avoid subfigures (combine image files instead), use \includegraphics, have captions after graphics, use short figure captions, position exactly where needed
• Tables: have them inline (not floating), with no caption
• Computer codes: have them inline (not floating)
• Rewrite all pageref commands
• Do not use algorithm environments, use simple list formatting instead
• Avoid math in section headings
• Use pdflatex or xetex
• Use BibTeX (can easily be converted to publish used by DocOnce)
• Use \href for links (and insert links frequently)
• Use the bm package for boldface \( \boldsymbol{u} \)
• Place all newcommands in a separate file, with one definition per line (multiline definitions goes to a separate LaTeX preamble file in DocOnce)
• Avoid all fancy LaTeX constructs - more backslashes than needed in math and sections is a bad thing...