Writing resources
Mathematical and scientific documents should be as clear and straightforward as possible. On this page I’m building up a list of advice on good writing.
Skip to: mathematical writing, scientific writing, proofreading marks.
General English writing advice
The UW-Madison Writer’s Handbook. In particular the parts on clear, concise sentences and how to proofread.
More on clear and concise sentences from Sharon Goldwater.
If you are unsure whether you are using the correct word, a good place to check is Paul Brians’ Common Errors in English Usage.
A Guide to Grammar and Style, by Jack Lynch.
Try to ignore ‘fluff’, padding that makes your writing weaker. A short missive from Andrew Gelman.
Breaking the rules: I don’t agree with every single recommendation in the above guides. You may enjoy a rant about the widely-recommended guide by Strunk and White. George Orwell (1946) wrote an impassioned argument for clear writing, which gave the rule “Break any of these rules sooner than say anything outright barbarous”.
Don’t make the reader work hard
At every scale of your document (chapter/section/paragraph/sentence) a clear point should be apparent. Be able to answer the question: “What is the message in this section/paper/figure/chapter?”. Ideally your answer could be pointing to a prominent part of the text. The links between each of your points should also be made explicit.
Certain words and phrases often indicate sloppy writing or thinking:
- This means: Unqualified use of the word ‘this’ is often a vague reference to the whole previous sentence or paragraph. Try making the point more precise by saying “This large variance…”, “This reduction in complexity…”, or whatever is appropriate.
- Similar to: Do not say that method X is similar to method Y, without qualification. Instead say how they relate or differ.
Give the reader concrete information. Don’t declare that a topic is interesting, or important; demonstrate the interest or importance. Don’t say that “more work needs to be done”; detail the limitations of a method and possible avenues for research. If you don’t have any information or real content to convey, don’t write anything and move on. See point 4 of a letter by C. S. Lewis.
Mathematical writing
See the Mathematical Writing course notes, from Donald Knuth’s 1987 course at Stanford. To get a PDF, you could run pdftex on the source, or if lazy get an older version of the PDF from here.
There’s lots of good advice in those course notes. Here’s one piece that has stuck with me:
Many readers will skim over formulas on their first reading of your exposition. Therefore, your sentences should flow smoothly when all but the simplest formulas are replaced by “blah” or some other grunting noise.
A general principle: don’t make your reader parse, understand and remember your mathematical notation. Give them the main ideas in English, so that they could almost fill in the mathematics themselves.
Scientific writing
Some notes from an Edinburgh course on writing a literature review. Some of the advice is only for literature reviews, but most of it applies generally.
Proofreading marks
If I or someone else has scribbled over your document, it can be useful to know some standard proofreading marks. I only use two non-obvious marks extensively: 1) I use a loop through two words to say “swap these”. 2) I often make mistakes and write “stet” to mean “sorry, ignore the scribblings here”.