Specification v0.1 / Experimental open method

A visible relationship layer for website knowledge.

A Grounding Map is a crawlable relationship layer that shows how a website defines, connects and supports its important entities, topics, products, services, people, brands, evidence and machine-readable resources.

Specification v0.1 describes this as a directory-based index layer: a visible place where important website resources are organized as relationships, not left as isolated pages.

Why the map layer exists

Why Grounding Pages need a map

Grounding Pages define stable facts. A Grounding Map shows how those facts belong together across a website. On larger websites, important information is distributed across products, services, categories, people, brands, articles, evidence and machine-readable files.

The map gives those resources a visible relationship structure, so intended connections do not have to be inferred from isolated pages. It complements Grounding Pages instead of replacing them.

Scope

What gets mapped

Entities

Entities and concepts

Named entities, definitions, concepts and canonical explanations.

Commercial

Products and services

Commercial pages, service areas, categories and offers.

Identity

People and brands

Authors, experts, organizations, brands and ownership signals.

Context

Articles and documentation

Explanatory pages that provide context around stable facts.

Support

Evidence and references

Source pages, proof points, examples and supporting materials.

Files

Machine-readable resources

.md.txt, llms.txt, JSON resources and structured data companions.

Boundaries

What a Grounding Map is — and what it is not

A Grounding Map is
  • a visible relationship layer between website resources
  • a crawlable index of important entities, topics, products, services, people, brands, evidence and machine-readable files
  • a way to show canonical relationships across a website
  • an extension of individual Grounding Pages at website level
  • a governance layer for larger information architectures
A Grounding Map is not
  • a normal XML sitemap
  • a navigation menu
  • a category or tag archive
  • structured data alone
  • a private internal knowledge graph
  • a ranking hack
Compared with an XML sitemap

It explains relationships, not only URL discovery.

Compared with navigation

It can expose relationships that are not primary menu choices.

Compared with a content hub

It documents definitions, evidence and machine-readable companions.

Specification model

The v0.1 model starts with website architecture

The model is not a loose list of entities. It describes where the map lives, which pages it connects and how evidence and machine-readable resources support the relationships.

Directory

Grounding Map Directory

A stable path such as /facts/ or /fakten/ that holds the map and its pages.

Index

Grounding Map Index Page

The directory landing page that lists important resources and shows how they connect.

Pages

Grounding Pages

Stable pages for entities, concepts, people, brands, products or services that need clear definition.

Layer

Relationship Layer

Typed links between the index page, Grounding Pages, related resources, articles and supporting files.

Layer

Evidence Layer

Pages, source references and examples that support a page or relationship.

Layer

Machine-readable Layer

.md.txt, llms.txt, JSON resources and structured data companions.

Reference implementation

Derived from marcdeboer.de/fakten/

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

What the reference implementation shows

On marcdeboer.de, the /fakten/ directory acts as a map index. Individual facts pages such as /fakten/grounding-map/, /fakten/seo-entropie/ and /fakten/search-reality/ define stable concepts. Blog articles explain the ideas around those pages, while text twins and resource files make parts of the structure machine-readable.

grounding-map.com maintains a smaller public specification and example environment at /facts/. It documents the pattern without claiming that the model is finished or externally standardized.

/fakten/Grounding Map Directory and Index Page
Grounding Pages/fakten/grounding-map/ and related concept pages
Editorial articles/blog/grounding-map/ explains the concept
Machine-readable resources.md.txt, llms.txt and JSON resources
Start points

Use the MVP resources

Spec

Specification v0.1

Directory, index page, Grounding Pages, relationship layer, evidence and versioning rules.

Read spec
Template

Directory template

Fields for map index URL, Grounding Page URL, evidence, related pages and machine-readable files.

Open template
Examples

Reference and patterns

marcdeboer.de as reference implementation, plus secondary generic website patterns.

View examples
Resources

Machine-readable files

Schema, templates, example JSON, text twins and llms.txt for the v0.1 model.

Download files