Skip to content

Fix metadata on Selenium Manager and WebDriver BiDi pages - #2769

Open
AutomatedTester wants to merge 2 commits into
trunkfrom
sprint-0-metadata-fixes
Open

Fix metadata on Selenium Manager and WebDriver BiDi pages#2769
AutomatedTester wants to merge 2 commits into
trunkfrom
sprint-0-metadata-fixes

Conversation

@AutomatedTester

Copy link
Copy Markdown
Member

Description

Three frontmatter corrections on documentation pages whose body content is already accurate, but whose metadata undercuts or hides it. No prose or code changes.

  1. selenium_manager.*.md — drop "(Beta)" from the title. Selenium Manager shipped in 4.6 and is the default driver manager in every binding. The page did carry a real caveat — the body notes that Selenium Manager uses a 0.x version scheme "because it is still in beta" — but that is much narrower than a title-level "(Beta)" implies, so it stays in the body where it is accurate and scoped. linkTitle was already "Selenium Manager", so navigation is unchanged.

  2. webdriver/bidi/w3c/_index.en.md — fix an inverted description. It read "Examples of working with Chrome DevTools Protocol in Selenium. CDP support is temporary until WebDriver BiDi has been implemented." — copy-pasted from webdriver/bidi/cdp/_index.en.md, where the same text is correct. So the page documenting the vendor-neutral W3C standard described itself as being about CDP. Replaced with a description of the W3C protocol.

  3. webdriver/bidi/_index.*.md — add a missing description, and retitle. This landing page had no description field at all, so it had no meta description. Its title was "BiDirectional functionality", which never contains the string readers actually search for: "WebDriver BiDi". Retitled to "WebDriver BiDi"; linkTitle: "BiDi" and every alias are unchanged, so no URLs move.

Applied across en, ja, pt-br and zh-cn, since these are corrections rather than new content. The CDP description paste was English-only — the translated w3c pages have no description at all, so there was nothing to correct there.

Motivation and Context

These are pages that already say the right thing and are hard to find.

Searching for "what is webdriver bidi" surfaces MDN, Puppeteer, MozillaWiki, Chrome for Developers and the W3C spec — but not selenium.dev, even though /documentation/webdriver/bidi/ exists, is accurate, and Selenium co-drove the standard. A landing page with no meta description and a title that omits the term is a plausible mechanical cause.

Similarly, "(Beta)" in the Selenium Manager title actively works against the page: it is the page people and tools land on to answer "do I still need WebDriverManager / to download chromedriver", and a Beta label in the title reads as "not ready" for a feature that has been the default since 4.6.

Types of changes

  • Change to the site
  • Code example added (and I also added the example to all translated languages)
  • Improved translation
  • Added new translation (and I also added a notice to each document missing translation)

The ja, zh-cn and pt-br descriptions are newly written rather than copied from English — a native-speaker glance on those three lines would be welcome.

Checklist

  • I have read the contributing document.
  • I have used hugo to render the site/docs locally and I am sure it works.

Verified locally: all nine frontmatter blocks parse as valid YAML; Hugo renders the new titles and descriptions into <title>, <meta name=description>, og:title/og:description, twitter:description and the JSON-LD description; all aliases are preserved (6 on each BiDi index, 3 on w3c) and no URL changed.

Two notes for the reviewer:

  • I have not checked a Netlify deploy preview yet, since it builds from this PR.
  • ./build-site.sh does not run clean on Hugo 0.164 for reasons unrelated to this change: the new security.allowContent default rejects the repo's .html content files, PostCSS now shells out to node which is absent from security.exec.allow in hugo.toml, and the gist/twitter shortcodes used in some blog posts were removed in Hugo 0.156. The repo pins 0.148.2 in netlify.toml, so CI is unaffected — but that drift will need addressing before any Hugo upgrade. With those three overridden locally, the full site renders (2170 pages).

🤖 Generated with Claude Code

AutomatedTester and others added 2 commits August 10, 2026 08:59
Three frontmatter corrections on pages whose content is already accurate but
whose metadata undercuts or hides it.

- Drop "(Beta)" from the Selenium Manager title. It shipped in 4.6 and is the
  default driver manager in every binding. The narrower, still-accurate caveat
  about the 0.x versioning scheme stays in the body where it belongs.

- Fix the description on the W3C BiDi page. It was copy-pasted from the CDP
  page, so the page documenting the vendor-neutral W3C standard described
  itself as being about the Chrome DevTools Protocol.

- Give the BiDi landing page a description, which it did not have, and retitle
  it "WebDriver BiDi" so the page name contains the term readers search for.
  linkTitle and all aliases are unchanged, so no URLs move.

Applied across en, ja, pt-br and zh-cn, since these are corrections rather
than new content. The CDP description paste was English-only; the translated
W3C pages had no description to correct.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 11, 2026

Copy link
Copy Markdown

Deploy Preview for selenium-dev ready!

Name Link
🔨 Latest commit 0f4c287
🔍 Latest deploy log https://app.netlify.com/projects/selenium-dev/deploys/6a7aeb53aabc2d0008945653
😎 Deploy Preview https://deploy-preview-2769--selenium-dev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

1 participant