Where to put the portals
Some thoughts on containing complexity in personal website design
Sometimes the coolest website is the least readable.1
I recently came across gwern.net and quickly sensed it would be a personal-website-as-labyrinth that I'll venture into for weeks. It has an alien feel to it, or at least foreign relative to the optimized and foolproof UIs you find across templated social networks. He is a Wikipedia editor with 34,569 edits (on English Wikipedia as of 6/1/26) and so naturally his personal website is a personal wiki, documenting his self, his site, his links, his tech stack and writing, each adorned with hierarchical outlines on the left (1, 1.2, 1.2.6, ... ). I sense him to be something of a techno-Montaignean, capturing his mind and culture, interweaving quotes, and pseudonymously appearing on the Dwarkesh podcast as a real-time avatar.
So yes, lots of diving and mapping to do, but I need to note one observation of my experience here, which I want to be careful not to recreate on my own site. Most of my time is spent marveling at the structure and navigating what exists, but I'm presented with so many hyperlinks that I can rarely ever focus on and absorb a single page. There are 53 links in my current view. Maybe I'm exposing myself as someone who reads linear essays a lot more than I read Wikipedia articles.
I suppose there are two ways to know a person, in breadth and in depth. Technically this site has both; once you wade through the peculiar structures and get a gestalt of the person, you do find linear essays that are well written. But even those are nested in scaffolding; 60% of the opening view is dedicated to metadata: nav links, title, tags, a summary, ratings of completion, certainty, and importance, links to similar notes and a bibliography (many of which, if clicked, opens a pop-up with more information), and then an opening quote, all before the opening sentence.
Even if I think this meta-data is misplaced, I personally love having it all accessible. I get frustrated by a popular online writer (/marketer) who refuses to date the essays on his website, probably from the thought that datelessness is timelessness, or the fear that the median reader will see something dated 2019 and think ugh, that's old, and click away. Marketers want a simplicity that's legible at scale; I am a complexophile. A personal website (or anything, really) should be as dense as can be contained, for that gives the super-reader the ability to grok you at a resolution closer to reality, but only as long as it can be progressively revealed, giving the first encounter an on ramp into the beast.
I'm now arriving at what I think I believe: if your website contains a collection of essays, then drop the reader directly into prose, and withhold structure until the end of an experience. "Prose before portals" could be a simple, multi-scale maxim. A standalone essay page should have a header of only 15% metadata, and even the frontpage, instead of providing a traditional orientation, could drop you directly into a stream of recent essays (a design decision I haven't committed to yet, but am leaning towards). Perhaps portals could exist minimally at the beginning, but maximally at the end. An essay's footer should be entirely portals.
Another debatable decision is that an essay should rarely include internal hyperlinks. Contrast this to Justin Hall's links.net of the mid-90s, whose whole website was a hyperlink maze. Gwern's site, much like Wikipedia, is also maze-like. These are conceptually neat, and of course native to the Internet, but I always catch myself skimming rather than reading deeply. I am astonished at the size and grandeur of the park, but I am distracted. Essays demand depth. My ideal would be to fuse the medium of physical reading with the navigation of the web: uninterrupted prose, bookended by optionality. Maybe you could refer to this as "extrastitial" instead of "interstitial": the internal modules aren't connected, but the wholes are connected end-to-end. (This actually mirrors how ChristopherAlexander structures his chapters in A Pattern Language, the original wiki: the beginning and end points out to other chapters, but the body is uninterrupted.)
A final note on skimming: I catch myself doing "Inspectional Reading" a lot here, the second level of Adler's How to Read a Book. There are many possible causes for this. To start, it could just be my fault: right now I'm reading as I write this essay, and I have much to do this morning, and so to some degree I'm reading to the level that it enables me to write, for if I read everything full, all the tabs, I could become absorbed for hours and get nothing else done before it's time to watch my 5-month-old daughter for the rest of the day. But aside from self-blame, there's a FOMO that comes with any thriving website: when you're aware of a sprawling network of high-quality information, it becomes hard to sink into any one piece because you're too aware of what you're missing. And so there might be something to intentional concealment and revelation.
I want a reader to come to my site and experience flow, not analysis paralysis, but this opens a new question. Who is a personal website for? The answer is in the name. The reason I'm shifting from Substack back to a site of my own is because I want to write in a place where I set the rules. And so there's a risk of leaning too far into becoming a self-archivist, where I try to convey to you the totality of myself, the full hyper-object, instead of letting you compile me one file at at time. If the full extents of my writing are something like a national park, I need to make sure you get on the curated trails and experience nature, instead of presenting you a network of maps.
Ironically the first essay I read by Gwern was on Tools for Thought, a wonderful takedown or Rome, Zettlekasten, and networked thought:
"Most people simply have no need for lots of half-formed ideas, random lists of research papers, and so on. This is what people always miss about “Zettelkasten”: are you writing a book? Are you a historian or Teutonic scholar like Niklas Luhmann? Do you publish a dozen papers a year? Are you the 1% of the 1%? No? Then why do you think you need a Zettelkasten?"
A rule I've had to set for myself is to never link my notes; they should live scattered in an epiphany swamp of atomic ramblings, only to be given name, date, and tag at the moment of publishing. Most won't make it out of the swamp. So many writers suffocate themself in PKM hell; instead they should open the pipeline to get finished prosed onto their website. And now, I find myself reaching for heuristics on how to present essays, a whole body of work, and the very self behind it. I think there are similar risks with public hyperlinked structures, along with ways to let the atomic nodes of a network speak for themselves, without severing from the hive.
This is all just first wind from second impressions, but as I understand Gwern more deeply and build out my new site—after existing only on Substack for 3.5 years—, I'm sure I'll come away with something useful.
Footnotes
-
I added this hook after reading (skimming) Gwern's First, Make Me Care. ↩
