Skip to content

Migrate e2e-test-utils-playwright api to autodoc#76852

Open
wwahammy wants to merge 1 commit intoWordPress:trunkfrom
wwahammy:improve-docs-of-e2e-test-utils-playwright
Open

Migrate e2e-test-utils-playwright api to autodoc#76852
wwahammy wants to merge 1 commit intoWordPress:trunkfrom
wwahammy:improve-docs-of-e2e-test-utils-playwright

Conversation

@wwahammy
Copy link
Copy Markdown
Contributor

@wwahammy wwahammy commented Mar 27, 2026

What?

Previously, the README.md for the e2e-test-utils-playwright package appeared to be hand maintained. Because of that they were out of date. This PR migrates the docs to use the autodoc tools used by many other packages.

Why?

The README.md api docs were out of date but because they were manually updated.

How?

I moved the docs we already have for the API from the README.md into their corresponding exports. Then I simple replaced the API section of the README with the JS doc tags and the autogenerated JS docs contents.

Use of AI Tools

None.

@github-actions github-actions bot added the [Package] E2E Tests /packages/e2e-tests label Mar 27, 2026
/**
* The Playwright/Jest's [expect](https://jestjs.io/docs/expect) function.
*/
const expect = baseExpect;
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a pointless assignment in order to document the expect export. I'm open to better solutions!

@wwahammy wwahammy marked this pull request as ready for review March 27, 2026 01:14
@wwahammy wwahammy requested a review from kevin940726 as a code owner March 27, 2026 01:14
@github-actions
Copy link
Copy Markdown

Warning: Type of PR label mismatch

To merge this PR, it requires exactly 1 label indicating the type of PR. Other labels are optional and not being checked here.

  • Required label: Any label starting with [Type].
  • Labels found: [Package] E2E Tests.

Read more about Type labels in Gutenberg. Don't worry if you don't have the required permissions to add labels; the PR reviewer should be able to help with the task.

@github-actions
Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: wwahammy <wwahammy@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Package] E2E Tests /packages/e2e-tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant