TheDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/apursley2012/sys-core/llms.txt
Use this file to discover all available pages before exploring further.
articles.js module exports an array a of article objects that populate the Writing section of the portfolio. Each entry represents a piece of technical writing — blog post, essay, or post-mortem — and carries metadata that drives two visual components: band (UHF / VHF / HF) communicates the relative reach and engagement tier of the piece using a radio-spectrum metaphor, while signalStrength (1–5) is rendered by the SignalBars component as a column of signal-strength bars, visually similar to a mobile reception indicator.
Data Shape
The
content field in every current entry contains the placeholder string
"Full transmission content would go here...". Replace this with the full
article body text — or a Markdown string — before the Writing section goes
live. The card preview is driven by preview, not content, so placeholder
content does not affect the visible UI until a reader clicks to expand an
article.Band Classification
Theband field maps to real-world radio frequency bands and signals the engagement level or intended audience of the article:
| Band | Full Name | Meaning in Context |
|---|---|---|
UHF | Ultra-High Frequency | Highest engagement / most widely read pieces. Reserve for flagship articles. |
VHF | Very High Frequency | Strong engagement — polished, broadly applicable writing. |
HF | High Frequency | Good engagement — more specialised or niche topic coverage. |
Signal Strength
ThesignalStrength field is an integer from 1 to 5. It is rendered by the SignalBars component as a stacked bar indicator (like a Wi-Fi or cellular signal icon). Use it to indicate the perceived quality, completeness, or confidence level of the article relative to your other writing.
| Value | Indicator | Suggested Use |
|---|---|---|
| 5 | ▮▮▮▮▮ | Flagship piece — fully polished, heavily revised |
| 4 | ▮▮▮▮▯ | Strong piece, minor rough edges |
| 3 | ▮▮▮▯▯ | Solid draft, some sections could be expanded |
| 2 | ▮▮▯▯▯ | Work-in-progress or narrow niche piece |
| 1 | ▮▯▯▯▯ | Early draft or stub |
Current Entries
| ID | Title | Date | Band | Signal | Classification |
|---|---|---|---|---|---|
| a1 | Optimizing React Context for High-Frequency Telemetry | STARDATE 2025.301 | UHF | 5 | PERFORMANCE |
| a2 | The Anatomy of a Perfect Dark Mode | STARDATE 2025.142 | VHF | 4 | DESIGN |
| a3 | Migrating from REST to GraphQL: A Post-Mortem | STARDATE 2024.089 | HF | 3 | ARCHITECTURE |
| a4 | Building Resilient UIs with State Machines | STARDATE 2024.012 | UHF | 5 | ENGINEERING |
Adding New Entries
- Open
data/articles.js. - Append a new object to the array, following the
a{n}id convention. - Set
dateusing the stardate format — see the Timeline Data page for how to calculate a stardate from a calendar date. - Choose a
bandandsignalStrengththat honestly reflect the article’s reach and quality relative to the existing entries. - Write a compelling
preview(one to two sentences) that stands alone as a teaser. - Populate
contentwith the full article text — or a Markdown string — when the piece is ready to publish.
Field Reference
Unique identifier for the article. Follow the
a{n} pattern (e.g. "a1",
"a5") to keep ordering explicit and stable.Full display title of the article, rendered as the card heading. Sentence case
is preferred for readability.
Publication date expressed as a stardate string, e.g.
"STARDATE 2025.301".
See the Timeline Data page for the YYYY.DDD format
breakdown.Radio band classification that signals the engagement tier of the article.
"UHF" is the highest (most widely read), "HF" is the most specialised.
See the Band Classification table above for guidance on choosing a value.Integer from
1 to 5 rendered by the SignalBars component. Reflects the
perceived quality and completeness of the article. 5 is a fully polished
flagship piece; 1 is a stub or early draft.Topic category tag displayed on the article card and used for filtering:
PERFORMANCE— Speed, optimisation, profiling, benchmarking.DESIGN— UI/UX, visual design, accessibility, motion.ARCHITECTURE— System design, API contracts, data modelling.ENGINEERING— General engineering practices, tooling, patterns.
One or two sentences shown on the article card as a teaser. Should be
self-contained and compelling enough to entice a click without requiring
context from the full article.
Full article body. Currently contains the placeholder string
"Full transmission content would go here..." for all entries. Replace with
the complete article text (plain text or Markdown string) before publishing.