Skip to content

Document WebDriverServer and drop the BiDiServer alias handling - #124

Merged
arrufat merged 2 commits into
mainfrom
python-reference-alias-links
Oct 8, 2026
Merged

arrufat merged 2 commits into
mainfrom
python-reference-alias-links

Conversation

@arrufat

@arrufat arrufat commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

The python-reference workflow failed with links to missing heading ids: webdriverserver: lightpanda-python #16 added WebDriverServer / AsyncWebDriverServer as aliases of BiDiServer / AsyncBiDiServer, pdoc documents an alias as a variable with no section, and the BiDiServer docstring linked to the alias.

Rather than teach the generator about aliases, lightpanda-io/lightpanda-python#17 removes them: WebDriverServer becomes the class and BiDiServer is gone. This PR follows that:

  • the generator is unchanged from main (the alias handling first pushed here is reverted)
  • the Python guide's robots.txt note links WebDriverServer instead of BiDiServer
  • reference/python.mdx is regenerated against the update missing subdomain #17 branch, which also picks up the classic WebDriver docs and other upstream changes since the last run

Merge lightpanda-io/lightpanda-python#17 first: until it lands, the workflow still fails on main.

lightpanda-python added WebDriverServer and AsyncWebDriverServer as
aliases of BiDiServer and AsyncBiDiServer. pdoc documents an alias as a
variable, so it gets no section, yet collect_links mapped every __all__
name to its own heading id, leaving a link to #webdriverserver with no
target and failing the generator. Point an alias at the class it names.
lightpanda-python drops BiDiServer for WebDriverServer with no alias
(lightpanda-io/lightpanda-python#17), so the alias handling in the
reference generator has nothing left to resolve: remove it. Point the
Python guide's robots.txt note at WebDriverServer and regenerate the
reference against that branch.
@arrufat arrufat changed the title Link class aliases to their class in the Python reference Document WebDriverServer and drop the BiDiServer alias handling Oct 8, 2026
@arrufat
arrufat merged commit 2a6e45b into main Oct 8, 2026
2 checks passed
@arrufat
arrufat deleted the python-reference-alias-links branch October 8, 2026 08:04
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.

1 participant