# gjord/gwern.net architecture

> Architecture diagram of the GitHub repository gjord/gwern.net, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gjord/gwern.net
- Repository: https://github.com/gjord/gwern.net

## Overview

This repository is a personal publishing site: visitors encounter essays and other editorial material, with a collection of supporting documents, images, fiction, and newsletters. Its sampled JavaScript adds client-side table sorting, A/B-test variant selection and display, and footnote previews. The README is empty, and the excerpts do not show how pages are rendered or how these scripts are loaded, so those connections are left unverified rather than presented as established wiring.

Main entry points: [`About.page`](https://github.com/gjord/gwern.net/blob/master/About.page) (Essays and notes), [`fiction`](https://github.com/gjord/gwern.net/tree/master/fiction) (Fiction), [`docs`](https://github.com/gjord/gwern.net/tree/master/docs) (Reference archive), [`images`](https://github.com/gjord/gwern.net/tree/master/images) (Images and media)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editorial["Editorial content"]
  node_essays["Essays and notes<br/>[About.page]"]
  node_fiction["Fiction"]
end

subgraph group_resources["Reference materials"]
  node_reference_docs["Reference archive"]
  node_media["Images and media"]
end

subgraph group_interactive["Browser enhancements"]
  node_table_sorting["Table sorting<br/>[tablesorter.js]"]
  node_ab_testing["A/B variants<br/>[abalytics.js]"]
  node_footnotes["Footnote previews<br/>[footnotes.js]"]
end

subgraph group_publishing["Other publications"]
  node_newsletters["Newsletters"]
end

node_visitor(("Site visitor"))

node_visitor -.->|"browses"| node_essays
node_visitor -.->|"browses"| node_fiction
node_visitor -.->|"browses"| node_reference_docs
node_visitor -.->|"browses"| node_media
node_visitor -.->|"browses"| node_newsletters
node_visitor -.->|"uses"| node_table_sorting
node_visitor -.->|"uses"| node_ab_testing
node_visitor -.->|"uses"| node_footnotes

click node_essays "https://github.com/gjord/gwern.net/blob/master/About.page"
click node_fiction "https://github.com/gjord/gwern.net/tree/master/fiction"
click node_reference_docs "https://github.com/gjord/gwern.net/tree/master/docs"
click node_media "https://github.com/gjord/gwern.net/tree/master/images"
click node_table_sorting "https://github.com/gjord/gwern.net/blob/master/static/js/tablesorter.js"
click node_ab_testing "https://github.com/gjord/gwern.net/blob/master/static/js/abalytics.js"
click node_footnotes "https://github.com/gjord/gwern.net/blob/master/static/js/footnotes.js"
click node_newsletters "https://github.com/gjord/gwern.net/tree/master/newsletter"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_essays,node_fiction toneBlue
class node_reference_docs,node_media toneAmber
class node_table_sorting,node_ab_testing,node_footnotes toneMint
class node_newsletters toneRose
class node_visitor toneIndigo
```

## Components

### Editorial content

- [Essays and notes](https://github.com/gjord/gwern.net/blob/master/About.page): `About.page`
- [Fiction](https://github.com/gjord/gwern.net/tree/master/fiction): `fiction`

### Reference materials

- [Reference archive](https://github.com/gjord/gwern.net/tree/master/docs): `docs`
- [Images and media](https://github.com/gjord/gwern.net/tree/master/images): `images`

### Browser enhancements

- [Table sorting](https://github.com/gjord/gwern.net/blob/master/static/js/tablesorter.js): `static/js/tablesorter.js`
- [A/B variants](https://github.com/gjord/gwern.net/blob/master/static/js/abalytics.js): `static/js/abalytics.js`
- [Footnote previews](https://github.com/gjord/gwern.net/blob/master/static/js/footnotes.js): `static/js/footnotes.js`

### Other publications

- [Newsletters](https://github.com/gjord/gwern.net/tree/master/newsletter): `newsletter`

### Other components

- **Site visitor**

## Connections

- Site visitor → Essays and notes: browses
- Site visitor → Fiction: browses
- Site visitor → Reference archive: browses
- Site visitor → Images and media: browses
- Site visitor → Newsletters: browses
- Site visitor → Table sorting: uses
- Site visitor → A/B variants: uses
- Site visitor → Footnote previews: uses