Skip to content

Commit 4898b35

Browse files
rpallavisharmarpallavisharma
authored
Merge branch 'trunk' into dependabot/npm_and_yarn/website_and_docs/yaml-2.8.3
2 parents 65cb2ca + 7275687 commit 4898b35

78 files changed

Lines changed: 745 additions & 426 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/copilot-instructions.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
When reviewing a pull request, also follow the guidelines in .github/pr_review.md.

‎.github/pr_review.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# PR Review Guidelines
2+
3+
Use these guidelines when reviewing pull requests for this documentation repository.
4+
5+
## Priorities
6+
7+
- First look for changes that can break rendered documentation: malformed Markdown, Hugo
8+
shortcodes, `tabpane` / `tab` pairs, code fences, front matter, anchors, or translated page
9+
structure. Small whitespace and delimiter changes can break code blocks or entire sections.
10+
- Treat `gh-codeblock` paths and line ranges as correctness-sensitive. If `examples/` changed,
11+
search `website_and_docs/content` for references to the changed files. If docs changed a
12+
`gh-codeblock`, verify the path still exists and the line range shows exactly the intended
13+
snippet.
14+
- Check translation maintenance against `website_and_docs/content/documentation/about/style.en.md`.
15+
English text changes do not require translated files in the same PR, but changed translation
16+
files must preserve working front matter, shortcodes, tabs, code blocks, and example references.
17+
When the style guide requires translated code examples, verify the matching translated files were
18+
updated.
19+
- For examples, review code correctness only as it affects the published docs: runnable snippets,
20+
assertions where practical, stable demo pages, and matching documentation references.
21+
22+
## Documentation checks
23+
24+
- Front matter should match the surrounding page style.
25+
- `linkTitle` should be short and title-cased; `title` should use sentence case.
26+
- General prose should be language-independent. Put binding-specific code or behavior in language
27+
tabs.
28+
- When all tabs use `gh-codeblock`, the `tabpane` should use `text=true`. When only some tabs use
29+
shortcodes or markdown, those tabs need `text=true`.
30+
- `gh-codeblock` lines must not be indented. Plain text in markdown tabs also must not be
31+
accidentally indented into a code block.
32+
33+
## Do not comment on
34+
35+
- Missing translated files for ordinary English text changes.
36+
- Subjective wording preferences unless the text is inaccurate, confusing, or inconsistent with
37+
the Selenium docs style guide.
38+
- Formatting nits that do not affect rendering, code block structure, shortcode parsing, or
39+
maintainability.
40+
- CI status without a clear connection to the diff.
41+
42+
## Review style
43+
44+
- Label severity as blocking, important, or minor.
45+
- Make each comment actionable: state the risk, why it matters, and the smallest fix.
46+
- Include file and line context when possible.
47+
- Do not leave duplicate comments for the same root cause.
48+
- It is acceptable to report no findings.

‎.github/workflows/dotnet-examples.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ on:
1515
paths:
1616
- 'examples/dotnet/**'
1717

18+
concurrency:
19+
group: ${{ github.workflow }}-${{ github.ref }}
20+
cancel-in-progress: true
21+
1822
env:
1923
DISPLAY: :99
2024
GITHUB_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
@@ -25,7 +29,7 @@ jobs:
2529
strategy:
2630
fail-fast: false
2731
matrix:
28-
os: [ ubuntu, windows, macos ]
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
2933
release: [ stable, nightly ]
3034
runs-on: ${{ format('{0}-latest', matrix.os) }}
3135
steps:

‎.github/workflows/java-examples.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ jobs:
2929
strategy:
3030
fail-fast: false
3131
matrix:
32-
os: [ ubuntu, windows, macos ]
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
3333
release: [ stable, nightly ]
3434
runs-on: ${{ format('{0}-latest', matrix.os) }}
3535
steps:

‎.github/workflows/js-examples.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ on:
1515
paths:
1616
- 'examples/javascript/**'
1717

18+
concurrency:
19+
group: ${{ github.workflow }}-${{ github.ref }}
20+
cancel-in-progress: true
21+
1822
env:
1923
DISPLAY: :99
2024
GITHUB_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
@@ -25,7 +29,7 @@ jobs:
2529
strategy:
2630
fail-fast: false
2731
matrix:
28-
os: [ ubuntu, windows, macos ]
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
2933
release: [ stable, nightly ]
3034
runs-on: ${{ format('{0}-latest', matrix.os) }}
3135
steps:

