Skip to content

PSA blog post for upgrading the Selenium client - #2772

Closed
StuMinch wants to merge 2 commits into
SeleniumHQ:trunkfrom
StuMinch:trunk
Closed

PSA blog post for upgrading the Selenium client#2772
StuMinch wants to merge 2 commits into
SeleniumHQ:trunkfrom
StuMinch:trunk

Conversation

@StuMinch

Copy link
Copy Markdown

Thanks for contributing to the Selenium site and documentation!
A PR well described will help maintainers to review and merge it quickly

Before submitting your PR, please check our contributing guidelines.
Avoid large PRs, and help reviewers by making them as simple and short as possible.

Description

This PR is for a blog post that covers the topic of reminding our community to frequently check the version of Selenium Client that they have installed.

Motivation and Context

The motivation behind this blog post is to remind the community to maintain their test environment and stay current with the latest Selenium Client in order to avoid becoming outdated and experience flakiness with their tests.

@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

👷 Deploy request for selenium-dev pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit b6dee56

@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Stuart Minchington seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@qodo-code-review

Copy link
Copy Markdown
Contributor

PR Summary by Qodo

Add PSA blog post: why keeping Selenium clients updated matters

📝 Documentation 🕐 Less than 10 minutes

Grey Divider

AI Description

• Add a new blog post reminding users to regularly upgrade Selenium client bindings.
• Explain how browser release cadence can cause flakiness when clients lag behind.
• Point readers to Selenium downloads and official channels for updates.
Diagram

graph TD
  A["Blog post (Markdown)"] --> B["Hugo site build"] --> C["Selenium.dev blog"]
  A --> D["Downloads page"]

  subgraph Legend
    direction LR
    _doc["Content"] ~~~ _build["Build step"] ~~~ _site["Published page"] ~~~ _link["Internal link"]
  end
Loading
High-Level Assessment

Publishing this guidance as a blog post is appropriate: it is timely, discoverable, and easy to share. Alternatives like a permanent docs page or release-note callouts were considered, but they dilute the PSA urgency and are harder to broadcast to the broader community.

Files changed (1) +70 / -0

Documentation (1) +70 / -0
selenium-client-update-psa.mdNew blog post: PSA on upgrading Selenium client versions +70/-0

New blog post: PSA on upgrading Selenium client versions

• Introduces a new blog entry with Hugo front matter (title/date/tags/categories/hero image). The post explains how outdated Selenium client bindings can cause flaky tests due to rapid browser changes and encourages a recurring upgrade habit, linking to the downloads page and SeleniumHQ social channels.

website_and_docs/content/blog/2026/selenium-client-update-psa.md

@qodo-code-review

qodo-code-review Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Code Review by Qodo

🐞 Bugs (2) 📘 Rule violations (1) 📜 Skill insights (0)

Grey Divider


Remediation recommended

1. Unexplained Appium callout 🐞 Bug ⚙ Maintainability ⭐ New
Description
Line 51 expands the call-to-action to “Selenium or Appium” even though the post attributes the root
cause to the Selenium client and never discusses Appium, which makes the guidance ambiguous about
what readers should update and where to find the right Appium info.
Code

website_and_docs/content/blog/2026/selenium-client-update-psa.md[51]

+If you have not checked your Selenium or Appium version recently, take a moment to do it today.
Evidence
The post explicitly states the underlying issue is the Selenium client version and asks what
Selenium version the reader is running; it does not otherwise mention Appium or provide an Appium
reference, but line 51 introduces Appium in the CTA.

website_and_docs/content/blog/2026/selenium-client-update-psa.md[14-17]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[48-51]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-64]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The post is scoped to Selenium client upgrades, but the final CTA mentions Appium without any explanation or Appium-specific link, which can confuse readers.

## Issue Context
Earlier sections explicitly frame the problem and question as being about the Selenium client/version, and the only referenced resource is Selenium’s downloads page.

## Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[49-51]
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-64]

## Suggested fix
Either:
1) Remove “or Appium” from the sentence, keeping the CTA consistent with the post’s Selenium-only scope, **or**
2) Add 1–2 sentences explaining why Appium users are included (e.g., relationship/dependency), and add an explicit Appium resource link (and optionally update tags/categories if that’s the editorial standard).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


2. title uses Title Case 📘 Rule violation ✧ Quality
Description
The new blog post front matter sets title in Title Capitalization instead of the sentence
capitalization required by the central style guide. This can create inconsistent page titles across
the site.
Code

website_and_docs/content/blog/2026/selenium-client-update-psa.md[R2-3]

+title: "Why Keeping Selenium Updated Matters"
+linkTitle: "Why Keeping Selenium Updated Matters"
Evidence
The style guide explicitly requires Title Capitalization for linkTitle and sentence capitalization
for title. The new blog post sets both title and linkTitle to Title Capitalization, violating
that rule.

Rule 2141344: Documentation changes must follow the central style guide file
website_and_docs/content/documentation/about/style.en.md[33-38]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[1-4]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The blog post front matter uses Title Capitalization for `title`, but the style guide requires sentence capitalization for `title` and Title Capitalization for `linkTitle`.

## Issue Context
`website_and_docs/content/documentation/about/style.en.md` explicitly defines capitalization rules for `title` vs `linkTitle`.

## Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[2-4]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools



Informational

3. Unused reference links 🐞 Bug ⚙ Maintainability
Description
The post defines [bindings], [team], and [BiDi] reference links but never uses them in the
document body, leaving dead Markdown definitions. This adds maintenance noise and suggests the
intended links are missing.
Code

website_and_docs/content/blog/2026/selenium-client-update-psa.md[R66-69]

+[bindings]: /downloads#bindings
+
+[team]: /project/structure
+
Evidence
The body references only [downloads], while [bindings], [team], and [BiDi] appear only as
bottom-of-file definitions and are not referenced elsewhere in the document.

website_and_docs/content/blog/2026/selenium-client-update-psa.md[19-20]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-70]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The blog post defines reference-style link labels that are never referenced in the content (`[bindings]`, `[team]`, `[BiDi]`). These should either be removed or the corresponding links should be added in the article body.

### Issue Context
`[downloads]` is referenced in the body, but the other three reference labels appear only as definitions at the bottom of the file.

### Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-70]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Context
✅ Compliance rules (platform): 10 rules

Grey Divider

Tip of the day
💡 Did you know, you can describe a rule in plain language on the Rules page and Qodo drafts it for you

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Previous review results

Review updated until commit b6dee56 ⚖️ Balanced

Results up to commit 1b4ea30 ⚖️ Balanced


🐞 Bugs (1) 📘 Rule violations (1) 📎 Requirement gaps (0) 🎨 UX issues (0) 🔗 Cross-repo conflicts (0) 📜 Skill insights (0)


Remediation recommended
1. title uses Title Case 📘 Rule violation ✧ Quality
Description
The new blog post front matter sets title in Title Capitalization instead of the sentence
capitalization required by the central style guide. This can create inconsistent page titles across
the site.
Code

website_and_docs/content/blog/2026/selenium-client-update-psa.md[R2-3]

+title: "Why Keeping Selenium Updated Matters"
+linkTitle: "Why Keeping Selenium Updated Matters"
Evidence
The style guide explicitly requires Title Capitalization for linkTitle and sentence capitalization
for title. The new blog post sets both title and linkTitle to Title Capitalization, violating
that rule.

Rule 2141344: Documentation changes must follow the central style guide file
website_and_docs/content/documentation/about/style.en.md[33-38]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[1-4]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The blog post front matter uses Title Capitalization for `title`, but the style guide requires sentence capitalization for `title` and Title Capitalization for `linkTitle`.

## Issue Context
`website_and_docs/content/documentation/about/style.en.md` explicitly defines capitalization rules for `title` vs `linkTitle`.

## Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[2-4]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools



Informational
2. Unused reference links 🐞 Bug ⚙ Maintainability
Description
The post defines [bindings], [team], and [BiDi] reference links but never uses them in the
document body, leaving dead Markdown definitions. This adds maintenance noise and suggests the
intended links are missing.
Code

website_and_docs/content/blog/2026/selenium-client-update-psa.md[R66-69]

+[bindings]: /downloads#bindings
+
+[team]: /project/structure
+
Evidence
The body references only [downloads], while [bindings], [team], and [BiDi] appear only as
bottom-of-file definitions and are not referenced elsewhere in the document.

website_and_docs/content/blog/2026/selenium-client-update-psa.md[19-20]
website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-70]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The blog post defines reference-style link labels that are never referenced in the content (`[bindings]`, `[team]`, `[BiDi]`). These should either be removed or the corresponding links should be added in the article body.

### Issue Context
`[downloads]` is referenced in the body, but the other three reference labels appear only as definitions at the bottom of the file.

### Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-70]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Qodo Logo

Comment on lines +2 to +3
title: "Why Keeping Selenium Updated Matters"
linkTitle: "Why Keeping Selenium Updated Matters"

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.

Remediation recommended

1. title uses title case 📘 Rule violation ✧ Quality

The new blog post front matter sets title in Title Capitalization instead of the sentence
capitalization required by the central style guide. This can create inconsistent page titles across
the site.
Agent Prompt
## Issue description
The blog post front matter uses Title Capitalization for `title`, but the style guide requires sentence capitalization for `title` and Title Capitalization for `linkTitle`.

## Issue Context
`website_and_docs/content/documentation/about/style.en.md` explicitly defines capitalization rules for `title` vs `linkTitle`.

## Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[2-4]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

Comment on lines +66 to +69
[bindings]: /downloads#bindings

[team]: /project/structure

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.

Informational

2. Unused reference links 🐞 Bug ⚙ Maintainability

The post defines [bindings], [team], and [BiDi] reference links but never uses them in the
document body, leaving dead Markdown definitions. This adds maintenance noise and suggests the
intended links are missing.
Agent Prompt
### Issue description
The blog post defines reference-style link labels that are never referenced in the content (`[bindings]`, `[team]`, `[BiDi]`). These should either be removed or the corresponding links should be added in the article body.

### Issue Context
`[downloads]` is referenced in the body, but the other three reference labels appear only as definitions at the bottom of the file.

### Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-70]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

If you are seeing errors that do not make sense or flakiness that seems unexplainable, start with a simple question:
What version of Selenium are you running?

If you have not checked your Selenium or Appium version recently, take a moment to do it today.

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.

Remediation recommended

1. Unexplained appium callout 🐞 Bug ⚙ Maintainability

Line 51 expands the call-to-action to “Selenium or Appium” even though the post attributes the root
cause to the Selenium client and never discusses Appium, which makes the guidance ambiguous about
what readers should update and where to find the right Appium info.
Agent Prompt
## Issue description
The post is scoped to Selenium client upgrades, but the final CTA mentions Appium without any explanation or Appium-specific link, which can confuse readers.

## Issue Context
Earlier sections explicitly frame the problem and question as being about the Selenium client/version, and the only referenced resource is Selenium’s downloads page.

## Fix Focus Areas
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[49-51]
- website_and_docs/content/blog/2026/selenium-client-update-psa.md[64-64]

## Suggested fix
Either:
1) Remove “or Appium” from the sentence, keeping the CTA consistent with the post’s Selenium-only scope, **or**
2) Add 1–2 sentences explaining why Appium users are included (e.g., relationship/dependency), and add an explicit Appium resource link (and optionally update tags/categories if that’s the editorial standard).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

@qodo-code-review

Copy link
Copy Markdown
Contributor

Code review by qodo was updated up to the latest commit b6dee56

@StuMinch StuMinch closed this Aug 14, 2026
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.

2 participants