Skip to content

docs: add pytest-operator migration guide from Jubilant docs#2381

Merged
dwilding merged 6 commits intocanonical:mainfrom
dwilding:migration-guides
Mar 18, 2026
Merged

docs: add pytest-operator migration guide from Jubilant docs#2381
dwilding merged 6 commits intocanonical:mainfrom
dwilding:migration-guides

Conversation

@dwilding
Copy link
Copy Markdown
Contributor

@dwilding dwilding commented Mar 17, 2026

We're working on making the scope of the Jubilant docs narrower, to focus on standalone use of Jubilant. Guidance related to charm integration testing is moving to the Ops docs.

This PR:

Follow-up actions:

  • Define redirects in RTD for the Ops docs that have changed URLs. ✔️
  • Remove the migration guide from the Jubilant docs and link to the Ops docs instead. See jubilant#270.

Copy link
Copy Markdown
Contributor

@james-garner-canonical james-garner-canonical left a comment

Choose a reason for hiding this comment

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

This looks great, thanks @dwilding!

Copy link
Copy Markdown
Collaborator

@tonyandrewmeyer tonyandrewmeyer left a comment

Choose a reason for hiding this comment

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

Makes sense to me, thanks!

I skipped reviewing the migration guides, trusting that they're copied over as in the PR description.

Seeing the Jubilant one makes me think maybe I should open a PR with a "how to get started using AI" section added ... I wonder if we're open to having that in our docs.


## pytest-operator

pytest-operator and python-libjuju are deprecated. You should migrate integration tests to Jubilant.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I wonder if this should be "to Jubilant and pytest-jubilant" given the work that @james-garner-canonical is doing? Or maybe that's kind of implied and too noisy for right here?

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.

Yeah, this PR is partly to get things ready for James to start making pytest-jubilant updates

@dwilding dwilding merged commit 1198db8 into canonical:main Mar 18, 2026
63 checks passed
@dwilding dwilding deleted the migration-guides branch March 18, 2026 00:26
dwilding added a commit to canonical/jubilant that referenced this pull request Mar 18, 2026
This PR is the companion to
[operator#2381](canonical/operator#2381). It
removes the pytest-operator migration guide (which is the only how-to
guide in the Jubilant docs). The new location of the migration guide is
https://documentation.ubuntu.com/ops/latest/howto/migrate/migrate-integration-tests-from-pytest-operator/.

**[Preview build of Jubilant
docs](https://canonical-ubuntu-documentation-library--270.com.readthedocs.build/jubilant/)**,
with no how-to guides.

Follow-up actions:

- Define a redirect in RTD for the removed URL.
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.

3 participants