From 7ad114245d20c6f2c8d84e1fee3b388436d549d8 Mon Sep 17 00:00:00 2001 From: Mohammad Saddam Hossain Date: Tue, 14 Jul 2026 12:43:36 +0530 Subject: [PATCH] docs(seo): verify sitemap + tighten generic page titles 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 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> --- docs-site/docs/accessibility.md | 3 ++- docs-site/docs/guides/parallel.md | 3 ++- docs-site/docs/guides/retry.md | 3 ++- docs-site/docs/guides/screenshots.md | 3 ++- docs-site/docs/guides/self-healing.md | 3 ++- docs-site/docs/guides/wait-engine.md | 3 ++- docs-site/docs/reporting/html-report.md | 3 ++- docs-site/docs/reporting/junit-xml.md | 3 ++- docs-site/docusaurus.config.js | 7 +++++++ 9 files changed, 23 insertions(+), 8 deletions(-) diff --git a/docs-site/docs/accessibility.md b/docs-site/docs/accessibility.md index bc43c87..99c41c0 100644 --- a/docs-site/docs/accessibility.md +++ b/docs-site/docs/accessibility.md @@ -1,7 +1,8 @@ --- description: "Accessibility testing in Selenium: assert WCAG compliance with bundled axe-core in one line, inside your existing Selenium tests, no extra tools." id: accessibility -title: Accessibility Assertions +title: Selenium Accessibility Testing +sidebar_label: Accessibility Assertions sidebar_position: 17 --- diff --git a/docs-site/docs/guides/parallel.md b/docs-site/docs/guides/parallel.md index 735d58f..4437354 100644 --- a/docs-site/docs/guides/parallel.md +++ b/docs-site/docs/guides/parallel.md @@ -1,7 +1,8 @@ --- description: "Parallel Selenium test execution: set the thread count in selenium-boot.yml and get thread-safe, isolated WebDriver instances automatically." id: parallel -title: Parallel Execution +title: Selenium Parallel Testing +sidebar_label: Parallel Execution sidebar_position: 5 --- diff --git a/docs-site/docs/guides/retry.md b/docs-site/docs/guides/retry.md index 2e99c4b..a0416ea 100644 --- a/docs-site/docs/guides/retry.md +++ b/docs-site/docs/guides/retry.md @@ -1,7 +1,8 @@ --- description: "Automatic retry for flaky Selenium tests: Selenium Boot re-runs failures with no IRetryAnalyzer wiring, enabled in a single config line." id: retry -title: Retry +title: Selenium Retry +sidebar_label: Retry sidebar_position: 4 --- diff --git a/docs-site/docs/guides/screenshots.md b/docs-site/docs/guides/screenshots.md index d9b3474..60b4eb9 100644 --- a/docs-site/docs/guides/screenshots.md +++ b/docs-site/docs/guides/screenshots.md @@ -1,7 +1,8 @@ --- description: "Automatic screenshots on Selenium test failure, embedded as Base64 in the HTML report, with no external image files or storage to manage." id: screenshots -title: Screenshots +title: Selenium Screenshots +sidebar_label: Screenshots sidebar_position: 8 --- diff --git a/docs-site/docs/guides/self-healing.md b/docs-site/docs/guides/self-healing.md index a729877..5ad808d 100644 --- a/docs-site/docs/guides/self-healing.md +++ b/docs-site/docs/guides/self-healing.md @@ -1,7 +1,8 @@ --- description: "Self-healing Selenium locators: when a selector breaks, the framework falls back through id, name, text, and data-testid and flags every heal." id: self-healing -title: Self-Healing Locators +title: Selenium Self-Healing Locators +sidebar_label: Self-Healing Locators sidebar_position: 10 --- diff --git a/docs-site/docs/guides/wait-engine.md b/docs-site/docs/guides/wait-engine.md index 7ca77a2..525a87f 100644 --- a/docs-site/docs/guides/wait-engine.md +++ b/docs-site/docs/guides/wait-engine.md @@ -1,7 +1,8 @@ --- description: "Explicit waits in Selenium without Thread.sleep(): WaitEngine gives fluent, auto-configured waits driven by your selenium-boot.yml timeout." id: wait-engine -title: WaitEngine +title: Selenium Waits (WaitEngine) +sidebar_label: WaitEngine sidebar_position: 3 --- diff --git a/docs-site/docs/reporting/html-report.md b/docs-site/docs/reporting/html-report.md index 590c7b3..19bf3a4 100644 --- a/docs-site/docs/reporting/html-report.md +++ b/docs-site/docs/reporting/html-report.md @@ -1,7 +1,8 @@ --- description: "Selenium Boot HTML report: a self-contained dashboard with pass-rate gauge, retries, screenshots, flakiness radar, and dark mode, no server needed." id: html-report -title: HTML Report +title: Selenium HTML Report +sidebar_label: HTML Report sidebar_position: 1 --- diff --git a/docs-site/docs/reporting/junit-xml.md b/docs-site/docs/reporting/junit-xml.md index fca1176..7d2ffa7 100644 --- a/docs-site/docs/reporting/junit-xml.md +++ b/docs-site/docs/reporting/junit-xml.md @@ -1,7 +1,8 @@ --- description: "Selenium Boot emits JUnit-compatible XML that Jenkins, GitHub Actions, and GitLab CI parse natively for standard test result reporting." id: junit-xml -title: JUnit XML +title: Selenium JUnit XML Report +sidebar_label: JUnit XML sidebar_position: 2 --- diff --git a/docs-site/docusaurus.config.js b/docs-site/docusaurus.config.js index 9104c6e..9ce2938 100644 --- a/docs-site/docusaurus.config.js +++ b/docs-site/docusaurus.config.js @@ -36,6 +36,13 @@ const config = { theme: { customCss: require.resolve('./src/css/custom.css'), }, + // Explicit so sitemap generation can't be silently disabled. + // Ships with preset-classic; emits build/sitemap.xml listing all pages. + sitemap: { + changefreq: 'weekly', + priority: 0.5, + filename: 'sitemap.xml', + }, }), ], ],