Machine-readable model

Grounding Map JSON Schema

The schema validates a map-level object: directory, index page, Grounding Pages, relationship layer, evidence and machine-readable resources.

Open JSON Schema Open JSON Template

Map-level validation

Requires mapDirectory, mapIndexUrl and a site object before page records are accepted.

Grounding Page records

Each page requires id, entityName, entityType, Grounding Page URL, canonical reference, status, stability and review date.

Relationship and evidence layers

Typed edges connect pages, explanatory articles, evidence URLs, text twins, JSON resources and registry files.

Example JSON

Minimal payload

{
  "version": "0.1",
  "status": "experimental",
  "site": {
    "name": "marcdeboer.de",
    "url": "https://marcdeboer.de/",
    "language": "de"
  },
  "mapDirectory": "/fakten/",
  "mapIndexUrl": "https://marcdeboer.de/fakten/",
  "groundingPages": [
    {
      "id": "grounding-map",
      "entityName": "Grounding Map",
      "entityType": "Method",
      "groundingPageUrl": "https://marcdeboer.de/fakten/grounding-map/",
      "canonicalReference": "https://marcdeboer.de/fakten/grounding-map/",
      "editorialExplanationUrl": "https://marcdeboer.de/blog/grounding-map/",
      "relatedGroundingPages": [
        "https://marcdeboer.de/fakten/grounding-page/"
      ],
      "evidenceUrls": [
        "https://marcdeboer.de/fakten/",
        "https://marcdeboer.de/blog/grounding-map/"
      ],
      "status": "active",
      "stability": "evolving",
      "lastReviewed": "2026-06-06"
    }
  ],
  "relationshipLayer": [
    {
      "from": "https://marcdeboer.de/fakten/",
      "to": "https://marcdeboer.de/fakten/grounding-map/",
      "relationshipType": "structures",
      "status": "active",
      "stability": "evolving"
    }
  ],
  "evidence": [],
  "machineReadableResources": [],
  "referenceImplementation": {
    "name": "marcdeboer.de /fakten/",
    "url": "https://marcdeboer.de/",
    "mapDirectoryUrl": "https://marcdeboer.de/fakten/",
    "mapIndexUrl": "https://marcdeboer.de/fakten/",
    "groundingMapPageUrl": "https://marcdeboer.de/fakten/grounding-map/",
    "editorialExplanationUrl": "https://marcdeboer.de/blog/grounding-map/"
  }
}

Important boundary

Schema validation is not quality validation

A valid JSON file means the structure matches the v0.1 model. It does not prove editorial quality, broad adoption, external certification, answer-engine usage or performance outcomes.

See all downloadable resources