This repository was archived by the owner on Jul 22, 2025. It is now read-only.
Add Migration Guide for the octopusdeploy_project.versioning_strategy
deprecation
#858
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
In v0.37.1 we deprecated the
octopusdeploy_project.versioning_strategy
attribute in favour of a new dedicated resource, but customers have been getting tripped up on the migration process. This seems like a perfect opportunity to retrospectively implement our newly minted Breaking Changes policy, which didn't exist when this deprecation was performed.We had a few customers running into an issue migrating from the old approach to the new, due to a bug in the schema. This prompted us to think about the customer experience for the migration, which would have been improved if we had have written a migration guide - it would have forced us to think a bit more deeply about the customer migration scenarios, and possibly catch this bug earlier.
The bug has been fixed, but I've gone through the process of writing a migration guide after-the-fact, which can serve as a template for our future breaking changes.
This PR:
octopusdeploy_project.versioning_strategy
to include a shortlink to the migration guide