How to write math well? - MathOverflow

How to write math well?

2009-10-19T17:52:24Z

Let's learn about writing good mathematical texts.

For some people it could be especially interesting to answer about writing texts on Math Overflow, though I personally feel like I've already mastered a certain level in writing online answers while being hopelessly behind the curve in writing papers. So,

What is your advice in writing good mathematical texts, online or offline?

Answer by Michael Lugo for How to write math well?

2009-10-19T18:13:14Z

I don't feel experienced enough in mathematics writing to give advice. But I like Terry Tao's advice on writing mathematics papers; he also provides links to some other people's advice.

Answer by Scott Carter for How to write math well?

2009-10-19T18:41:30Z

One trick that my advisor, Ronnie Lee, advocated was to use a descriptive term before using the symbolic name for the object. Thus write, "the function $f$, the element $x$, the group $G$, or the subgroup $H$. Most importantly, don't expect that your reader has internalized the notation that you are using. If you introduced a symbol $\Theta_{i,j,k}(x,y,z)$ on page 2 and you don't use it again until page 5, then remind them that the subscripts of the cocycle $\Theta$ indicate one thing while the arguments $x,y,z$ indicate another.

Another trick that is suggested by literature --- and can be deadly in technical writing --- is to try and find synonyms for the objects in question. A group might be a group for a while, or later it may be giving an action. In the latter case, the set of symmetries $G$ that act on the space $X$ is given by $\ldots$. Context is important.

Vary cadence. Long sentences that contain many ideas should have shorter declarative sentences interspersed. Read your papers out loud. Do they sound repetitive?

My last piece of advice is one I have been wanting to say for a long time. Don't write your results up. Write your results down. You figure out what I mean by that.

Answer by Ferran V. for How to write math well?

2009-10-23T14:24:30Z

P.Halmos in How to write mathematics (easy to be found via your favorite www search engine) gives some nice advice. Or try Serre's exposition Writing mathematics.

Answer by Kim Greene for How to write math well?

2009-10-23T15:16:49Z

I can't say much about textbooks from the perspective of the producer, so I'll say something from the perspective of a consumer.

I like books that are good at what Terry Tao referred to as "information hiding".

http://terrytao.wordpress.com/advice-on-writing-papers/create-lemmas/ http://en.wikipedia.org/wiki/Information_hiding

My favorite textbooks somehow manage to give me all the excruciating details when I need them but only the intuitive picture when I don't.

Answer by Chris Godsil for How to write math well?

2009-10-29T02:37:23Z

Halmos's article contains a lot of good advice at the tactical level, the writing equivalent of "face your audience". This is stuff you have to get straight: if your notation is crazy then your potential readership is already zero. Fortunately this is largely a matter of acquiring good habits.

Next, you have to constantly keep your reader in mind. Whenever you are faced with a choice, ask "What would be best for my reader(s)?" It can be useful to assign someone you know well to this role, because it makes it easier to stay consistent. Remember that it is much more important to be clear than it is to be complete. Be prepared to do a lot of rewriting.

If you follow these suggestions, you will with practice become a competent writer. To become a good writer is much more difficult. Writing good mathematics is no easier, and no harder, than writing good prose on other topics. Read a lot, find good examples that you like and think carefully about why they work.

Answer by Carter Tazio Schonwald for How to write math well?

2009-10-29T02:42:35Z

There's a set of notes from a class on mathematical writing that was run by donald knuth that you can find in various locales, here's one link. Its not up to date with respect to online writing (being 20 years old), but it should still have some good gems!

Answer by mathphysicist for How to write math well?

2009-12-28T00:01:22Z

You may also wish to take a look at the references on math (and more broadly, science) writing listed here.

Answer by Jon Bannon for How to write math well?

2010-10-23T13:55:30Z

Halmos has already been mentioned, but I'd like to record the following: It may be helpful to employ spiral-writing (a-la Halmos) but at the paragraph level, rather than the chapter or section level as he suggests. So, write a paragraph, then the next one, looking back to see if the previous can be clarified in light of the one written. I suggest this because the paragraph is supposed to be the natural unit of composition, and if C.S. Peirce was right, clarity is utility. Spiral writing at this level may help not only exposit mathematics but also do mathematics. Each subsequent thought we attempt requires a better utility from what has been previously written...and the only way to guarantee such increased utility is to have attempted this subsequent thought and then carefully had a look at exactly what was needed in prior paragraphs to develop that thought.

I guess that in summary I have only two new things to add here. 1. Halmos's spiral writing is philosophically sound from the standpoint of early pragmatism, and 2. Maybe it can be effectively employed at the paragraph level instead of the section/chapter level.

Of course, Halmos suggests writing a chapter at a sitting as a way to fight inertia...so my second suggestion in the previous paragraph may not be actually better, only personal.

Anyhow, I was going to record this thought in my own personal notes, but thought maybe someone else may have a use for it as well.

Answer by Priyavrat Deshpande for How to write math well?

2010-10-27T22:41:29Z

Currently I am reading the book "A primer of Mathematical writing" by Steven Krantz. I have found it extremely useful. It is helping me with my thesis and 2 papers. The book covers everything from grammar, writing papers, CV, grants, job applications, books, book reviews, referee report, expositions also technical aspects like bibliography, index, appendix and even time management.

The book is published by AMS, here is the amazon link.