Writing mathematics literature for pedantics (and students)

Who this is for

This is meant as a collection of suggestions for anyone wanting to write a book on advanced mathematics, and wants to minimize the confusion of their readers and make their learning experience less stressful, less confusing and hence more effective from the perspective of the student.

Make new terms easy to find

A student needs to learn a lot of definitions and their terms. And a new term will not make any sense it is highly confusing to encounter a new term unless it is precisely defined, so please define a term before it is used the first time. Most will not remember each definition right away and will need to reread it, possibly several times, before it is internalized. So, make definitions easy to find on the page (i.e. use a definition box) and every time a term is defined, add it to the index. And there absolutely should be an index.

An example of a book that uses a new term (e.g. additive functor) before it is defined is

648 {648:PBHRE9G5} 1 apa 50 default 376 https://eccentric.dk/wp-content/plugins/zotpress/
%7B%22status%22%3A%22success%22%2C%22updateneeded%22%3Afalse%2C%22instance%22%3Afalse%2C%22meta%22%3A%7B%22request_last%22%3A0%2C%22request_next%22%3A0%2C%22used_cache%22%3Atrue%7D%2C%22data%22%3A%5B%7B%22key%22%3A%22PBHRE9G5%22%2C%22library%22%3A%7B%22id%22%3A648%7D%2C%22meta%22%3A%7B%22creatorSummary%22%3A%22Rotman%22%2C%22parsedDate%22%3A%222009%22%2C%22numChildren%22%3A2%7D%2C%22bib%22%3A%22%26lt%3Bdiv%20class%3D%26quot%3Bcsl-bib-body%26quot%3B%20style%3D%26quot%3Bline-height%3A%202%3B%20padding-left%3A%201em%3B%20text-indent%3A-1em%3B%26quot%3B%26gt%3B%5Cn%20%20%26lt%3Bdiv%20class%3D%26quot%3Bcsl-entry%26quot%3B%26gt%3BRotman%2C%20J.%20J.%20%282009%29.%20%26lt%3Bi%26gt%3BAn%20Introduction%20to%20Homological%20Algebra%26lt%3B%5C%2Fi%26gt%3B.%20Springer%20New%20York.%20https%3A%5C%2F%5C%2Fdoi.org%5C%2F10.1007%5C%2Fb98977%26lt%3B%5C%2Fdiv%26gt%3B%5Cn%26lt%3B%5C%2Fdiv%26gt%3B%22%2C%22data%22%3A%7B%22itemType%22%3A%22book%22%2C%22title%22%3A%22An%20Introduction%20to%20Homological%20Algebra%22%2C%22creators%22%3A%5B%7B%22creatorType%22%3A%22author%22%2C%22firstName%22%3A%22Joseph%20J.%22%2C%22lastName%22%3A%22Rotman%22%7D%5D%2C%22abstractNote%22%3A%22%22%2C%22date%22%3A%222009%22%2C%22language%22%3A%22en%22%2C%22ISBN%22%3A%22978-0-387-24527-0%20978-0-387-68324-9%22%2C%22url%22%3A%22https%3A%5C%2F%5C%2Flink.springer.com%5C%2F10.1007%5C%2Fb98977%22%2C%22collections%22%3A%5B%22NPVY6HRJ%22%5D%2C%22dateModified%22%3A%222025-06-21T21%3A06%3A28Z%22%7D%7D%5D%7D
Rotman, J. J. (2009). An Introduction to Homological Algebra. Springer New York. https://doi.org/10.1007/b98977

Enable navigation by numbering

Speaking of definitions, when numbering definitions, theorems, lemmas, examples etc, they should have the same counter. If one is looking for a specific box, it it much easier to orient oneself with respect to where what one is looking for is, if you can turn to the approximate location and if theorem/lemma/example 1.8 is on that page, you know that definition 1.3 is on an earlier page.

An example of a book that has separate counters is

