Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apursley2012/developer-dossier/llms.txt

Use this file to discover all available pages before exploring further.

The Writing page uses a two-column layout: the left panel lists all articles as selectable cards, each stamped with its type classification, while the right panel displays a live preview that updates whenever the user hovers or focuses a card. The preview pane shows the article title, publication date, read time, abstract, and a link to the full article view — all without a page navigation, keeping the browsing experience fast and terminal-like.

Routes

The Writing section spans two routes:
RouteShellDescription
/#/writingpages/Writing.htmlThe split-panel archive list
/#/writing/:idpages/ArticleView.htmlFull single-article view

Article Entries

All four articles currently in data/articles.js:
IDTypeTitleDateRead Time
art-001INCIDENT REPORTThe Great State Collapse of 20232023-10-146 MIN
art-002TECHNICALBuilding Resilient Data Fetching Layers2024-02-028 MIN
art-003REFLECTIONWhy I Stopped Using CSS Frameworks (And Why I Started Again)2024-05-185 MIN
art-004FOR-GEN-AUDIENCEWhat Actually Happens When You Click “Buy”2024-08-3010 MIN

Article Data Shape

Each entry in data/articles.js conforms to the following TypeScript-equivalent interface:
interface Article {
  id: string;                  // e.g. "art-001"
  type:
    | 'INCIDENT REPORT'
    | 'TECHNICAL'
    | 'REFLECTION'
    | 'FOR-GEN-AUDIENCE';
  title: string;
  date: string;                // ISO 8601, e.g. "2023-10-14"
  readTime: string;            // e.g. "6 MIN"
  abstract: string;            // One-paragraph summary shown in preview pane
  content: string;             // Full long-form body rendered in ArticleView
}

Article View

The full article view at /#/writing/:id renders the matched article with the following layout:
  1. Display heading — the article title in large tracked-out type with a ClassificationStamp for the type.
  2. Abstract callout — the abstract string inside a callout block bordered in lime/acid-green, visually separating it from the body prose.
  3. Body prose — the content field as long-form text. The first paragraph receives a CSS drop-cap on its initial letter, reinforcing the field-report document feel.
If no article with the requested :id is found in data/articles.js, the ArticleView component should redirect to /#/writing rather than rendering a blank or broken state. This guard is not implemented by default — add it to the route resolver if needed.

Components Used

ClassificationStamp

Applied to each article card and the article view header to display the article type. The stamp variant is determined by type: INCIDENT REPORT renders in magenta; all other types (TECHNICAL, REFLECTION, FOR-GEN-AUDIENCE) render in cyan.

TabDivider

Used as a section header above the article list in the left panel of the archive view.

Build docs developers (and LLMs) love