@@ -11,9 +11,13 @@
 
 namespace Npgsql;
 
-#pragma warning disable CS1591
-#pragma warning disable RS0016
-
+/// <summary>
+/// An <see cref="NpgsqlDataSource" /> which manages connections for multiple hosts, is aware of their states (primary, secondary,
+/// offline...) and can perform failover and load balancing across them.
+/// </summary>
+/// <remarks>
+/// See <see href="https://www.npgsql.org/doc/failover-and-load-balancing.html" />.
+/// </remarks>
 public sealed class NpgsqlMultiHostDataSource : NpgsqlDataSource
 {
     internal override bool OwnsConnectors => false;
 
@@ -19,7 +19,12 @@ Npgsql.NpgsqlDataSourceBuilder.UseClientCertificatesCallback(System.Action<Syste
 Npgsql.NpgsqlDataSourceBuilder.UsePhysicalConnectionInitializer(System.Action<Npgsql.NpgsqlConnection!>? connectionInitializer, System.Func<Npgsql.NpgsqlConnection!, System.Threading.Tasks.Task!>? connectionInitializerAsync) -> Npgsql.NpgsqlDataSourceBuilder!
 Npgsql.NpgsqlDataSourceBuilder.UseUserCertificateValidationCallback(System.Net.Security.RemoteCertificateValidationCallback! userCertificateValidationCallback) -> Npgsql.NpgsqlDataSourceBuilder!
 Npgsql.NpgsqlLoggingConfiguration
+Npgsql.NpgsqlMultiHostDataSource
 Npgsql.NpgsqlMultiHostDataSource.ClearDatabaseStates() -> void
+Npgsql.NpgsqlMultiHostDataSource.CreateConnection(Npgsql.TargetSessionAttributes targetSessionAttributes) -> Npgsql.NpgsqlConnection!
+Npgsql.NpgsqlMultiHostDataSource.For(Npgsql.TargetSessionAttributes targetSessionAttributes) -> Npgsql.NpgsqlDataSource!
+Npgsql.NpgsqlMultiHostDataSource.OpenConnection(Npgsql.TargetSessionAttributes targetSessionAttributes) -> Npgsql.NpgsqlConnection!
+Npgsql.NpgsqlMultiHostDataSource.OpenConnectionAsync(Npgsql.TargetSessionAttributes targetSessionAttributes, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<Npgsql.NpgsqlConnection!>
 Npgsql.Schema.NpgsqlDbColumn.IsIdentity.get -> bool?
 Npgsql.Schema.NpgsqlDbColumn.IsIdentity.set -> void
 Npgsql.StatementType.Call = 11 -> Npgsql.StatementType