On good writing

Crisp writing is an underrated skill. Good writing implies clear thinking, and clear thinking is invaluable. Here I collect resources that I keep visiting over and over.

Guidelines

• It is always about the people.
• "Something must be at stake".
• Capture the larger story.
• Write about at most one big thing.
• Be relevant.
• Be relatable.
• Be conversational.
• Make it happening.
• Use metaphors!
• Stick your landing, most interesting elements towards the end.
• Simple words, clear ideas, and short sentences.
• Don't shy away from complex ideas.
• Do not overestimate what the reader knows.
• Do not underestimate the reader's intelligence.

Mechanics

• Use passive voice sparingly.
• Narrative over lists.
• Nouns not adjectives.
• Cut mercilessly.
• Callbacks.

Resources

General Communication

• Politics and the English Language by George Orwell
• Writing, Briefly by Paul Graham

• Chekhov's gun
• How to write in plain English
• The Writing Well Handbook by Julian Shapiro
• Writing resources by Iain Murray

Mathematical Writing

• How to write a great research paper by Simon Peyton Jones
• How to read a paper by Srinivasan Keshav
• Mathematical Writing by Donald E. Knuth, Tracy Larrabee, and Paul M. Roberts
• I Want To Be a Mathematician: A Conversation with Paul Halmos
• [Handbook for Writers]https://saylordotorg.github.io/text_handbook-for-writers/ by Andy Schmitz

Speech

• How to give a great research talk by Simon Peyton Jones
• How To Speak by Patrick Winston

Strunk's Rules

This is a summary from the excellent book by William Strunk Jr._, The Elements of Style.

• [Rule 1] Always use 's (appostrophe s) to form singular possessive nouns. Some ancient proper nouns ending in -es or -is are an exception but the sentence can be restructured to sound better.

  Moses' laws can be rewritten as the law of Moses.

• [Rule 2] With a series of comma-separated terms, no need for the last one.

  supervised, unsupervised, and reinforcement learning.

• [Rule 3] Parenthetic expressions can be enclosed in commas. These must, however, be used sparingly. Often, one can compromise on succinctness and break such phrases into multiple independent statements.

  Linear regression, one of the most popular methods, is an example of supervised learning.

• [Rule 4] In some sentences, connectors and or but do not explicitly define the relation between connected clauses. Instead, the sentences can be structured better using explicit relational qualifiers like although, while, etc.

  Linear regression is a regression method, but logistic regression is a classification method v/s While linear regression is a regression method, logistic regression is a classification method.

• [Rule 5] A single compound sentence composed of complete clauses can be connected using a semi-colon ";" instead of a full stop; this is helpful to disambiguate pronouns like this, they, it, etc. Alternatively, we can fall back to using commas as usual with proper relational qualifiers.
• [Rule 9] A paragraph should either denote a single unit in a composition or signal a new development of the subject from the previous paragraph. Single sentence paragraphs should be used sparingly, only as a connecting thread between the predecessor and successor.
• [Rule 10] Within a paragraph, the first sentence can be the topic sentence, and the final sentence can emphasize a consequence of the discussion. Although, violating this thumb rule often breaks the monotony for the reader.
• [Rule 11] Use active voice to enforce directness.
• [Rule 12] Use positive statements; limit the use of not qualifiers.
• [Rule 13] Omit needless words.

  She is the one who should be replaced by She.

• [Rule 15] Express co-ordinate ideas in similar form. Correlative expressions should be followed by the same grammatical construction.

  the Bayesians and frequentists should be the Bayesians and the frequentists

• [Rule 16] Keep related words together. Parenthetic clauses can be transferred to the beginning of a sentence to avoid reading interruptions.
• [Rule 18] The proper place for emphatic words, which the writer desires to make most prominent, is towards the end of a sentence.

  Neural networks have hardly advanced our understanding of the human brain, though they are behind many breakthroughs in computer vision. v/s Neural networks are behind many breakthroughs in computer vision, but they have hardly advanced our understanding of the human brain.