Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Plugin E2E - Using the api article #885

Merged
merged 14 commits into from
Apr 23, 2024
Merged

Conversation

sunker
Copy link
Contributor

@sunker sunker commented Apr 19, 2024

What this PR does / why we need it:

This article is giving a high level intro on how to use the plugin-e2e api, and the page fixtures in particular.

Also removing the Use prefix from the title in the auth article and in the feature toggle article so they follow the same naming convention as all the other e2e articles.

Which issue(s) this PR fixes:

Fixes #

Special notes for your reviewer:

@sunker sunker added the no-changelog Don't include in changelog and version calculations label Apr 19, 2024
Copy link

github-actions bot commented Apr 19, 2024

Hello! 👋 This repository uses Auto for releasing packages using PR labels.

✨ This PR can be merged. It will not be considered when calculating future versions of the npm packages and will not appear in the changelogs.

If you chose to add a Github workflow when you scaffolded the plugin, the Playwright end-to-end tests will be run in CI targeting the most recent version of Grafana. To take full advantage of plugin-e2e, it's recommended to follow the instructions in the [CI](./ci.md) guide to run Playwright end-to-end tests targeting all versions of Grafana that your plugin supports.
The [`grafanaDependency`](../metadata.md#properties-1) property in the plugin.json file dictates what versions of Grafana the plugin is compatible with. It's recommended to run your Playwright end-to-end tests targeting all the supported versions. The Github workflow that was included when scaffolding the plugin ensures this is the case.

If you chose to not add a Github workflow when you scaffolded the plugin, it's recommended to follow the instructions in the [CI](./ci.md) guide to run Playwright end-to-end tests targeting all versions of Grafana that your plugin supports.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Even though unrelated to the new API article, I'm taking the chance to update this section as it was outdated.

@@ -80,53 +80,6 @@ export type PluginFixture = {
*/
selectors: E2ESelectors;

/**
Copy link
Contributor Author

Choose a reason for hiding this comment

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

changing the order of the fixtures in the public api so that all pages are next to each other.

@josmperez
Copy link
Contributor

Also removing the Use prefix from the title in the auth article and in the feature toggle article so they follow the same naming convention as all the other e2e articles.

This breaks the Grafana documentation recommended structure (how-to articles almost always start with verbs in the title); however, if you prefer the nouns, I do not object because I don't think this harms usability. Doc guidelines aren't iron clad rules.

Copy link
Contributor

@josmperez josmperez left a comment

Choose a reason for hiding this comment

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

Nice work. No blocking issues, but I do have some style suggestions.

docusaurus/docs/e2e-test-a-plugin/get-started.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/get-started.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
sunker and others added 7 commits April 22, 2024 07:23
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
Co-authored-by: Joseph Perez <45749060+josmperez@users.noreply.github.com>
@sunker sunker marked this pull request as ready for review April 22, 2024 05:25
@sunker sunker requested a review from a team as a code owner April 22, 2024 05:25
Copy link
Contributor

@sympatheticmoose sympatheticmoose left a comment

Choose a reason for hiding this comment

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

Some minor comments

@@ -1,6 +1,6 @@
---
id: use-authentication
title: Use authentication
title: Authentication
Copy link
Contributor

Choose a reason for hiding this comment

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

non-blocking but I don't see the removal of Use as making this more in keeping with the other elements. Select, Configure, Test, etc etc

docusaurus/docs/e2e-test-a-plugin/get-started.md Outdated Show resolved Hide resolved
docusaurus/docs/e2e-test-a-plugin/use-the-api.md Outdated Show resolved Hide resolved
@sunker sunker merged commit 74f3db0 into main Apr 23, 2024
20 checks passed
@sunker sunker deleted the plugin-e2e/using-the-api-article branch April 23, 2024 09:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
no-changelog Don't include in changelog and version calculations
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

None yet

3 participants