What goes in a README?

& (verbiage overflow)Thu 01 December 2016RSS

In my job I spend a lot of time reading other people’s GitHub accounts — poking through their code and sometimes installing it to try out. Many README files are too sparse to be useful to me in that. As a result I have to spend time on my own, figuring out what’s going on in the code, or else abandon the effort. If I abandon the effort, I then have to fight the temptation to assume the programmer is lazy or the code isn’t finished. That outcome is not ideal if my reason for reading the code was to evaluate the programmer’s skill and attention to detail.

A README isn’t just designed for other users encountering your code for the first time; it will also be useful to you after you’ve been away from the project for a while — if you’re like most people, you’ll have forgotten a lot about it by then.

Below are the things I look for in a repository README file.

  1. What the project does.

    Even if there isn’t anything else in the README itself, a link to any separate documentation site can go here, as can a statement of any software license covering the code.

  2. How to install it, including dependencies.

    Be aware that you may be relying on dependencies that were put in place long ago, and that you’ve forgotten about. The user needs to know about them, though. One way you can make sure you have all dependencies accounted for is to write a script to populate a container for tools such as Vagrant or Docker. You should also mention what operating systems the project has been tested on, because that is a kind of dependency, too.

  3. How to run the code.

    You should illustrate, even if it is obvious to you. If there are separate compilation or linking steps, show them; if your code is meant to be run in a REPL or browser console, say so here.

    This is also the place to name the main sorts of functionality provided by the project, and to illustrate them. Remember, after time passes, you may have trouble remembering what you’ve actually built here.

  4. Discussion and references.

    If the project is meant to display your skills, in the manner of a portfolio, it would be nice to hear about design decisions, surprises you encountered, and anything of interest you learned while doing the project. If there are external sources that were useful to you, cite them here. If there are people to thank, you might do that here, too.

  5. Work still to be done, known bugs, future plans.

Not all of this has to go into one huge README file. You can put separate sections into separate files — if there are two or more of them, you may like to place them in a directory called doc or something similarly suggestive. Nor does a README have to be exhaustive — but it should address the several headings I’ve listed above.


Comments are enabled.

