Skip to content

Create migration guide from v2 to v3#1630

Merged
henriquemoody merged 1 commit intoRespect:mainfrom
henriquemoody:migrating-from-v2-to-v3
Jan 27, 2026
Merged

Create migration guide from v2 to v3#1630
henriquemoody merged 1 commit intoRespect:mainfrom
henriquemoody:migrating-from-v2-to-v3

Conversation

@henriquemoody
Copy link
Member

As we approach the release of version 3.0, it is important to provide our users with a clear guide to migrating from version 2.x to 3.0. This commit provides guidance by creating a document that will remain in the repository, so users can always access it.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds a comprehensive migration guide to help users transition from Respect\Validation v2.x to v3.0. The document covers breaking changes, new features, and provides detailed examples for updating code.

Changes:

  • Added a new migration guide document (docs/migrating-from-v2-to-v3.md) that covers all breaking changes and new features in version 3.0
  • Includes detailed code examples showing before/after comparisons for migrating from v2.x to v3.0
  • Provides a quick reference section for common migration patterns

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@henriquemoody henriquemoody force-pushed the migrating-from-v2-to-v3 branch 3 times, most recently from 977aecc to eddb8ee Compare January 27, 2026 09:31
**After (3.0):** Single file with `#[Template]` attribute:

```php
use Respect\Validation\Message\Template;
Copy link
Member Author

Choose a reason for hiding this comment

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

Shall we just move this to the Respect\Validation namespace?

@henriquemoody henriquemoody force-pushed the migrating-from-v2-to-v3 branch 5 times, most recently from 25eb2c0 to 25d5694 Compare January 27, 2026 10:19
@henriquemoody henriquemoody requested a review from alganet January 27, 2026 10:21
As we approach the release of version 3.0, it is important to provide our users
with a clear guide to migrating from version 2.x to 3.0. This commit provides
guidance by creating a document that will remain in the repository, so users can
always access it.
@henriquemoody henriquemoody force-pushed the migrating-from-v2-to-v3 branch from 25d5694 to 68ed5d2 Compare January 27, 2026 13:40
Copy link
Member

@alganet alganet left a comment

Choose a reason for hiding this comment

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

Let's merge this as it is and improve anything in further PRs. I think it's currently great, and there's no reason to delay making it into the repo.

@henriquemoody henriquemoody merged commit 68ed5d2 into Respect:main Jan 27, 2026
2 checks passed
@henriquemoody henriquemoody deleted the migrating-from-v2-to-v3 branch January 27, 2026 15:17
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.

2 participants