# Grounding Map Specification v0.1

Canonical URL: https://grounding-map.com/spec/
Version: 0.1
Status: experimental

Definition:
A Grounding Map is a directory-based index layer that connects a website's Grounding Pages, explanatory articles, evidence pages and machine-readable resources.

Core model:
- Grounding Map Directory: a stable path such as /facts/ or /fakten/.
- Grounding Map Index Page: the landing page at that directory.
- Grounding Pages: stable pages for named entities or concepts.
- Concept or Entity Registry: maintained IDs, names, canonical URLs, related concepts and evidence URLs.
- Relationship Layer: typed links between Grounding Pages, articles, evidence pages, source references and related concepts.
- Machine-readable Layer: .md.txt, JSON resources, structured data, llms.txt and optional discovery endpoints later.
- Editorial Explanation Layer: blog posts, guides or articles that explain why the stable pages matter.

Reference implementation:
marcdeboer.de /fakten/ is the first public reference implementation used to derive Specification v0.1.

Reference URLs:
- https://marcdeboer.de/fakten/
- https://marcdeboer.de/fakten/grounding-map/
- https://marcdeboer.de/blog/grounding-map/
- https://marcdeboer.de/fakten/seo-entropie/
- https://marcdeboer.de/fakten/search-reality/

Required fields:
- mapDirectory
- mapIndexUrl
- groundingPageUrl
- entityName
- entityType
- canonicalReference
- evidenceUrls
- relationshipType
- machineReadableUrl
- status
- stability
- lastReviewed

Recommended fields:
- editorialExplanationUrl
- relatedGroundingPages
- signalStrength
- owner
- openGaps

Relationship types:
defines, explains, supports, extends, differentiates, operationalizes, aggregates, diagnoses, identifies, structures, implements_on, updates, replaces, is_example_for, is_source_for, is_reference_implementation_for

Boundary:
Specification v0.1 is experimental. It is not an established external standard, ranking promise, quality score, certification or result claim.