kennethreitz
ce93f429a2
Publish the Obsidian vault's Knowledge folder as /knowledge (881 notes, 67 folders), with a Knowledge item in the nav and footer. - scripts/import_knowledge.py regenerates data/knowledge from the vault: slugged paths, folder notes as index pages, wikilinks resolved to site links (or plain text), callouts, highlights, and Dataview tables rendered statically. Personal notes are withheld via an exclusion list plus a privacy guard. - tuftecms/core/knowledge.py builds a concept index from note titles and aliases. First mentions on ordinary pages link to their Knowledge note (capped, never in headings, code, links, or sidenotes); Knowledge pages list related notes and where they're mentioned across the site; other pages get a Related Knowledge block. - Knowledge URLs join sitemap.xml (so the sweep test covers them), never displace existing legacy slugs, list alphabetically, and mermaid diagrams render client-side only on pages that have them.
2.9 KiB
description, source
| description | source |
|---|---|
| Hiding the right complexity. Every interface, god, and grammar is a bet about what can be safely ignored. | obsidian-knowledge |
Abstraction
An abstraction is a bet about what you can afford not to think about.
An abstraction hides complexity behind a simpler surface. requests.get(url) conceals sockets, TLS handshakes, redirects, and connection pooling behind six characters and a string — and the concealment is the product. The art isn't hiding complexity; anything can hide complexity. The art is choosing which complexity to hide, and the test is For Humans: a good abstraction matches the shape of human thought, so that the common case costs nothing and the rare case is still reachable. urllib2 was an abstraction too. It just bet wrong about what people needed to ignore.
Everything Is One
The concept doesn't belong to software. Language is an abstraction over experience — the word "dog" compresses a million particular animals into a handle you can pass around, which is why language works like an operating system for consciousness. The Archetypes are abstractions over the psyche: the Great Mother is not any mother but the interface every mother is an implementation of. The pantheons abstract the forces of the world into nameable, negotiable persons — Mythology as the psyche's API documentation. Music theory abstracts vibrating air into keys and functions. And the Table of Correspondences is the extreme case: a single grid claiming that planets, letters, gemstones, and sephiroth are all views over the same underlying table.
Leaks
Every abstraction leaks — the hidden complexity resurfaces exactly when you can least afford it. The network times out, the metaphor breaks, the archetype fails to fit the actual person in front of you. This isn't failure; it's the terms of the deal. An abstraction is a loan of simplicity, and the leak is the interest payment. The skill is knowing what's underneath well enough to drop down a level when the surface gives way — and then climbing back up, because living at the bottom is no way to live.
Related
- For Humans — The criterion for choosing what to hide
- Design — Abstraction as the working material of design
- Naming Things — The name is the abstraction's front door
- Archetypes — Abstraction over the psyche
- Table of Correspondences — The maximal claim: one grid, many views
- Language as Operating System — Words as the original abstraction layer