Add migration guide to package READMEs

This commit is contained in:
Daniel J. Summers 2024-12-17 22:24:30 -05:00
parent 3b7176005c
commit 5a2db1819e
2 changed files with 8 additions and 0 deletions

View File

@ -11,6 +11,10 @@ This package provides a lightweight document library backed by [PostgreSQL](http
- Use `Task`-based async for all data access functions - Use `Task`-based async for all data access functions
- Use building blocks for more complex queries - Use building blocks for more complex queries
## Upgrading from v3
There is a breaking API change for `ByField` (C#) / `byField` (F#), along with a compatibility namespace that can mitigate the impact of these changes. See [the migration guide](https://bitbadger.solutions/open-source/relational-documents/upgrade-from-v3-to-v4.html) for full details.
## Getting Started ## Getting Started
Once the package is installed, the library needs a data source. Construct an `NpgsqlDataSource` instance, and provide it to the library: Once the package is installed, the library needs a data source. Construct an `NpgsqlDataSource` instance, and provide it to the library:

View File

@ -11,6 +11,10 @@ This package provides a lightweight document library backed by [SQLite](https://
- Use `Task`-based async for all data access functions - Use `Task`-based async for all data access functions
- Use building blocks for more complex queries - Use building blocks for more complex queries
## Upgrading from v3
There is a breaking API change for `ByField` (C#) / `byField` (F#), along with a compatibility namespace that can mitigate the impact of these changes. See [the migration guide](https://bitbadger.solutions/open-source/relational-documents/upgrade-from-v3-to-v4.html) for full details.
## Getting Started ## Getting Started
Once the package is installed, the library needs a connection string. Once it has been obtained / constructed, provide it to the library: Once the package is installed, the library needs a connection string. Once it has been obtained / constructed, provide it to the library: