science writing and communication
value Challenge›Responsibility
subject How things work›Computing & making sense of data›How science works
created 2026/04/02 modified 2026/09/19
- Nature summary paragraph example
- Cormac McCarthy's writing advice: be minimal to achieve clarity; decide on a concise theme and make sure everything supports it; one message per paragraph; use concrete examples; use natural language; write simple sentences — Nature
- Arjun Raj's words to avoid: examples of very generic verbs that don't actually mean anything, and how to better frame what you're trying to say
- Ten common statistical mistakes to watch out for when writing or reviewing a manuscript: description of common errors in publications, how to detect them, and how to fix them — eLife
- Literary forensics: "A simple diagnostic tool can help identify those writing patterns so you can focus on strengths and start to overcome weaknesses." — The Open Notebook
- Go through early drafts and look for common patterns; for new drafts, highlight these elements and question if they're being used effectively:
- Starting sentences with dependent clauses
- Using more than one adjective that means basically the same thing
- Taking a long time to get to the point — is it ever explicitly stated?
- Starting sentences and phrases with "this ___"
- Using semicolons, colons, and dashes to connect sentences
- Go through early drafts and look for common patterns; for new drafts, highlight these elements and question if they're being used effectively:
- Whitesides' Group: writing a paper: guidelines for writing a paper, how to start, making an outline, general style preferences
- Connected Papers: visualize the "connectedness" of various papers
- Nature's collection of resources on publishing
- Hemingway App — writing clarity tool
- Writing about probability — The Open Notebook
- Demystifying Public Speaking — Lara Hogan (free e-book)
- Tools for Science — Arjun Raj
Methods section template
For calculations: "To assess X, we calculated Y (summary of what Y is). Specifically, we calculated ..."