About these notes

Hi! I’m Andy Matuschak. You’ve stumbled upon my working notes. They’re kind of strange, so some context might help.

These notes are mostly written for myself: they’re roughly my thinking environment (Evergreen notes; My morning writing practice). But I’m sharing them publicly as an experiment (Work with the garage door up). If a note seems confusing or under-explained, it’s probably because I didn’t write it for you! Sorry—that’s sort of an essential tension of this experiment (Write notes for yourself by default, disregarding audience).

For now, there’s no index or navigational aids: you’ll need to follow a link to some starting point. You might be interested in §What’s top of mind.

👋 Andy (email, Twitter, main personal site)

PS: My work is made possible by a crowd-funded research grant from my Patreon community. You can become a member to support future work, and to read patron-only updates and previews of upcoming projects.

PS: Many people ask, so I’ll just note here: no, I haven’t made this system available for others to use. It’s still an early research environment, and Premature scaling can stunt system iteration.

Taxonomy of note types

==TODO: flesh this out; write a note for each note type; etc==

For me, the practice of writing and revising notes is, at its core, about trying to move up the following rough ladder:

• Ephemeral scratchings in Daily working log
• Prompts and incomplete notes in writing inbox (A writing inbox for transient and incomplete notes), which are meant to possibly become Evergreen notes. These prompts may accumulate writing over time via spaced repetition (see Spaced repetition may be a helpful tool to incrementally develop inklings)
• Evergreen notes, in increasingly complex stages of development:
  • stubs implicitly defined through backlinks (Backlinks can be used to implicitly define nodes in knowledge management systems); e.g. Note-writing system, Audiobooks
  • simple definitions for terms of art, little of my own added; e.g. Span of absolute judgment, Spacing effect
  • Bridge notes narrowly relate two adjacent terms
  • precise, narrow declarative notes (Prefer note titles with complete phrases to sharpen claims); e.g. Human channel capacity increases with stimulus dimensionality
  • sometimes these are framed as questions, when evidence is too inconclusive to frame sharply; e.g. To what extent is exceptional ability heritable?, To what extent can application prompts supplant recall prompts in the mnemonic medium?
  • higher-level APIs (Evergreen note titles are like APIs)
  • notes abstracting over many other notes, e.g. Educational games are a doomed approach to creating enabling environments, Reading texts on computers is unpleasant
  • personal terms of art, e.g. Enacted experience
• “Outline notes”, e.g. §Enabling environments, games, and the Primer

Note types outside this ladder:

• Proper noun notes
  • “Literature notes”, titled after a single work and meant primarily as linkages to other more durable notes, and as targets for backlinks. I write these roughly as “outline notes,” except for someone else’s ideas. For example: Miller - The magical number seven, plus or minus two
  • Likewise, but less commonly, I also have “person notes” (e.g. Anand Agarawala) and “business notes” (e.g. Confluent)
  • These note types are weakly evergreen. I may add to them over time, but because they aren’t concept-oriented (Evergreen notes should be concept-oriented), they’re not as useful to build on as an evergreen note. Non-trivial writing about proper nouns typically gets factored into separate evergreen notes which can be used in multiple places.
  • “Log” notes, which accumulate ephemeral observations about a specific practice, system, or project over time. They’re akin to a Daily working log, but sliced by some topic of interest rather than by date. e.g. Log: personal mnemonic medium
  • With better transclusion or support for Contextual backlinks, such notes could be written directly in one’s Daily working log, and “log” notes could be defined as a query over such notes.

Tactically speaking, I usually denote a note’s “type” with a tag.

Don’t over-obsess or over-formalize this stuff. Remember: “Better note-taking” misses the point; what matters is “better thinking”.