Skip to content

docs: document v2 breaking changes and migration steps - #51

Merged
giammin merged 1 commit into
mainfrom
docs/44-v2-breaking-changes
Oct 22, 2026
Merged

giammin merged 1 commit into
mainfrom
docs/44-v2-breaking-changes

Conversation

@giammin

@giammin giammin commented Oct 22, 2026

Copy link
Copy Markdown
Owner

Adds an "Upgrading from v1 to v2" section to the README, built from the changes between v1.1.4 and main.

  • Breaking changes, each with its scope and migration step:
    • IDbDataProtectionStorage requires Delete.
    • Schema/table name validation at startup (PostgreSQL names lowercase only).
    • The global Dapper underscore mapping is no longer set.
    • The PostgreSQL NpgsqlDataSource is a keyed service.
    • StorageWrapper<TStorage> is internal.
    • LoggingExtensions is internal, and the Value log property is removed.
  • Behavior changes:
    • The SQL Server friendly-name index is created on existing tables (with a query to find duplicates).
    • UTC InsertDate.
    • A missing schema is created.
    • Blank friendly names become NULL.
    • Malformed keys are skipped.
    • KeyInsertException no longer contains the key XML.
    • Key deletion is enabled.
  • Packaging: DataProtection 10.0.13, no direct System.Security.Cryptography.Xml reference, no symbols package.

Closes #44

Add an "Upgrading from v1 to v2" section to the README that lists the
breaking API and configuration changes since 1.1.4 with the migration
step for each, the behavior changes of the providers, and the packaging
changes.

Closes #44
@giammin
giammin merged commit 4e09756 into main Oct 22, 2026
1 check passed
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.

V2 breaking changes documentation

1 participant