All prior articles

  1. Self-segregation
  2. Python decorators for object-oriented method behaviors
  3. The English Level of This Year's Principal Presidential Candidates
  4. Chao on Wenyan
  5. Face 面子
  6. Some Questions about the Recurse Center
  7. De-duplicate Apple Calendars on Mavericks
  8. Transcribing Voice Recordings on OS X, 3 — another example
  9. Transcribing Voice Recordings on OS X, 2 — more examples
  10. Transcribing Voice Recordings on OS X
  11. The Pre-Morse Origin of Two Morse Code Symbols
  12. “The Man Who Knew Infinity” — 2015 movie about Ramanujan
  13. Why does Python have two ways to filter a comprehension?
  14. There is no ternary operator in Python
  15. Does Fortran have a two-way decision function?
  16. Debugging the Art Museum
  17. Learning to Throw Books Away
  18. About Me
  19. Walter Murch on Standing at Work
  20. “Our Kind of Story”
  21. Revisiting the Taiwan national anthem
  22. Review of Button, Phonetic Ambiguity in the Chinese Script
  23. Importing Modules under Pytest
  24. Two Git Accounts on One Computer
  25. Pytest parametrization — passing multiple data-items to a single test
  26. Markdown Basic References
  27. Two Curious Things about screen.width and screen.height on Mobile Firefox and under iOS.
  28. Where Do I Stand on Digital Advertising?
  29. Progressing to the Next Level after Two Years at Hacker School
  30. Health Insurance $5,600/year ⇨ $12,600/year to Keep Our Doctor
  31. Always Use Dry-run Options If Possible
  32. Basic Interaction with Man-pages
  33. Taiwanese Cantillation Prosody and the Standard Tradition of Regulated Verse
  34. Automated Transcription of a Lyric’s Melody
  35. Quote-Unquote: Quick Python Conversion to and from URI Standard Format
  36. Literate Code in Crista Lopes’s Exercises in Programming Style
  37. Special Computer Help for an Uncooperative Person in Need
  38. Richard Bellman on Multistage Decision Processes
  39. Contradictory Advice from Kenkō about Studying after Mid-life
  40. Deceit for my Mother’s Sake
  41. New York State’s Law on Intercoms
  42. Our Relationship with Unwelcome Callers
  43. Reasons to Keep a Landline Phone
  44. Chinese (Pinyin) Tone Marks on Macintosh
  45. Suicide by Holding the Breath in the Greek Classics
  46. Transcribing a Solo Voice Recording to Western Musical Notation
  47. Surprise Text Message Sent by Google Voice
  48. Trimming a Git Repo before Moving It to GitHub
  49. The Sage Chilōn on Gesticulation
  50. Examining the Identity of a “Whole-Sliced” Python Sequence
  51. Pagerank after Completing the Move of My Blog
  52. Haydn on Originality
  53. Stages of Life
  54. Linguistic Naturalism in Behavior-Driven Development
  55. Some Advice on Interviewing in China
  56. The AARP on Ageism
  57. The Cash Value of a Lost Moment
  58. How Did 釁 Get Into My Computer? A Talk at CSTUY
  59. I Knock My Head on the Ground: Review of Richter, Letters and Epistolary Culture in Early Medieval China
  60. Two Pair of Suspenders Back to Amazon
  61. Knuth on the Direction of the Tree in Computer Science
  62. Py3K Versions of Networking Programs for the Rhodes and Goerzen Book
  63. A Fake Monk in Times Square
  64. Werner Herzog on the jungle’s “articulate obscenity”, “misery”, and “sort of harmony of collective murder”
  65. Hacker School and How we Learn
  66. Hacker School Sees “The Internet’s Own Boy”
  67. Two Chinese manifestations of black cardamom
  68. A natural-language URL shortener
  69. Recovering Web and Search visibility after Leaving WordPress
  70. Greedy evaluation in Python's default dictionary
  71. Trying to Change Google Pagerank after Moving my Blog
  72. Ensuring my blog is indexed by Google, using Webmaster Tools
  73. 'Dependency' in programming means the opposite of its traditional meaning
  74. Experimenting with a Site-Analytics Tracker
  75. Unexpected Behavior from the Python 3 Built-In Hash Function
  76. Rote learning and programming
  77. r0ml on the workspace-based, image-oriented programming paradigm
  78. In technology, knowing your vulnerabilities is a desirable strength
  79. The Lingering Puzzle of yán 焉
  80. My grandmother’s diaries
  81. Scholarly Presentation: Arousing something other than polite interest
  82. Friedrich Gulda's Beethoven
  83. Reaction to Jaron Lanier Talk at Cooper Union
  84. Yuen Ren Chao on Chanting Chinese Poetry
  85. The legal requirement of having a camera inside a NYC taxicab
  86. This blog has moved
  87. "Web of Trust" in Chinese and Japanese
  88. Taking the larger view of frustrations with technology
  89. Reflecting on Bernard Baruch, on the need for character and thinking
  90. Dinner with a Bletchley Park cryptographer
  91. Karl Popper on conflict between your basic assumptions and those of your interlocutor (1965)
  92. My Hacker School Pairing Interview
  93. Thirty political parties fielding candidates in New York City this election
  94. The world's only speaker of standard Mandarin in 1923
  95. Data within literal curly brackets using Python format()
  96. The Imperative Style in Commits and Docstrings
  97. Git overwrites file metadata including creation and modification date
  98. Two complaints and one word of praise about GitHub Flavored Markdown
  99. Lǐ Bái on time (8th century)
  100. Two bits of trivia from the Institute for Advanced Study
  101. Karl Popper against foundations of knowledge (1965)
  102. George Orwell on falsification of fact (1946)
  103. Loss of innocence for "ggg"
  104. George Orwell against uniformity of political principles (1946)
  105. Library technology at the Institute for Advanced Study
  106. Richard Feynman on scientific integrity (1974)
  107. Richard Feynman on ignorance of science (1964)
  108. Tense in Git Commit Messages
  109. A better plan is needed for transporting equipment in the subway
  110. "Premature optimization" as phrased by Musashi
  111. Finding and returning zero or one of a marked sub-expression in Python regex
  112. A faster Python sort
  113. A question about time complexity when testing membership in a Python nested sequence
  114. Rendering a matrix as a linear array
  115. Attempting a generic SQL INSERT statement in Python
  116. Welsh bwg 'bogey': an alternate proposal about the origin of "computer bug"
  117. Using python str.format(*args) when the cardinality of *args is unknown
  118. Compelled by forces I can no longer resist…
  119. Highlights of the July, 2013, NY Tech Meetup
  120. Review of Zádrapa posted
  121. Now filtering (> /dev/null) some spam before it reaches the Gmail Spam folder
  122. Isaac Newton, creationist
  123. Freeman-Halton 3x3 exact test
  124. Conjure me: reentering the zone of proximal development
  125. Python extend() without a list comprehension
  126. The name "Hacker School"
  127. The benefits of Hacker School
  128. Another two subway rules of thumb illustrated
  129. Short-circuiting and (and ==) instead of if in Python
  130. Quintilian on time and study
  131. Kenkō on time and study
  132. George Orwell on keeping a diary to cultivate dispassionate thinking
  133. A bon mot of Quintilian on theory
  134. Growth of outlook at Hacker School
  135. Nakamoto Satoshi, the name of Bitcoin's inventor
  136. The psychology of pairing and code review at Hacker School
  137. Computer science and rugelach
  138. Is Hacker School like graduate school?
  139. Why do I work so hard at Hacker School?
  140. Hacker School compared with studying computer science at City College
  141. Differences between code and natural language
  142. Hacker School after six weeks
  143. Pairing at Hacker School
  144. The Norman Manchu dictionary has reached Seattle
  145. Jerry Norman's Manchu dictionary has appeared
  146. Two things I am thinking about as Hacker School begins
  147. The white powder on the pages of library books
  148. Non-math uses of LaTeX
  149. Hacker School
  150. Hacker School (dojo/recruiter for programmers) begins in four days
  151. Dependencies for scipy and matplotlib not handled by pip
  152. The National Do Not Call Registry no longer works well
  153. Early evidence of a dislike of Christmas music?
  154. Plinyesque Christmas wishes to all
  155. Getting the Android GridView sample code to work
  156. A small triumph of explicitly readable code
  157. Godfrey Reggio on technology in life (2002)
  158. Max Weber: "science is the affair of an intellectual aristocracy" (1918)
  159. First day of Android coding: two problems solved
  160. Black optimism explained
  161. Talking across the pre- and post-computer border
  162. Getting used to the disappearance of old institutional models
  163. Anything less than perfect is a failing grade
  164. Recovering from hurricane Sandy
  165. Max Weber on meritocracy in academia (1918)
  166. Our state of things in New York right now (after hurricane Sandy)
  167. Max Weber on the "strange intoxication" of a passionate vocational devotion (1918)
  168. LaTeX's extract package, used for isolating the contents of environments and commands
  169. Fellini movie "Broadway Bomb" being filmed in my neighborhood
  170. Does Apple view an "iPhone" phone number as something different from a "mobile" phone number?
  171. Columbia University Libraries finally removing the card catalog
  172. One more rule of thumb for the New York subway
  173. Two further rules of thumb for the New York subway
  174. Two inches taller in two years
  175. Alternate ways to say "pop" and "push" in computer science
  176. Poulenc's Dialogues des Carmélites at the Dell' Arte Opera Ensemble
  177. Andrew Nathan on Doh Chull Shin on Confucianism and Democratization (2012)
  178. Proofreading poorly OCRed material
  179. New York State redistricting maps on line at CUNY's Center for Urban Research
  180. Karl Berry on free software (2005)
  181. The SEC on the utility of Python as a secure and accessible tool for generating official reports (2010)
  182. Hill Country
  183. Yogurt whey-starter pickled (soured) mackerel
  184. Images (figures) on facing pages in a LaTeX document
  185. Just what is being centrally limited in the "Central Limit Theorem"?
  186. Reloading modified code when using the Ipython interactive shell
  187. Alistair Cooke on H. L. Mencken's typing (1956, 1977)
  188. Jerry Norman (1936–2012)
  189. Ptisan issues
  190. Elia Kazan on the need for selfishness
  191. "Neither side took prisoners" — Japanese and American atrocities in the Pacific theater of World War II
  192. Surprise! You have a different Congressman now but no one thought you needed to know.
  193. Another notice of the bureaucratization of academia
  194. Bogusław Jackowski on "worldwide licensing madness" (2008)
  195. Accommodating the Chinese hunger for official seals on official documents.
  196. Bond Street and a story about a smartphone
  197. Another bond to Apple is lost as MobileMe Sync is discontinued
  198. Charles Ives (1874–1954) on his life in business (1933)
  199. "Taikonaut" and the new Cold War
  200. James Lang on improving understanding and retention by increasing "cognitive disfluency" (2012)
  201. Lǔ Xùn 魯迅 (1881–1936) on the truth behind Confucian morality (1918)
  202. Ray Bradbury (1920–2012) on cars (1963)
  203. Ray Bradbury (1920–2012) on success in the arts (1963)
  204. Chinatown breakfast offerings
  205. Zed Shaw on why to use C (2011)
  206. A step in my Chinese education
  207. Age and the MBA
  208. Useful Python time formats for dealing with HTTP headers
  209. An encounter with Google's security rules
  210. HTML headers for keeping track of updated webpages
  211. William Hung 洪業 (1893–1980) on Confucianism (1980)
  212. David Daniels on one's "other voice" (1998)
  213. Elia Kazan and questions of betrayal
  214. Advice on preparing herring
  215. Two limitations of call-forwarding on Google Voice
  216. Student protests in Montréal and thoughts about tuition
  217. Call-screening in Google Voice has a problem
  218. Cortlandt Alley's Chinese name
  219. Chinatown shorthand
  220. "Download statusbar" add-on for Firefox
  221. The ceremonial gateways of Montréal's Chinatown
  222. Nailset = chasse-clou
  223. Restaurant Mai Xiang Yuan [Màixiāngyuán cānguǎn 麥香園餐館] in Montréal
  224. A bon mot of Peter Carey about reviews of one's work (2012)
  225. A bon mot of Peter Carey about New York (2012)
  226. Identifying the active bridge adapter for use with a headless virtual machine on VirtualBox
  227. Doubts about l'affaire Chén Guāngchéng 陳光誠
  228. Military officers who cannot count
  229. Parallel text and vocabulary in LaTeX
  230. A stricture on Google Voice
  231. Resolving VirtualBox error VERR_INTNET_FLT_IF_NOT_FOUND
  232. Ubuntu 12.04LTS (Precise Pangolin) on VirtualBox
  233. Recordings for Classical Chinese
  234. Arthur Luehrmann on "computer literacy" (1972)
  235. The origin of the symbol Θ (big theta) in asymptotic notation
  236. Being censored in China
  237. The experience of learning vim commands
  238. How should I rate this movie on Netflix?
  239. Netflix miscalculation — Hugo
  240. Curious vim behavior: treats date range as subtraction
  241. Alexandra Lord on the myth of the academic career (2012)
  242. Elia Kazan on getting along in society (1974)
  243. ssh unavailable over Amtrak's wifi network
  244. Tricked again by Python's mutable objects
  245. Is blocking ads theft of service?
  246. A poor analogy on intellectual property rights
  247. A mutton chop at Keen's Steakhouse
  248. An anecdote about William Hung (Hóng Yè 洪業, 1893-1980)
  249. Sorting a list of Unicode strings in Python, case-insensitively and ignoring diacritics
  250. Avoid deleting the contents of a file in Python through sloppy use of "write" mode
  251. Reloading a Python module after modifying it
  252. Frank Mittelbach on documentation (2006)
  253. Frank Mittelbach on collaboration (2006)
  254. Frank Mittelbach's "moral obligation" license for the LaTeX multicol package
  255. Keith Whalen records scales and patterns from the Slonimsky Thesaurus
  256. Calligraphy in Chinatown
  257. Manchu dictionary done
  258. Bernard Shaw (1856–1950) on the damage done by immaturity in politics
  259. Gotham breakneck to Chinatown
  260. Calculus III progresses
  261. Some Western recipe-names as transformed by the Taiwanese linguistic experience
  262. Class war against the banking and financial industry
  263. Avoiding the Emailyama
  264. Adblock Plus is the most useful piece of shareware I've ever had
  265. A less painful way to install Adblock Plus filter-subscriptions in Firefox
  266. Tales from Calculus III
  267. Jack Cheng on "the technology I grew up with" (2012)
  268. Distribution of fonts: competing models are coexisting
  269. MoinMoin for notebook-wiki (and WordPress, you are trying the patience of my affections)
  270. generate native MATLAB code from finished figures, for study
  271. Quintilian on laziness and difficulty in one's studies
  272. Guide to Gwoyeu Romatzyh 國語羅馬字 (tonal spelling for Mandarin)
  273. Guide to the radicals of the traditional Chinese dictionary
  274. Origins of the Mandarin Phonetic Symbols (注音符號/ㄅㄆㄇㄈ)
  275. Installing UCC certificate for multiple domain names hosted virtually on a single server
  276. QuickTime Pro easily concatenates .m4v video files
  277. Columbia to Chinatown walk, 20120122
  278. A local custom without the corresponding exotic saying in rural Taiwan
  279. HTTPS being rejected at Yahoo hosting
  280. Classical Chinese syllabus posted; using Landslide for markdown-to-HTML5
  281. Phonosymbolism, etymology, and the nebulous Chinese word family
  282. Simple meal at Shui Mei Café (嘎嘎叫, 67A East Broadway, NYC), formerly So Go Café)
  283. Are cell phones and bananas radioactive?
  284. LaTeX and electronic documents
  285. New definition of “algorithm”
  286. Materials used in paper bank statements
  287. Finally making progress with Vim
  288. Kenneth S. Wherry on American influence in China (1940)
  289. Propagation of a meme and a metameme
  290. Against the single time zone
  291. Hamish Milne on transcriptions of Bach (2005)
  292. Choosing a suitable site for fieldwork, and working with illiterate informants in China
  293. Yuen Ren Chao (1892–1982) urging Americans to resist Chinese telephantasmia (1921)
  294. The brown German flour of Przasnysz
  295. Recollection of the traditional bagel in central Poland before World War I
  296. Vaclav Havel (1936–2011) on doing good work (1978)
  297. Vaclav Havel (1936–2011) on the "dictatorship of technology" (1978)
  298. Vaclav Havel (1936–2011) on ideological enslavement (1978)
  299. Vaclav Havel (1936–2011) on law (1978)
  300. Vaclav Havel (1936–2011) on responsibility and a "post-democratic" system (1978)
  301. Vaclav Havel (1936–2011) on "opposition" and "dissident" (1978)
  302. Vaclav Havel (1936–2011) on ideology (1978)
  303. 'Factorial' in Chinese (jiēchéng 階乘/阶乘)
  304. Leibniz’s theodicy, dynamic programming, and strategies for learning
  305. Emanuel Derman and Paul Wilmott on mathematical models and self-delusion (2009)
  306. Y. R. Chao and Henry Sheffer added to the Mathematics Genealogy Project
  307. Two more rules of thumb for the New York subway
  308. Math in the Movies
  309. Jim Coplien on reflection and problem-solving (2011)
  310. Richard Feynman on practical applications of the theory of gravitation (1964)
  311. Karl Popper on understanding a problem (1963)
  312. Galileo on "reason conquering sense" (1632)
  313. Apparent error in Python's priority queue and heapq
  314. Literacy book finally out
  315. Y. R. Chao on his dissertation (1974)
  316. Doctoral pedigrees
  317. Lack of stable sort in Python's priority queue
  318. Suitable pots for making turmeric tea
  319. Neuro-plasticity and strategies for improving cognitive functioning: "The Brain Fitness Program" (2007)
  320. Code-switching between comfortable cognitive aptitudes and the main aptitudes used in math and coding
  321. Wishes for the Orthodox Nativity Season (began 15 November this year)
  322. Two rules of thumb about transportation in New York
  323. Pípá yā 琵琶鴨 (Frisbee Duck)
  324. Testing the reliability of the Python priority queue
  325. Edsger Dijkstra on programming as an intellectual discipline (2001)
  326. Edsger Dijkstra on the name of the field Computer Science (2001)
  327. Edsger Dijkstra on anthropomorphizing computers (2001)
  328. Edsger Dijkstra on mastery of one's native tongue as a vital programming skill (2001)
  329. Edsger Dijkstra on the origin of his shortest path algorithm (2001)
  330. Efrem Podgaits's New York Mass (2001)
  331. Anecdotal report on experimenting with creatine as a study aid
  332. "Suppose" for math proofs, in LaTeX
  333. A rule of thumb in teaching
  334. Graphing flowcharts and automata in LaTeX
  335. Perception of time and suspension of finality (studying math)
  336. Suddenly perceiving the cantus firmus in a Bach chorus
  337. Two of Elvira's arias from Don Giovanni
  338. Identifying robots among human beings
  339. Apparent misspelling in LaTeX command set: \guillemotleft and \guillemotright
  340. Table of contents in a LaTeX book: make the TOC entry different from the actual chapter headings in the text
  341. Competition and sharing in academia
  342. Kuhn and Popper
  343. Herb Gross's calculus lectures
  344. The abbreviation UTC as an acronym
  345. Clyde Haberman on validating one's authenticity as a New Yorker (2011)
  346. The era of lost words
  347. Never odd or even
  348. William Deresiewicz on multitasking and solitude (2009)
  349. Bjarne Stroustrup's advice to up-and-coming programmers (2008)
  350. Chet Ramey's advice to up-and-coming programmers (2008)
  351. Bjarne Stroustrup on the name C++ and common criticisms of the language
  352. Steve Bourne, advice to up-and-coming programmers (2009)
  353. Alfred Aho on the origins of awk (2008)
  354. Leslie Lamport on thinking first and on commenting code (2007)
  355. Pens of choice for linguistic fieldwork
  356. How I learned LaTeX
  357. Some bons mots from Edsger Dijkstra (1984)
  358. Non-paean to Steve Jobs
  359. Annotations of Cormen et al.'s algorithm for a Red-Black Tree (delete and delete-fixup functions only)
  360. John McCarthy on "Generality in Artificial Intelligence" (1987)
  361. Brian Kernighan's summary thoughts on scripting languages
  362. Changes to the inventory of IPython magic commands (v. 0.10 to 0.11)
  363. One man's calm reflection on Java-think in Python
  364. mdfind as a substitute for locate on Mac OS X
  365. Reconsider P. T. Barnum's reputation
  366. LaTeX macro for circling answers on math problem sets
  367. View of the Mariana Trench
  368. Simulating private variables in Python
  369. Choice of formats for basic code documentation
  370. Dennis Ritchie on Computer Science and Commerce (1984)
  371. Inconsistent results of the same seed in random.seed() on different Python installations
  372. An opinion on vi configuration
  373. The virtue of Vim (or: why I do not remap copy and paste)
  374. Shark fin and the economics of Chinese "face"
  375. Two funerary practices and the end of a good story
  376. An important skill for instructors
  377. p::c
  378. Twice-a-day mail delivery
  379. Portmanteau characters in Chinese (abstract)
  380. A math professor I enjoyed
  381. The state of my Netflix patronage
  382. Longevity vs. versatility of code
  383. A new kind of noise in the subway
  384. Router VI is dead
  385. Tinker Tailor remake
  386. Automated upward pricing spiral
  387. Break-in?
  388. Telephantasmia, one of the great gifts of Chinese culture
  389. September 11th sensations
  390. Whether to take a small loss or consent to the devaluation of the US dollar
  391. City checkpoint chaos
  392. Continuing opportunity for techno-elitism
  393. A worry of Donald Knuth's
  394. An opinion of TeX
  395. Advice on teaching English in China if you lack a TEFL degree
  396. "The Highline" Park
  397. Plutarch on the sensitivity and versatility of the human mind
  398. Plutarch's praise of the "fox" temperament
  399. Unagi hitsumabushi 鰻櫃まぶし
  400. My mother and me, at work on the Early China index, 20110526
  401. juémíngzǐ 決明子 tisane
  402. Brillat-Savarin on the pleasures of the fast
  403. University of Maryland, (College Park) general education rated D in a national survey
  404. The EMACS meta key and the standing desk
  405. A rule of thumb in choosing one's tools
  406. Dr. Johnson on the "fox" temperament
  407. Carl Elliott reviews Ginsberg, Fall of the Faculty (WSJ)
  408. Hard copy vs. electronic copy
  409. Deborah Ball's article on the opposition to standardizing the Romansh language (WSJ)
  410. Boris Veytsman's review of Kottwitz, LaTeX Beginner's Guide
  411. Why even 212 phone numbers calling in-area have to dial 212 first
  412. Dr. Johnson on keeping a diary
  413. Against object-oriented design (except in scripting languages)
  414. Worrying about inadequate memory to hold program and debugger (1973)
  415. Consequences of a compiler defect
  416. The Internet and scripting languages
  417. Newton's own suffering at math
  418. Fresh turmeric-root tea
  419. Appreciation of awk
  420. "Computer Science, Modern Languages Most Gender-Polarized Majors"
  421. Food issues during the Siege of Leningrad
  422. Starting a blog