seo: address PR #857 review comments

- versioned_docs/version-4.0.0/server/installation.md: add explicit
  {#capturing-testcases} / {#running-testcases} anchors on the H2s
  and update HowTo step.url to those anchors. The previous
  `#-capturing-testcases` slug relied on Docusaurus's auto-slugger
  behavior with leading emojis and was fragile.
- versioned_docs/version-4.0.0/quickstart/k8s-proxy.md: HowTo `tools`
  list now includes Kind, kubectl, Helm — the prerequisites the page
  itself calls out below the schema.
- versioned_docs/version-4.0.0/quickstart/samples-express-mongoose.md:
  HowTo `name` is now title-cased ("Sample Course-Selling API
  (Express) — Record and Replay Tests with Keploy") instead of all
  lowercase.
- versioned_docs/version-4.0.0/quickstart/samples-node-mongo.md:
  fix typo "Intoduction" → "Introduction".
- src/pages/about.js: drop unused `useBaseUrl` import. JSON-LD URLs
  now carry trailing slashes to match Docusaurus `trailingSlash: true`
  config — both the Article `url`/`@id` and the BreadcrumbList `item`s.
- src/pages/concepts/reference/glossary.js: same trailing-slash fix
  for DefinedTermSet `@id`/`url`, per-term DefinedTerm `url`s, and the
  BreadcrumbList items. Centralized via a `withTrailingSlash` helper
  so future glossary entries inherit the canonical form.
- src/pages/index.js: Article schema's `headline` and `description`
  now derive from `docsHomeTitle` / `docsHomeDescription` (the same
  values used for the rendered <title>, meta description, and
  sr-only H1) instead of the old short `siteConfig.title` /
  `siteConfig.tagline`. Schema and on-page metadata now agree.

Author: nehagup

src/pages/about.js

@@ -2,19 +2,22 @@ import React from "react";
 import Layout from "@theme/Layout";
 import Head from "@docusaurus/Head";
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
-import useBaseUrl from "@docusaurus/useBaseUrl";
 
 // Custom React pages under src/pages/ are not covered by the docs schema
 // plugin — add Article + BreadcrumbList JSON-LD inline so the page is
 // machine-readable for search engines and AI crawlers.
+//
+// Site config sets `trailingSlash: true`, so canonical URLs in the JSON-LD
+// must carry the trailing slash to match the actual emitted href and avoid
+// duplicate URL variants in structured data.
 const aboutStructuredData = [
   {
     "@context": "https://schema.org",
     "@type": "Article",
     headline: "About the Keploy Documentation",
     description:
       "Information about Keploy's documentation, contribution guidelines, and licensing.",
-    url: "https://keploy.io/docs/about",
+    url: "https://keploy.io/docs/about/",
     publisher: {
       "@type": "Organization",
       name: "Keploy",
@@ -25,16 +28,16 @@ const aboutStructuredData = [
     },
     mainEntityOfPage: {
       "@type": "WebPage",
-      "@id": "https://keploy.io/docs/about",
+      "@id": "https://keploy.io/docs/about/",
     },
   },
   {
     "@context": "https://schema.org",
     "@type": "BreadcrumbList",
     itemListElement: [
-      {"@type": "ListItem", position: 1, name: "Home", item: "https://keploy.io"},
-      {"@type": "ListItem", position: 2, name: "Docs", item: "https://keploy.io/docs"},
-      {"@type": "ListItem", position: 3, name: "About", item: "https://keploy.io/docs/about"},
+      {"@type": "ListItem", position: 1, name: "Home", item: "https://keploy.io/"},
+      {"@type": "ListItem", position: 2, name: "Docs", item: "https://keploy.io/docs/"},
+      {"@type": "ListItem", position: 3, name: "About", item: "https://keploy.io/docs/about/"},
     ],
   },
 ];

src/pages/concepts/reference/glossary.js

@@ -10,34 +10,46 @@ import GlossaryCard from "../../../components/GlossaryCard";
 // DefinedTermSet so AI engines can cite individual definitions and engines
 // can surface them as featured-snippet definitions. Mirrors the pattern in
 // landing/app/(default)/what-is-api-testing/layout.tsx.
+//
+// Site config sets `trailingSlash: true`, so every emitted URL must carry a
+// trailing slash to match the canonical href. Otherwise Google treats the
+// no-slash variant as a duplicate URL of the canonical one.
 const allGlossaryItems = Object.values(glossaryEntries).flat();
 const SITE = "https://keploy.io";
+const GLOSSARY_PATH = "/docs/concepts/reference/glossary/";
+const GLOSSARY_URL = `${SITE}${GLOSSARY_PATH}`;
+const TERMSET_ID = `${GLOSSARY_URL}#termset`;
+
+function withTrailingSlash(path) {
+  if (!path) return path;
+  return path.endsWith("/") ? path : `${path}/`;
+}
 
 const glossaryStructuredData = [
   {
     "@context": "https://schema.org",
     "@type": "DefinedTermSet",
-    "@id": `${SITE}/docs/concepts/reference/glossary#termset`,
+    "@id": TERMSET_ID,
     name: "Keploy Software Testing Glossary",
     description:
       "Definitions for software testing, test automation, and quality engineering terminology, maintained by the Keploy documentation team.",
-    url: `${SITE}/docs/concepts/reference/glossary`,
+    url: GLOSSARY_URL,
     hasDefinedTerm: allGlossaryItems.map((entry) => ({
       "@type": "DefinedTerm",
       name: entry.name,
       description: entry.description,
-      url: `${SITE}${entry.link}`,
-      inDefinedTermSet: `${SITE}/docs/concepts/reference/glossary#termset`,
+      url: `${SITE}${withTrailingSlash(entry.link)}`,
+      inDefinedTermSet: TERMSET_ID,
     })),
   },
   {
     "@context": "https://schema.org",
     "@type": "BreadcrumbList",
     itemListElement: [
-      {"@type": "ListItem", position: 1, name: "Home", item: SITE},
-      {"@type": "ListItem", position: 2, name: "Docs", item: `${SITE}/docs`},
-      {"@type": "ListItem", position: 3, name: "Concepts", item: `${SITE}/docs/concepts`},
-      {"@type": "ListItem", position: 4, name: "Glossary", item: `${SITE}/docs/concepts/reference/glossary`},
+      {"@type": "ListItem", position: 1, name: "Home", item: `${SITE}/`},
+      {"@type": "ListItem", position: 2, name: "Docs", item: `${SITE}/docs/`},
+      {"@type": "ListItem", position: 3, name: "Concepts", item: `${SITE}/docs/concepts/`},
+      {"@type": "ListItem", position: 4, name: "Glossary", item: GLOSSARY_URL},
     ],
   },
 ];

src/pages/index.js

@@ -41,13 +41,21 @@ export default function Home() {
           ],
         }
       : null;
+  // SEO: docs landing previously rendered with title "Keploy Documentation" (20c)
+  // and meta description "API Test Generator Tool" (23c). Both were too short
+  // to capture the intent of a docs visitor (install, capture, replay, SDK).
+  // The Article JSON-LD below derives its `headline`/`description` from these
+  // same constants so the schema, the rendered <title>, the meta description
+  // and the sr-only H1 all agree — single source of truth.
+  const docsHomeTitle = "Keploy Documentation — Install, Capture & Replay API Tests";
+  const docsHomeDescription = "Install Keploy in 5 minutes, capture real API traffic with eBPF, and replay it as deterministic tests in CI. Quickstarts, SDK references, and integration guides.";
   const articleSchema =
-    docsUrl && siteConfig.title
+    docsUrl
       ? {
           "@context": "https://schema.org",
           "@type": "Article",
-          headline: siteConfig.title,
-          description: siteConfig.tagline,
+          headline: docsHomeTitle,
+          description: docsHomeDescription,
           mainEntityOfPage: {
             "@type": "WebPage",
             "@id": docsUrl,
@@ -62,11 +70,6 @@ export default function Home() {
           },
         }
       : null;
-  // SEO: docs landing previously rendered with title "Keploy Documentation" (20c)
-  // and meta description "API Test Generator Tool" (23c). Both were too short
-  // to capture the intent of a docs visitor (install, capture, replay, SDK).
-  const docsHomeTitle = "Keploy Documentation — Install, Capture & Replay API Tests";
-  const docsHomeDescription = "Install Keploy in 5 minutes, capture real API traffic with eBPF, and replay it as deterministic tests in CI. Quickstarts, SDK references, and integration guides.";
 
   return (
     <div className="main">

versioned_docs/version-4.0.0/quickstart/k8s-proxy.md

@@ -19,7 +19,7 @@ import HowTo from '@site/src/components/HowTo';
   description="Clone the sample app, run it under Keploy to capture API traffic, then replay the recorded testcases."
   totalTime="PT10M"
   estimatedCost={{currency: "USD", value: "0"}}
-  tools={["Keploy CLI", "Docker", "git"]}
+  tools={["Keploy CLI", "Docker", "git", "Kind", "kubectl", "Helm"]}
   visible={false}
   steps={[
     {

versioned_docs/version-4.0.0/quickstart/samples-express-mongoose.md

@@ -19,7 +19,7 @@ keywords:
 import HowTo from '@site/src/components/HowTo';
 
 <HowTo
-  name="sample course selling api (express) — record and replay tests with Keploy"
+  name="Sample Course-Selling API (Express) — Record and Replay Tests with Keploy"
   description="Clone the sample app, run it under Keploy to capture API traffic, then replay the recorded testcases."
   totalTime="PT10M"
   estimatedCost={{currency: "USD", value: "0"}}

versioned_docs/version-4.0.0/quickstart/samples-node-mongo.md

@@ -54,7 +54,7 @@ import HowTo from '@site/src/components/HowTo';
   ]}
 />
 
-## Intoduction 📌
+## Introduction 📌
 
 A sample **_CRUD_** application to see how Keploy integrates effortlessly with **_Express.js_** and **_MongoDB_**. Get ready to see the power of Keploy 🔅🔅.
 

versioned_docs/version-4.0.0/server/installation.md

@@ -40,7 +40,7 @@ import InstallationGuide from '../concepts/installation.md'
     {
       name: "Download and install the Keploy binary",
       text: "Run: curl --silent -O -L https://keploy.io/install.sh && source install.sh",
-      url: "#-capturing-testcases",
+      url: "#capturing-testcases",
     },
     {
       name: "Verify the installation",
@@ -49,19 +49,19 @@ import InstallationGuide from '../concepts/installation.md'
     {
       name: "Record API calls for your app",
       text: "Run: keploy record -c \"CMD_TO_RUN_APP\" (for example, keploy record -c \"go run main.go\").",
-      url: "#-capturing-testcases",
+      url: "#capturing-testcases",
     },
     {
       name: "Replay the recorded tests",
       text: "Run: keploy test -c \"CMD_TO_RUN_APP\" --delay 10 to replay testcases and detect regressions.",
-      url: "#-running-testcases",
+      url: "#running-testcases",
     },
   ]}
 />
 
 <InstallationGuide/>
 
-## 🎬 Capturing Testcases
+## 🎬 Capturing Testcases {#capturing-testcases}
 
 To initiate the recording of API calls, execute this command in your terminal:
 
@@ -75,7 +75,7 @@ For example, if you're using a simple Golang program, the **CMD_TO_RUN_APP** wou
 keploy record -c "go run main.go"
 ```
 
-## 🏃 Running Testcases
+## 🏃 Running Testcases {#running-testcases}
 
 To run the testcases and see if there are any regressions introduced, use this terminal command: