docs: add frontmatter display guidance
This commit is contained in:
parent
6e9fdd0a97
commit
0e5c0dd69c
1 changed files with 25 additions and 0 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue