Skip to content

docs(why): add "Why Selenium Boot / not plain Selenium / not Playwright" pages - #17

Merged
shossain786 merged 1 commit into
masterfrom
docs/why-pages
Jul 14, 2026
Merged

shossain786 merged 1 commit into
masterfrom
docs/why-pages

Conversation

@shossain786

Copy link
Copy Markdown
Contributor

Closes #5

What

Adds three top-of-funnel "Why" pages under docs-site/docs/why/, adapted from the intro Design Philosophy and README (most material already existed):

  • Why Selenium Boot? — the layered philosophy (opinionated core → never hides Selenium → extensible toolkit) + an outcome-led "what you get for one dependency" table.
  • Why not plain Selenium? — the boilerplate-you-own argument (DriverFactory, WaitUtils, retry analyzer, screenshot listener, reporting glue), the "…without hiding Selenium" escape hatch, and incremental adoption.
  • Why not Playwright? — honest and explicitly does not claim to replace Playwright; cross-links to the Coming from Playwright bridge page rather than duplicating it.

Notes

  • New Why Selenium Boot sidebar category, placed right after the intro (developers adopt a philosophy before an API).
  • Pages cross-link to the guides and migration pages instead of duplicating them — keeps SEO authority consolidated rather than split.
  • Consistent with our canonical positioning (Playwright as a real, non-combative comparison).

Acceptance criteria

  • 3 pages created, each with description: frontmatter (SEO)
  • Linked in the sidebar (sidebars.js)
  • npm run build passes (no broken links/anchors)

🤖 Generated with Claude Code

…ht" pages

Closes #5

Three top-of-funnel philosophy pages under docs/why/, adapted from the
intro Design Philosophy and README:

- Why Selenium Boot? — layered philosophy + outcome-led "what you get" table
- Why not plain Selenium? — the boilerplate-you-own argument, without
  hiding Selenium; incremental adoption
- Why not Playwright? — honest, does NOT claim to replace Playwright;
  cross-links to the Coming-from-Playwright bridge page

New "Why Selenium Boot" sidebar category placed right after the intro.
Pages cross-link to guides and migration pages instead of duplicating
content (keeps SEO authority consolidated). SEO description frontmatter
on all three. Build passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shossain786
shossain786 merged commit edf9077 into master Jul 14, 2026
2 checks passed
@shossain786
shossain786 deleted the docs/why-pages branch July 14, 2026 03:56
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: add "Why" pages (Why Selenium Boot / Why not plain Selenium / Why not Playwright)

1 participant