selenium.dev modernisation: tracking issue and review order

Đang mở
#2,912 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
12/100
Loại issue
Tài liệu
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
hugo
Lĩnh vực
content, documentation

Hướng nghiên cứu

This is a tracking issue for a series of separate PRs, so it has no single change to make. Start from the linked items in the review order, such as the homepage hero in _index.en.html or the ai_agents.en.md rename, and pick one whose scope is small and unclaimed. Done means that item's PR merges and its listed translations are updated.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

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

2. Homepage

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

3. Getting started and downloads

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

4. Docs information architecture

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

5. AI agents

  • #2901 D1: Restructure the AI agents 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)
  • #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

Ngôn ngữ chính
HTML
Star
1.4k
Fork
1.6k
Merge trung bình
4 ngày 2 giờ
Pull request đã merge (30 ngày)
78

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của SeleniumHQ/seleniumhq.github.io

Tất cả issue của SeleniumHQ/seleniumhq.github.io

Issue tương tự

Thêm issue về Content

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.