648 {648:IDYZ6ZSY} 1 apa 50 default 376 https://eccentric.dk/wp-content/plugins/zotpress/
%7B%22status%22%3A%22success%22%2C%22updateneeded%22%3Afalse%2C%22instance%22%3Afalse%2C%22meta%22%3A%7B%22request_last%22%3A0%2C%22request_next%22%3A0%2C%22used_cache%22%3Atrue%7D%2C%22data%22%3A%5B%7B%22key%22%3A%22IDYZ6ZSY%22%2C%22library%22%3A%7B%22id%22%3A648%7D%2C%22meta%22%3A%7B%22creatorSummary%22%3A%22Fulton%22%2C%22parsedDate%22%3A%221998%22%2C%22numChildren%22%3A2%7D%2C%22bib%22%3A%22%26lt%3Bdiv%20class%3D%26quot%3Bcsl-bib-body%26quot%3B%20style%3D%26quot%3Bline-height%3A%202%3B%20padding-left%3A%201em%3B%20text-indent%3A-1em%3B%26quot%3B%26gt%3B%5Cn%20%20%26lt%3Bdiv%20class%3D%26quot%3Bcsl-entry%26quot%3B%26gt%3BFulton%2C%20W.%20%281998%29.%20%26lt%3Bi%26gt%3BIntersection%20Theory%26lt%3B%5C%2Fi%26gt%3B.%20Springer%20New%20York.%20https%3A%5C%2F%5C%2Fdoi.org%5C%2F10.1007%5C%2F978-1-4612-1700-8%26lt%3B%5C%2Fdiv%26gt%3B%5Cn%26lt%3B%5C%2Fdiv%26gt%3B%22%2C%22data%22%3A%7B%22itemType%22%3A%22book%22%2C%22title%22%3A%22Intersection%20Theory%22%2C%22creators%22%3A%5B%7B%22creatorType%22%3A%22author%22%2C%22firstName%22%3A%22William%22%2C%22lastName%22%3A%22Fulton%22%7D%5D%2C%22abstractNote%22%3A%22%22%2C%22date%22%3A%221998%22%2C%22language%22%3A%22en%22%2C%22ISBN%22%3A%22978-0-387-98549-7%20978-1-4612-1700-8%22%2C%22url%22%3A%22http%3A%5C%2F%5C%2Flink.springer.com%5C%2F10.1007%5C%2F978-1-4612-1700-8%22%2C%22collections%22%3A%5B%22YVRR3QR2%22%5D%2C%22dateModified%22%3A%222025-06-22T14%3A49%3A14Z%22%7D%7D%5D%7D
Fulton, W. (1998). Intersection Theory. Springer New York. https://doi.org/10.1007/978-1-4612-1700-8

Do not hide important stuff

Definitions and and even simple results of a certain generality and importance should not be be marked as an example or, for that matter, a remark. A student has a to prioritize their time, and the author should make this easier rather than penalizing a reader for skipping material that (appears as if it) is not needed for a full understanding.

An example is Gathmann’s otherwise very good lecture notes on algebraic geometry https://agag-gathmann.math.rptu.de/class/alggeom-2021/alggeom-2021.pdf. His (also, otherwise very good) notes on Commutative Algebra is also an example of this phenomena.

Don’t give unhelpful hints

It has happened more than once that the hint(s) given for an exercise has made the problem harder to solve, which (I assume) is not the intention, and is supremely frustrating.

An example of a book where this sometimes occurs is

648 {648:GVYTZ92Z} 1 apa 50 default 376 https://eccentric.dk/wp-content/plugins/zotpress/
%7B%22status%22%3A%22success%22%2C%22updateneeded%22%3Afalse%2C%22instance%22%3Afalse%2C%22meta%22%3A%7B%22request_last%22%3A0%2C%22request_next%22%3A0%2C%22used_cache%22%3Atrue%7D%2C%22data%22%3A%5B%7B%22key%22%3A%22GVYTZ92Z%22%2C%22library%22%3A%7B%22id%22%3A648%7D%2C%22meta%22%3A%7B%22creatorSummary%22%3A%22Bosch%22%2C%22parsedDate%22%3A%222022%22%2C%22numChildren%22%3A1%7D%2C%22bib%22%3A%22%26lt%3Bdiv%20class%3D%26quot%3Bcsl-bib-body%26quot%3B%20style%3D%26quot%3Bline-height%3A%202%3B%20padding-left%3A%201em%3B%20text-indent%3A-1em%3B%26quot%3B%26gt%3B%5Cn%20%20%26lt%3Bdiv%20class%3D%26quot%3Bcsl-entry%26quot%3B%26gt%3BBosch%2C%20S.%20%282022%29.%20%26lt%3Bi%26gt%3BAlgebraic%20Geometry%20and%20Commutative%20Algebra%26lt%3B%5C%2Fi%26gt%3B.%20Springer%20London.%20https%3A%5C%2F%5C%2Fdoi.org%5C%2F10.1007%5C%2F978-1-4471-7523-0%26lt%3B%5C%2Fdiv%26gt%3B%5Cn%26lt%3B%5C%2Fdiv%26gt%3B%22%2C%22data%22%3A%7B%22itemType%22%3A%22book%22%2C%22title%22%3A%22Algebraic%20Geometry%20and%20Commutative%20Algebra%22%2C%22creators%22%3A%5B%7B%22creatorType%22%3A%22author%22%2C%22firstName%22%3A%22Siegfried%22%2C%22lastName%22%3A%22Bosch%22%7D%5D%2C%22abstractNote%22%3A%22%22%2C%22date%22%3A%222022%22%2C%22language%22%3A%22en%22%2C%22ISBN%22%3A%22978-1-4471-7522-3%20978-1-4471-7523-0%22%2C%22url%22%3A%22https%3A%5C%2F%5C%2Flink.springer.com%5C%2F10.1007%5C%2F978-1-4471-7523-0%22%2C%22collections%22%3A%5B%22A6EKE3VU%22%2C%22HTFU6U95%22%2C%22YVRR3QR2%22%5D%2C%22dateModified%22%3A%222025-01-27T11%3A18%3A22Z%22%7D%7D%5D%7D
Bosch, S. (2022). Algebraic Geometry and Commutative Algebra. Springer London. https://doi.org/10.1007/978-1-4471-7523-0