From the GEO Audit Report (discussion #30401): neither the docs site nor the README has JSON-LD schema markup (0/16). This is the single highest-impact gap for AI Knowledge Graph inclusion.
Approach
Add JSON-LD structured data to the docs site homepage (docs/src/pages/index.astro or via Astro head injection in astro.config.mjs):
Schemas to add:
WebSite + Organization — establishes entity identitySoftwareApplication — describes gh-aw as a toolFAQPage — populated from existing docs FAQ contentpotentialAction: SearchAction — enables agent discoverability
Example snippet:
{
"`@context`": "(schema.org/redacted)",
"`@type`": ["WebSite", "SoftwareApplication"],
"name": "GitHub Agentic Workflows",
"url": "https://github.github.com/gh-aw/",
"description": "Write agentic workflows in natural language using markdown, run them as GitHub Actions.",
"applicationCategory": "DeveloperApplication",
"operatingSystem": "Any"
}Files to Modify
docs/src/pages/index.astro or equivalent — inject <script type="application/ld+json"> in <head>- Alternatively, use Astro's
<head> slot in the Starlight config
Acceptance Criteria
Generated by Plan Command for issue #discussion #30401 · ● 2.8M · ◷
From the GEO Audit Report (discussion #30401): neither the docs site nor the README has JSON-LD schema markup (0/16). This is the single highest-impact gap for AI Knowledge Graph inclusion.
Approach
Add JSON-LD structured data to the docs site homepage (
docs/src/pages/index.astroor via Astro head injection inastro.config.mjs):Schemas to add:
WebSite+Organization— establishes entity identitySoftwareApplication— describes gh-aw as a toolFAQPage— populated from existing docs FAQ contentpotentialAction: SearchAction— enables agent discoverabilityExample snippet:
{ "`@context`": "(schema.org/redacted)", "`@type`": ["WebSite", "SoftwareApplication"], "name": "GitHub Agentic Workflows", "url": "https://github.github.com/gh-aw/", "description": "Write agentic workflows in natural language using markdown, run them as GitHub Actions.", "applicationCategory": "DeveloperApplication", "operatingSystem": "Any" }Files to Modify
docs/src/pages/index.astroor equivalent — inject<script type="application/ld+json">in<head><head>slot in the Starlight configAcceptance Criteria
<script type="application/ld+json">with at leastWebSiteandSoftwareApplicationschemasOrganizationschema includesname,url, andsameAspointing to the GitHub repo