Skip to main content
AmigoFish

Drink Me, Eat Me, README: What Programmers Learned from Alice in Wonderland

From Found in the Machine · · 7 min

This plays from the publisher's own server. We do not host a copy.

Open at the source

Not rated yet

Description

Listeners, please note that this episode was recorded before the show’s name changed to Found in the Machine, so you’ll hear the old name in this episode.

Every software project has one. It's easy to scroll past. Most of the time it's just a manual telling you system requirements, installation steps, and known bugs.

But the README file owes a debt to Lewis Carroll, and a quiet trick built into its name that has been manipulating computers for decades.

In this episode, we follow the README from its earliest appearances through the conventions that made it a standard, and to the programmers who decided it could be much more than documentation.

In this episode

- Alice's Adventures in Wonderland - the literary origin programmers point to as inspiration

- The ASCII trick - the quiet reason README is written in all capitals

- The printer in the woods - a README that went somewhere unexpected

Episode Music

- Jay Opie / Nihilore, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)- "Dasein (https://www.nihilore.com/experimental/#itemId=57f5e973b8a79ba9451501cd)"

- "Scarecrow (https://www.nihilore.com/house/#itemId=62d0f6c77fcca11a63453f1a)" by James Opie / Nihilore, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)

- "Found Poetry (https://www.nihilore.com/latest-tracks/2023/4/20/found-poetry?rq=Found%20Poetry)" by James Opie / Nihilore, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)

Additional Reading

Raymond, E. S. (Ed.). (2003). README file. In The Jargon File (Version 4.4.7). http://catb.org/jargon/html/R/README-file.html

[ADG]. (ca. 1981). README.TXT [Software documentation, DECUS program 20-0079]. DECUS. https://pdp-10.trailing-edge.com/decus_20tap3_198111/01/decus/20-0079/readme.txt.html

Yokota, E. [eed3si9n]. (2012, October 19). README [GitHub Gist]. https://gist.github.com/eed3si9n/3920236

--

Support the show (https://foundinthemachine.com/support/)

💚

This show is independently produced. You can support the show by joining the show's Patreon (https://www.patreon.com/16603131/join). Patreon members get access to "Found in the Margins" bonus episodes and help make the show possible. You can also donate via Buy Me a Coffee (https://buymeacoffee.com/foundinthemachine).

If you enjoyed this episode, please consider leaving a rating and review on Apple Podcasts (https://podcasts.apple.com/podcast/id1879625858) or Spotify (https://open.spotify.com/show/6uynqSYhuncCaMYvHvlS8D?si=rWV94P1kR6afZAjTpGiZ5A). And don't forget to sign up to receive Notes from the Machine (https://notes.foundinthemachine.com/#/portal) with each episode.

Back to Found in the Machine · Report a problem