From 0e5c0dd69c3becf850e48294b40182fa93894751 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mark=20Randall=20Havens=20=E2=96=B3=20The=20Empathic=20Tec?=
 =?UTF-8?q?hnologist?= <mark.r.havens@gmail.com>
Date: Fri, 13 Feb 2026 22:48:25 -0600
Subject: [PATCH] docs: add frontmatter display guidance

---
 docs/fieldnote-template.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/fieldnote-template.md b/docs/fieldnote-template.md
index 1e0018a..9e4ec31 100644
--- a/docs/fieldnote-template.md
+++ b/docs/fieldnote-template.md
@@ -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.