Skip to content
✎ Article

How this site is organised

One collection, three lenses — format, topic and tags — and never more than two levels deep.

Everything on this site is a single kind of thing: an item. An item is a folder with an index.md inside, plus whatever images belong to it:

src/content/items/
  how-its-organised/
    index.md        ← this page
  colour-studies/
    index.md
    study-1.svg

The folder name becomes the URL, /p/how-its-organised/. Moving an item between topics never changes its address.

Three lenses

Lens Answers Shape
Format (type) How is it presented? fixed list: article, note, video, gallery, software, tool
Topic What is it about? a tree, at most two levels
Tags What else is it related to? free-form, flat

A series can additionally stitch a few items together in order — like the three parts of this one.

Why a two-level limit

Deep hierarchies feel organised when you create them and become mazes a year later. Two levels — Building things → Front-end — is enough to give shape without making anyone click through folders. The build refuses a third level on purpose.

Filtering

Explore lists everything and lets you combine one format, one topic and one tag. The filter state lives in the URL, so a filtered view is shareable: /explore?type=article&tag=meta.