[nehagup]

Fixes the keploy/docs rows from the keploy.io SEO/GEO audit (Oct 2026).

Structured data

• FAQPage JSON-LD was HTML-escaped ({"@context…) on https://keploy.io/docs/keploy-explained/api-testing-faq/ and https://keploy.io/docs/keploy-explained/unit-testing-faq/. React entity-escapes text children of <script> during SSR. src/remark/remarkFaqSchema.js now emits the JSON through dangerouslySetInnerHTML (with < escaped as <). I checked the built HTML: every ld+json block on both pages parses with json.loads.
• src/schema/siteEntities.js: SoftwareApplication @id is now https://keploy.io/#software (it was #keploy), with applicationCategory: "DeveloperApplication". Organization sameAs now includes Wikidata https://www.wikidata.org/wiki/Q137395272. Publisher already pointed at https://keploy.io/#organization. softwareHelp was already https://keploy.io/docs/. BreadcrumbList already comes from DocBreadcrumbs.
• TechArticle dateModified already comes from git (showLastUpdateTime + src/lastUpdate/contentLastUpdate.js). I made no change there.

Canonicals

• https://keploy.io/docs/concepts/reference/glossary/regression-testing/ and https://keploy.io/docs/concepts/reference/glossary/black-box-testing/ had front-matter canonicals pointing at unrelated blog posts. I removed them, so both pages are now self-canonical (checked in the build).

Sitemap and robots

• /docs/search/ is excluded from the sitemap. 1.0.0 and 2.0.0 were already excluded and noIndex. 3.0.0 is not built (onlyIncludeVersions).
• <lastmod> already uses per-doc git content dates (lastmod: "date"). It needs full history in CI, which is already fetch-depth: 0.
• static/robots.txt (served at /docs/robots.txt, which crawlers ignore) is now a no-op Allow: / plus a comment. The real rules (AI-bot policy, /docs/1.0.0/–3.0.0/ disallows) must live in the root https://keploy.io/robots.txt. That is handled in the keploy/landing PR.

Content

• "What is Keploy?" (https://keploy.io/docs/keploy-explained/introduction/, which pulls in concepts/what-is-keploy.md): I added the H2s Overview / How Keploy Generates Tests / Where to Run Keploy Tests over the existing text. No new claims.
• I removed emoji from 24 doc H1s in v4 docs (e.g. "🤖 AI Models at Keploy" is now "AI Models at Keploy"). Sidebar labels are unchanged.
• https://keploy.io/docs/server/install/ (via concepts/platform-requirements.md): the hot-linked Apple (pngplay), Windows (wikimedia) and Linux (th.bing.com) logos now use the existing /docs/img/os/*-logo.svg.

Skipped / manual steps

• Green tick images in the platform table are still hot-linked from upload.wikimedia.org, because the repo has no equivalent local asset.
• TechArticle author: docs with no front-matter author still fall back to the Organization, and datePublished falls back to the git last-modified date. Setting real authors and dates needs a decision on who the authors are.
• Raster logo: there is no raster Keploy logo in this repo, so Organization.logo stays the SVG at keploy.io.
• Trailing-slash 302: trailingSlash: true is already set. The 302 comes from the hosting/proxy layer and has to be changed to a 301 there.
• CSP / HSTS: not configured in this repo's Docusaurus config. Set them at the edge/proxy.
• llms.txt: content/llms-*.txt has no Allen Digital, no "Feneva" and no hard-coded star count, so no change was needed.

Build

yarn install --frozen-lockfile && yarn build succeeded locally. There were 2 broken-anchor warnings (samples-mux, samples-redis); they were already there and are unrelated to this PR. I checked the build output: the FAQ JSON-LD parses, the glossary canonicals point to themselves, there are no /docs/search entries in the sitemap, and #software and the Wikidata ID are present.

🤖 Generated with Claude Code

[Copilot]

🟡 Changes recommended

Six heading edits invalidate existing quickstart fragment links and need explicit IDs to preserve navigation.

6 open issues

• Preserve Linux/WSL local heading fragment ID · New
• Preserve Docker Compose heading fragment ID · New
• Preserve Linux/WSL local heading fragment ID · New
• Preserve Docker heading fragment ID · New
• Preserve Docker Compose heading fragment ID · New
• Preserve Linux/WSL local heading fragment ID · New

What changed in this PR

This PR addresses the SEO/GEO audit for Keploy’s Docusaurus documentation, improving structured data, indexing metadata, and content presentation.

Changes:

• Fix FAQ JSON-LD rendering and update shared software and organization metadata.
• Restore glossary self-canonicals, exclude search from the sitemap, and clarify root-level robots policy ownership.
• Remove heading emoji, organize introduction content, and replace external operating-system logos with local assets.

File	Description
versioned_docs/​version-4.0.0/​running-keploy/​unit-test-architecture.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​running-keploy/​test-run-reports.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​running-keploy/​test-generate.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​running-keploy/​api-test-architecture.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​running-keploy/​about-unit-testing.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​running-keploy/​about-api-testing.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​samples-go-gin-mongo.md	Remove Docker and local heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​go-mux-sql.md	Remove Docker and local heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​go-mux-mysql.md	Remove Docker and local heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​go-gin-redis.md	Remove Docker and local heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​go-fasthttp-postgres.md	Remove local heading emoji.
versioned_docs/​version-4.0.0/​quickstart/​code-coverage.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​testing-guide.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​supported-languages.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​keploy-security.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​keploy-privacy.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​integrations-pr-agent.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​debugger-guide.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​api-testing-faq.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​keploy-explained/​ai-models.md	Remove heading emoji.
versioned_docs/​version-4.0.0/​concepts/​what-is-keploy.md	Add descriptive section headings.
versioned_docs/​version-4.0.0/​concepts/​reference/​glossary/​regression-testing.md	Remove blog canonical override.
versioned_docs/​version-4.0.0/​concepts/​reference/​glossary/​black-box-testing.md	Remove blog canonical override.
versioned_docs/​version-4.0.0/​concepts/​platform-requirements.md	Use local operating-system logos.
static/​robots.txt	Simplify ineffective subpath rules and document root policy ownership.
src/​schema/​siteEntities.js	Update software identity, category, and organization references.
src/​remark/​remarkFaqSchema.js	Emit unescaped JSON-LD while escaping < for script safety.
docusaurus.config.js	Exclude search routes from the sitemap.

_{Review effort: Balanced}