Skip to content

Navigation Menu

Sign in
Sign up

fix(seo): restore query-matching titles + Related Terms on top glossary pages - #904

Open
nehagup wants to merge 1 commit into
aeo from
seo/aeo-glossary-corrections
Open

fix(seo): restore query-matching titles + Related Terms on top glossary pages #904
nehagup wants to merge 1 commit into
aeo from
seo/aeo-glossary-corrections

Conversation

@nehagup

@nehagup nehagup commented Sep 8, 2026

Copy link
Copy Markdown
Member

Why

Stacked on aeo. While preparing docs AEO work I found this branch is SEO-regressive on the highest-impression glossary pages — it downgraded the titles that match real search demand and deleted the internal ## Related Terms blocks. This PR restores them (surgically, from main), preserving the branch's body/FAQ edits.

Evidence (GSC, 12 mo)

Page Signal Title on aeo → restored
idempotency ~1M impressions, ranks "idempotency" "How Idempotent REST APIs Improve Reliability" → "What is Idempotency in REST APIs? Complete Guide"
mocks ranks "mocks", "mock vs stub" "How to perform Data Mocking using AI" → "What are Mocks in Testing? Mocks vs Stubs vs Fakes"
integration-testing head term "Integration Testing With Keploy" → "Integration Testing: Types, Tools & Best Practices"
black-box-testing 117K impressions, pos 12 "Mastering Black Box Testing Techniques" → "What is Black Box Testing? Types, Techniques & Examples"
load-testing restored descriptive title

Every one of these (+ grpc) also had its ## Related Terms internal-link block deleted — restored on all six.

What changed

  • Restored frontmatter title + description (verbatim from main) on 5 pages.
  • Restored the ## Related Terms block (internal links) on all 6.
  • No body content changed, no fabricated stats. ~9 lines/page.

Note for the branch owner

The title/link downgrades look systematic across the glossary — worth checking the rest of the aeo batch for the same pattern before merge, since narrower/branded titles and removed interlinks hurt both Google ranking and AI-answer citation.

🤖 Generated with Claude Code

Copilot AI lite review requested due to automatic review settings September 8, 2026 16:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

Only a minor link-text spelling consistency issue was found, with no functional or structural problems in the restored metadata/sections.

Pull request overview

Restores SEO-optimized frontmatter titles/descriptions and reintroduces ## Related Terms internal-link blocks on high-impression glossary pages, aligning the aeo branch’s glossary metadata and cross-linking with main while leaving body/FAQ content intact.

Changes:

  • Restored query-matching title and description frontmatter on key glossary docs.
  • Re-added ## Related Terms sections to strengthen internal linking between glossary concepts.
  • Applied the same "Related Terms" pattern to gRPC to restore cross-navigation consistency.
File summaries
File Description
versioned_docs/version-4.0.0/concepts/reference/glossary/mocks.md Restores SEO frontmatter and adds Related Terms links for testing concepts.
versioned_docs/version-4.0.0/concepts/reference/glossary/load-testing.md Updates title/description for search intent and adds Related Terms section.
versioned_docs/version-4.0.0/concepts/reference/glossary/integration-testing.md Restores descriptive title/description and appends Related Terms cross-links.
versioned_docs/version-4.0.0/concepts/reference/glossary/idempotency.md Restores query-matching title/description and adds Related Terms section.
versioned_docs/version-4.0.0/concepts/reference/glossary/grpc.md Adds Related Terms block to restore internal glossary linking.
versioned_docs/version-4.0.0/concepts/reference/glossary/black-box-testing.md Restores SEO frontmatter and adds Related Terms block (one link-text consistency nit noted).
Review details
  • Files reviewed: 6/6 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread versioned_docs/version-4.0.0/concepts/reference/glossary/black-box-testing.md Outdated
...ossary pages
The aeo branch downgraded the titles that match real search demand and
removed the internal "Related Terms" blocks on the highest-impression
glossary pages. Restore them from main (surgical — preserves the branch's
body/FAQ edits):
- idempotency (1M impressions/yr): "How Idempotent REST APIs Improve
 Reliability" -> "What is Idempotency in REST APIs? Complete Guide"
- mocks: "How to perform Data Mocking using AI" -> "What are Mocks in
 Testing? Mocks vs Stubs vs Fakes" (recovers the mock-vs-stub cluster)
- integration-testing: "Integration Testing With Keploy" -> "Integration
 Testing: Types, Tools & Best Practices"
- black-box-testing (117K impressions): restore "What is Black Box
 Testing? Types, Techniques & Examples"
- load-testing: restore descriptive title
- grpc + all above: restore the deleted "## Related Terms" internal links
Titles/descriptions and Related Terms taken verbatim from origin/main.
No body content changed; no fabricated stats.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Neha Gupta <gneha21@yahoo.com>
nehagup force-pushed the seo/aeo-glossary-corrections branch 2 times, most recently from df7145f to f3a7608 Compare September 8, 2026 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort, defaults to Lite
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

AltStyle によって変換されたページ (->オリジナル) /