2020-08-26 > [!ai]+ AI > > *AI summary of this note generated at 2024-09-22 10:02 AM* > ##### Evergreen note titles should be like APIs > This note discusses the importance of well-crafted titles for evergreen notes. The main points are: > 1. Properly factored and titled notes serve as abstractions for the entire note's content. > 2. Good titles allow for easy referencing of complex ideas. > 3. Effective note "API design" techniques include: > - Separation of concerns ([[Evergreen notes should be atomic]]) > - Sharp titles ([[Prefer note titles with complete phrases to sharpen claims]]) > - Positive framings ([[Prefer positive note titles to promote systematic theory]]) > 4. Each evergreen note title should concisely compress the main idea. > 5. There's an emphasis on using complete claims, propositions, or sentences for note titles. --- # [[Journal section]] ### [[MOB]] at 2020-08-26 >When Evergreen notes are factored and titled well, those titles become an abstraction for the note itself. The entire note’s ideas can then be referenced using that handle (see Concept handles, after Alexander). In fact, this property itself functions as a kind of litmus: as you develops ideas in notes over time and improve the “APIs,” you’ll be able to write individual notes which abstract over increasingly large subtrees (e.g. Enacted experiences have incredible potential as a mass medium, Evergreen note-writing as fundamental unit of knowledge work). >Some effective note “API design” techniques: >- separation of concerns (Evergreen notes should be atomic), >- sharp titles (Prefer note titles with complete phrases to sharpen claims), and >- positive framings (Prefer positive note titles to promote systematic theory). > > —Andy Matuschak https://notes.andymatuschak.org/z3XP5GRmd9z1D2qCE7pxUvbeSVeQuMiqz9x1C In other words, each evergreen note title should be a neat compression of the idea. ### [[MOB]] at 2024-09-22 Sun 09.47am Want to re-emphasize and probably I should [[Nodify]] the preference for note titles to be complete claims/propositions/sentences. [[Prefer note titles with complete phrases to sharpen claims]], to start with Andy's phrase.