diff --git a/README.md b/README.md index f9da79d..0d67470 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions (ODX) -![Open.Database.Extensions: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-core.svg) +[![Open.Database.Extensions: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-core.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) [![NuGet](https://img.shields.io/nuget/vpre/Open.Database.Extensions.Core.svg?style=flat)](https://www.nuget.org/packages/Open.Database.Extensions.Core/) [![Docs](https://github.com/Open-NET-Libraries/Open.Database.Extensions/actions/workflows/docs.yml/badge.svg)](https://github.com/Open-NET-Libraries/Open.Database.Extensions/actions/workflows/docs.yml) @@ -88,7 +88,7 @@ Targets: `netstandard2.0`, `netstandard2.1` and `net10.0` (`MSSqlClient`: `net47 ## How it fits together -![Four layers: a foundation of best-practice ADO.NET extensions, expressive commands, row mapping, all resting on performance.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/architecture.svg) +[![Four layers: a foundation of best-practice ADO.NET extensions, expressive commands, row mapping, all resting on performance.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/architecture.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/articles/foundation.html) ## The foundation: best practice by default diff --git a/Source/Channel/README.md b/Source/Channel/README.md index 7b4184a..4129063 100644 --- a/Source/Channel/README.md +++ b/Source/Channel/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions.Channel -![Open.Database.Extensions.Channel: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-channel.svg) +[![Open.Database.Extensions.Channel: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-channel.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) Read query results straight into a `System.Threading.Channels` channel instead of a collection. `ToChannel()` returns a `ChannelReader` immediately; rows are produced in the background, and the channel completes when every row has been written (or completes with the exception if reading fails). **Use it when** another task consumes the rows while they are still being read. It includes [Open.Database.Extensions.Core](https://www.nuget.org/packages/Open.Database.Extensions.Core/), and rows are mapped the same way as `Map()`. diff --git a/Source/Core/README.md b/Source/Core/README.md index db1e8a1..255f2f7 100644 --- a/Source/Core/README.md +++ b/Source/Core/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions.Core -![Open.Database.Extensions.Core: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-core.svg) +[![Open.Database.Extensions.Core: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-core.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) Core is the foundation of Open.Database.Extensions: ADO.NET extension methods with best-practice defaults, expressive commands that open, run and dispose their own connection, and `Map()` to turn rows into objects. It has no database dependency of its own. **Use it for any ADO.NET database;** most applications need only this package. diff --git a/Source/Dataflow/README.md b/Source/Dataflow/README.md index 929647c..b75b2b9 100644 --- a/Source/Dataflow/README.md +++ b/Source/Dataflow/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions.Dataflow -![Open.Database.Extensions.Dataflow: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-dataflow.svg) +[![Open.Database.Extensions.Dataflow: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-dataflow.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) Read query results straight into a TPL Dataflow pipeline. `ToTargetBlock()` posts each row to a block, and `AsSourceBlock()` exposes the results as a source block. **Use it when** your processing is already built from dataflow blocks. It includes [Open.Database.Extensions.Core](https://www.nuget.org/packages/Open.Database.Extensions.Core/), and rows are mapped the same way as `Map()`. diff --git a/Source/MSSqlClient/README.md b/Source/MSSqlClient/README.md index dba86ba..9108f87 100644 --- a/Source/MSSqlClient/README.md +++ b/Source/MSSqlClient/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions.MSSqlClient -![Open.Database.Extensions.MSSqlClient: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-mssqlclient.svg) +[![Open.Database.Extensions.MSSqlClient: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-mssqlclient.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) SQL Server for Open.Database.Extensions: `SqlConnectionFactory`, SQL-specific commands, and stored procedures on `Microsoft.Data.SqlClient`. **Use it when** your database is SQL Server. It includes [Open.Database.Extensions.Core](https://www.nuget.org/packages/Open.Database.Extensions.Core/) and the `Microsoft.Data.SqlClient` provider, so there is nothing else to install. diff --git a/Source/SqlClient/README.md b/Source/SqlClient/README.md index d566d1f..03d0f99 100644 --- a/Source/SqlClient/README.md +++ b/Source/SqlClient/README.md @@ -1,6 +1,6 @@ # Open.Database.Extensions.SqlClient -![Open.Database.Extensions.SqlClient: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-sqlclient.svg) +[![Open.Database.Extensions.SqlClient: You write the SQL. ODX writes the other twenty lines.](https://raw.githubusercontent.com/Open-NET-Libraries/Open.Database.Extensions/master/docsite/images/hero-sqlclient.svg)](https://open-net-libraries.github.io/Open.Database.Extensions/) **This package is deprecated in favor of [Open.Database.Extensions.MSSqlClient](https://www.nuget.org/packages/Open.Database.Extensions.MSSqlClient/)**, which uses the actively maintained `Microsoft.Data.SqlClient` and has the same API. Use this package only if your project still needs the older `System.Data.SqlClient`; otherwise install MSSqlClient. It includes [Open.Database.Extensions.Core](https://www.nuget.org/packages/Open.Database.Extensions.Core/).