docs: add frontmatter display guidance

This commit is contained in:
Mark Randall Havens △ The Empathic Technologist 2026-02-13 22:48:25 -06:00
parent 6e9fdd0a97
commit 0e5c0dd69c

View file

@ -56,3 +56,28 @@ notion_created: "2025-10-21T02:11:00.000Z"
source: Notion
---
```
## Frontmatter Display
**For humans:** Show elegant metadata (title, date, author)
**For machines:** Full frontmatter (notion_id, notion_created, source)
The site generator should:
1. Parse frontmatter for machine use
2. Hide technical fields from public display
3. Show only: title, date, author, series, tags
```yaml
# Visible to humans (elegant)
title: "THE ENGINEER AND THE STARSHIP"
date: 2025-10-13
author: "Mark Randall Havens"
# Hidden from display (machine-readable)
notion_id: "28bef9407594809298a9eef1fe68028c"
notion_created: "2025-10-13T08:00:00.000Z"
source: Notion
```
The coherence tools read the full frontmatter. Humans see elegance.