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

Document CT Third Party Definitions API #25800

Closed
lmiller1990 opened this issue Feb 14, 2023 · 2 comments · Fixed by cypress-io/cypress-documentation#5069
Closed

Document CT Third Party Definitions API #25800

lmiller1990 opened this issue Feb 14, 2023 · 2 comments · Fixed by cypress-io/cypress-documentation#5069
Assignees

Comments

@lmiller1990
Copy link
Contributor

lmiller1990 commented Feb 14, 2023

Description

Note: moved from cypress-io/cypress-documentation#5039

We are working on a public API for third party CT framework definitions. Useful related issues:

This issue is for tracking documentation relating to this. The CT team will take responsibility for writing the docs.

Acceptable Criteria

The documentation should include:

  • Explain how to build a third party integration (guidelines, what is required, why, how it will show up in Cypress)
  • Link to a template to make it easy for developers to follow the guidelines
  • Any known caveats/recommendations
  • A section that showcases known third party definitions (can be empty for now - add a CTA, like "Want to share an integration? Make a PR!)
  • This entire thing can be 1 single page. It probably should go under the Component Testing header in the docs. You can sync with @elylucas if you are not sure where it should go or need more documentation-specific tips. He should also b e added as a reviewer on this PR.

Additional Information

Some examples that might be useful when documenting the feature:

Note: neither of these are production ready (no tests, no docs, probably have bugs) but they serve as examples on a minimal implementation, which I think is fine for documentation purposes. Once we have more fully fledged third party integrations, we can include those as good examples.

@lmiller1990
Copy link
Contributor Author

@lmiller1990
Copy link
Contributor Author

Done, will merge the cypress-io/cypress-documentation#5069 branch once the https://github.com/cypress-io/cypress/pull/25780/files goes out (in 12.7).

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 a pull request may close this issue.

1 participant