selenium.dev modernisation: tracking issue and review order #2912

This issue tracks the selenium.dev modernisation work: a set of small PRs, one per item, that together turn the site into something a newcomer or a coding agent can use in under a minute. Review each PR on its own; this issue shows where it all leads and the order to take them in.

Where we want to be

• A homepage that says what Selenium does and shows the install command and first script above the fold, with no event banner going stale.
• Getting started on one page: install, first script, run it as a test, next steps.
• Docs organised by the reader's problem (a Guides section) on top of the API reference, with a site-wide language picker, search, and an on-page table of contents.
• Legacy (Selenium 2/3), IE Driver Server and CDP material kept but clearly marked and demoted.
• A first-class AI agents section: setup per tool, a curated llms.txt/llms-full.txt, and a "wrong vs right" page for the patterns agents keep producing.
• Selenium IDE removed from the site; its page kept under Legacy for old links.

Review order

Each PR is independent of trunk and can merge on its own, but reviewing in this order means the pages you land on already look the way the next PR expects. Merge dependencies are noted.

1. Remove and tidy first

• A5: Remove Selenium IDE from the site #2892 A5: Remove Selenium IDE from the site — dropped: the IDE is being released again (diemol), so it stays on the site
• A3: Dated event banner #2893 A3: Dated event banner (config-driven, hides itself outside its window)

2. Homepage

• A1: Rewrite the homepage hero #2894 A1: Rewrite the homepage hero (merge after A5; takes A1's _index.en.html)
• A2: "Used by" strip and GitHub stars #2895 A2: "Used by" strip and GitHub stars (placeholders until logos are cleared)

3. Getting started and downloads

• B1: Collapse Getting Started into one page (includes B2) #2896 B1+B2: Collapse Getting Started into one page, with the Selenium Manager callout
• B3: Split the Downloads page #2897 B3: Split the Downloads page into install and archive

4. Docs information architecture

• C3: Demote Legacy, IE Driver Server and CDP in the sidebar #2898 C3: Demote Legacy, IE Driver Server and CDP in the sidebar
• C4: Docs search and on-page TOC #2899 C4: Docs search and on-page table of contents
• C5: Release notes page in the docs #2900 C5: Release notes page in the docs
• C1: Site-wide language picker #2904 C1: Site-wide language picker (please click through the deploy preview)
• C2: Task-based Guides section #2911 C2: Task-based Guides section (new; links into pages as they are on trunk)

5. AI agents

• D1: Restructure the AI agents page #2901 D1: Restructure the AI agents page
• D5: Outdated Selenium patterns page #2903 D5: Outdated Selenium patterns page (merge after D1; both rename ai_agents.en.md → ai_agents/_index.en.md, second one needs a trivial rebase)
• D3: Audit and extend llms.txt #2902 D3: Audit llms.txt and add llms-full.txt (merge last; it lists pages added by C2, C5 and D5)

6. Follow-ups once the above are in

• A4: add "Guides" and "AI agents" to the top navigation
• B4: screenshots for Getting Started and Grid
• B5: CI page under Getting Started
• D2: per-tool agent install snippets
• Fix stale gh-codeblock line ranges found on existing pages (cookies, file upload, alerts, BiDi network)
• Translations: each PR lists the ja, pt-br and zh-cn pages that now need updating

Review comments so far

These PRs were briefly combined into four workstream PRs (#2905, #2906, #2907, #2908), now closed. Review comments made there have been addressed on the item branches; the threads are still readable on the closed PRs. Open question from that review: the date Selenium IDE stopped being maintained, for the note on the legacy IDE page.

Notes for reviewers

• CI builds fetch every code sample from the GitHub API with a shared token, so more than about seven site builds in an hour fail with rate limiting. If a build fails in under 20 seconds, re-run it later rather than looking for a fault in the PR.
• Disclosure: the drafts were prepared with Claude (Anthropic); the author reviewed and edited all content, per the project's AI-assisted contributions policy.

Generated by Claude Code