‎.github/workflows/kotlin-examples.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ on:
1515
paths:
1616
- 'examples/kotlin/**'
1717

18+
concurrency:
19+
group: ${{ github.workflow }}-${{ github.ref }}
20+
cancel-in-progress: true
21+
1822
env:
1923
DISPLAY: :99
2024
GITHUB_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
@@ -25,7 +29,7 @@ jobs:
2529
strategy:
2630
fail-fast: false
2731
matrix:
28-
os: [ ubuntu, windows, macos ]
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
2933
runs-on: ${{ format('{0}-latest', matrix.os) }}
3034
steps:
3135
- name: Checkout GitHub repo

‎.github/workflows/python-examples.yml‎

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ on:
1515
paths:
1616
- 'examples/python/**'
1717

18+
concurrency:
19+
group: ${{ github.workflow }}-${{ github.ref }}
20+
cancel-in-progress: true
21+
1822
env:
1923
DISPLAY: :99
2024
GITHUB_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
@@ -25,24 +29,12 @@ jobs:
2529
strategy:
2630
fail-fast: false
2731
matrix:
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
33+
release: [ stable, nightly ]
2834
include:
29-
- os: ubuntu
30-
release: stable
31-
python: '3.10'
32-
- os: ubuntu
33-
release: nightly
34-
python: '3.14'
35-
- os: windows
36-
release: stable
37-
python: '3.10'
38-
- os: windows
39-
release: nightly
40-
python: '3.14'
41-
- os: macos
42-
release: stable
35+
- release: stable
4336
python: '3.10'
44-
- os: macos
45-
release: nightly
37+
- release: nightly
4638
python: '3.14'
4739
runs-on: ${{ format('{0}-latest', matrix.os) }}
4840
steps:

‎.github/workflows/ruby-examples.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ on:
1515
paths:
1616
- 'examples/ruby/**'
1717

18+
concurrency:
19+
group: ${{ github.workflow }}-${{ github.ref }}
20+
cancel-in-progress: true
21+
1822
env:
1923
DISPLAY: :99
2024
GITHUB_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
@@ -25,7 +29,7 @@ jobs:
2529
strategy:
2630
fail-fast: false
2731
matrix:
28-
os: [ ubuntu, windows, macos ]
32+
os: ${{ (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch') && fromJSON('["ubuntu", "windows", "macos"]') || fromJSON('["ubuntu", "windows"]') }}
2933
release: [ stable, nightly ]
3034
runs-on: ${{ format('{0}-latest', matrix.os) }}
3135
steps:

‎.gitignore‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,37 @@
22
public/
33
node_modules
44
.DS_Store
5+
6+
/.local/*
7+
!/.local/README.md
8+
9+
# Agent-specific local instruction overrides (keep private, never commit)
10+
AGENTS.local.md
11+
CLAUDE.local.md
12+
GEMINI.local.md
13+
14+
# Security
15+
.env
16+
.env.local
17+
18+
# AI agent local state (most common)
19+
/.claude
20+
/.cursor
21+
/.continue
22+
/.cline
23+
/.windsurf
24+
/.zencoder
25+
26+
# Common per-tool config/rules files people accidentally add
27+
/.cursorignore
28+
/.cursorrules
29+
/.windsurfrules
30+
/.continuerc.json
31+
32+
# Common generated transcripts
33+
*_cline_transcript.json
34+
.copilot-chat-history.json
35+
536
website_and_docs/.hugo_build.lock
637
website_and_docs/resources
738
*.png

‎.local/README.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Local-only workspace
2+
3+
This directory is for repo-local private work that should not be committed:
4+
5+
- personal agent instructions, preferably `.local/AGENTS.md`;
6+
- personal agent skills under `.local/agent/skills/local-*`;
7+
- scratch code;
8+
- private experiments;
9+
- local helper scripts;
10+
- generated outputs;
11+
- temporary notes and prompts.
12+
13+
Everything in this directory is ignored by Git except this README.
14+
15+
Do not make production code, tests, CI, release tooling, or public documentation depend on files
16+
in this directory. If a local experiment becomes useful to the project, move it into a tracked
17+
source, test, docs, example, or scripts directory and review it normally.

0 commit comments

Comments
 (0)