Update READMEs for NpgsqlDataSource

Author: steveoh

README.md

@@ -17,10 +17,14 @@ For the full documentation, please visit [the Npgsql website](https://www.npgsql
 Here's a basic code snippet to get you started:
 
 ```csharp
+using Npgsql;
+
 var connString = "Host=myserver;Username=mylogin;Password=mypass;Database=mydatabase";
 
-await using var conn = new NpgsqlConnection(connString);
-await conn.OpenAsync();
+var dataSourceBuilder = new NpgsqlDataSourceBuilder(connString);
+var dataSource = dataSourceBuilder.Build();
+
+var conn = await dataSource.OpenConnectionAsync();
 
 // Insert some data
 await using (var cmd = new NpgsqlCommand("INSERT INTO data (some_field) VALUES (@p)", conn))

src/Npgsql.NetTopologySuite/README.md

@@ -2,15 +2,19 @@ Npgsql is the open source .NET data provider for PostgreSQL. It allows you to co
 
 This package is an Npgsql plugin which allows you to interact with spatial data provided by the PostgreSQL [PostGIS extension](https://postgis.net); PostGIS is a mature, standard extension considered to provide top-of-the-line database spatial features. On the .NET side, the plugin adds support for the types from the [NetTopologySuite library](https://github.com/NetTopologySuite/NetTopologySuite), allowing you to read and write them directly to PostgreSQL. 
 
-To use the NetTopologySuite plugin, simply add a dependency on this package and set it up at program startup:
+To use the NetTopologySuite plugin, add a dependency on this package and create a NpgsqlDataSource.
 
 ```csharp
-NpgsqlConnection.GlobalTypeMapper.UseNetTopologySuite();
-```
+using Npgsql;
+using NetTopologySuite.Geometries;
 
-Once this is done, you can simply use NetTopologySuite types when interacting with PostgreSQL:
+var dataSourceBuilder = new NpgsqlDataSourceBuilder(ConnectionString);
+
+dataSourceBuilder.UseNetTopologySuite();
+
+var dataSource = dataSourceBuilder.Build();
+var conn = await dataSource.OpenConnectionAsync();
 
-```csharp
 var point = new Point(new Coordinate(1d, 1d));
 conn.ExecuteNonQuery("CREATE TEMP TABLE data (geom GEOMETRY)");
 using (var cmd = new NpgsqlCommand("INSERT INTO data (geom) VALUES (@p)", conn))

src/Npgsql.NodaTime/README.md

@@ -2,15 +2,18 @@ Npgsql is the open source .NET data provider for PostgreSQL. It allows you to co
 
 This package is an Npgsql plugin which allows you to use the [NodaTime](https://nodatime.org) date/time library when interacting with PostgreSQL; this provides a better and safer API for dealing with date and time data. 
 
-To use the NodaTime plugin, simply add a dependency on this package and set it up at program startup:
+To use the NodaTime plugin, add a dependency on this package and create a NpgsqlDataSource. Once this is done, you can use NodaTime types when interacting with PostgreSQL, just as you would use e.g. `DateTime`:
 
 ```csharp
-NpgsqlConnection.GlobalTypeMapper.UseNodaTime();
-```
+using Npgsql;
 
-Once this is done, you can simply use NodaTime types when interacting with PostgreSQL, just as you would use e.g. `DateTime`:
+var dataSourceBuilder = new NpgsqlDataSourceBuilder(ConnectionString);
+
+dataSourceBuilder.UseNodaTime();
+
+var dataSource = dataSourceBuilder.Build();
+var conn = await dataSource.OpenConnectionAsync();
 
-```csharp
 // Write NodaTime Instant to PostgreSQL "timestamp with time zone" (UTC)
 using (var cmd = new NpgsqlCommand(@"INSERT INTO mytable (my_timestamptz) VALUES (@p)", conn))
 {