Skip to content

docs(seo): verify sitemap.xml + tighten generic page titles - #20

Merged
shossain786 merged 1 commit into
masterfrom
docs/seo-hygiene
Jul 14, 2026
Merged

shossain786 merged 1 commit into
masterfrom
docs/seo-hygiene

Conversation

@shossain786

Copy link
Copy Markdown
Contributor

Closes #7

1. Sitemap

Confirmed the Docusaurus sitemap plugin (ships with preset-classic) is active and not disabled — npm run build emits build/sitemap.xml with 52 <loc> entries covering all doc pages (including the new migration / why / recipes pages). Made the config explicit in docusaurus.config.js so it can't be silently turned off in a future edit.

2. Generic titles → search-friendly

Prefixed a focused set of generic page <title>s with "Selenium" for search intent, using the frontmatter title / sidebar_label split so the sidebar labels and visible H1s stay short and clean:

Page <title> (SEO) Sidebar / H1 (unchanged)
retry Selenium Retry Retry
screenshots Selenium Screenshots Screenshots
parallel Selenium Parallel Testing Parallel Execution
wait-engine Selenium Waits (WaitEngine) WaitEngine
self-healing Selenium Self-Healing Locators Self-Healing Locators
accessibility Selenium Accessibility Testing Accessibility Assertions
html-report Selenium HTML Report HTML Report
junit-xml Selenium JUnit XML Report JUnit XML

Acceptance criteria

  • sitemap.xml present in build/ and lists all doc pages (52 URLs)
  • Generic titles prefixed with "Selenium" where it reads naturally
  • npm run build passes

Verification

Confirmed in built HTML: <title> tags now read Selenium X | Selenium Boot, while the page H1 (Retry) and sidebar link (Retry) stayed short — the split works.

🤖 Generated with Claude Code

Closes #7

Sitemap: confirmed preset-classic emits build/sitemap.xml (52 URLs, all
doc pages) and made the config explicit so it can't be silently disabled.

Titles: prefixed a focused set of generic page <title>s with "Selenium"
for search, using the frontmatter title / sidebar_label split so the
sidebar labels and visible H1s stay short and clean:

- Retry                -> Selenium Retry
- Screenshots          -> Selenium Screenshots
- Parallel Execution   -> Selenium Parallel Testing
- WaitEngine           -> Selenium Waits (WaitEngine)
- Self-Healing Locators-> Selenium Self-Healing Locators
- Accessibility        -> Selenium Accessibility Testing
- HTML Report          -> Selenium HTML Report
- JUnit XML            -> Selenium JUnit XML Report

Verified: sitemap present with 52 <loc> entries; new <title> tags emitted
in built HTML; sidebar labels and H1s unchanged. Build passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shossain786
shossain786 merged commit e189466 into master Jul 14, 2026
2 checks passed
@shossain786
shossain786 deleted the docs/seo-hygiene branch July 14, 2026 07:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs SEO: verify sitemap.xml generation and tighten generic page titles

1 participant