docsp-34995 - update api urls (#146)

* update api urls

Author: mongoKart

snooty.toml

@@ -26,11 +26,13 @@ language = "C#"
 mongo-community = "MongoDB Community Edition"
 mongo-enterprise = "MongoDB Enterprise Edition"
 docs-branch = "master"                                                                                          # always set this to the docs branch (i.e. master, 1.7, 1.8, etc.)
-version-number = "2.22"                                                                                         # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
+version-number = "2.23"
+patch-version-number = "{+version-number+}.0"                                                                   # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
 version = "v{+version-number+}"
 example = "https://raw.githubusercontent.com/mongodb/docs-csharp/{+docs-branch+}/source/includes/code-examples"
 stable-api = "Stable API"
 api-root = "https://mongodb.github.io/mongo-csharp-driver/{+version-number+}/html"
+new-api-root = "https://mongodb.github.io/mongo-csharp-driver/{+patch-version-number+}/api"
 bool-data-type = "``boolean``"
 string-data-type = "``string``"
 int-data-type = "``integer``"

source/faq.txt

@@ -118,7 +118,7 @@ Why Does the Driver Throw a Timeout During Server Selection?
 Each driver operation requires that you choose a healthy server
 satisfying the :manual:`server selection criteria
 </core/read-preference-mechanics>`. If you do not select an appropriate
-server within the `server selection timeout <{+api-root+}/P_MongoDB_Driver_MongoServerSettings_ServerSelectionTimeout.htm>`__, the driver throws a
+server within the `server selection timeout <{+new-api-root+}/MongoDB.Driver.Legacy/MongoDB.Driver.MongoServerSettings.html#MongoDB_Driver_MongoServerSettings_ServerSelectionTimeout>`__, the driver throws a
 server selection timeout exception. The exception looks similar to the
 following:
 

source/fundamentals/authentication.txt

@@ -394,8 +394,8 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API Documentation:
 
-- `MongoCredential() <{+api-root+}/T_MongoDB_Driver_MongoCredential.htm>`__
-- `MongoClient() <{+api-root+}/T_MongoDB_Driver_MongoClient.htm>`__
-- `MongoClientSettings <{+api-root+}/T_MongoDB_Driver_MongoClientSettings.htm>`__
-- `CreateCredential() <{+api-root+}/M_MongoDB_Driver_MongoCredential_CreateCredential_1.htm>`__
-- `CreateMongoX509Credential() <{+api-root+}/M_MongoDB_Driver_MongoCredential_CreateMongoX509Credential.htm>`__
+- `MongoCredential() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoCredential.html>`__
+- `MongoClient() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoClient.html>`__
+- `MongoClientSettings <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoClientSettings.html>`__
+- `CreateCredential() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoCredential.html#MongoDB_Driver_MongoCredential_CreateCredential_System_String_System_String_System_Security_SecureString_>`__
+- `CreateMongoX509Credential() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoCredential.html#MongoDB_Driver_MongoCredential_CreateMongoX509Credential_System_String_>`__

source/fundamentals/bson.txt

@@ -220,7 +220,7 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API documentation:
 
-- `BsonDocument <{+api-root+}/T_MongoDB_Bson_BsonDocument.htm>`__
-- `BsonElement <{+api-root+}/T_MongoDB_Bson_BsonElement.htm>`__
-- `BsonBinaryReader <{+api-root+}/T_MongoDB_Bson_IO_BsonBinaryReader.htm>`__
-- `BsonBinaryWriter <{+api-root+}/T_MongoDB_Bson_IO_BsonBinaryWriter.htm>`__
+- `BsonDocument <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonDocument.html>`__
+- `BsonElement <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonElement.html>`__
+- `BsonBinaryReader <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.IO.BsonBinaryReader.html>`__
+- `BsonBinaryWriter <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.IO.BsonBinaryWriter.html>`__

source/fundamentals/builders.txt

@@ -313,7 +313,7 @@ The preceding example creates the following pipeline:
 You can add stages to your pipeline that don't have corresponding type-safe
 methods in the ``PipelineDefinitionBuilder`` interface by providing your query
 as a ``BsonDocument`` to the `AppendStage() method
-<{+api-root+}/M_MongoDB_Driver_PipelineDefinitionBuilder_AppendStage__3.htm>`__.
+<{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.PipelineDefinitionBuilder.html#MongoDB_Driver_PipelineDefinitionBuilder_AppendStage__3_MongoDB_Driver_PipelineDefinition___0___1__MongoDB_Driver_PipelineStageDefinition___1___2__MongoDB_Bson_Serialization_IBsonSerializer___2__>`__.
 
 .. code-block:: csharp
 
@@ -354,9 +354,9 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API Documentation:
 
-- `FilterDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_FilterDefinitionBuilder_1.htm>`__
-- `ProjectionDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_ProjectionDefinitionBuilder_1.htm>`__
-- `SortDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_SortDefinitionBuilder_1.htm>`__
-- `UpdateDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_UpdateDefinitionBuilder_1.htm>`__
-- `IndexKeysDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_IndexKeysDefinitionBuilder_1.htm>`__
-- `PipelineDefinitionBuilder <{+api-root+}/T_MongoDB_Driver_PipelineDefinitionBuilder.htm>`__
+- `FilterDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.FilterDefinitionBuilder-1.html>`__
+- `ProjectionDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.ProjectionDefinitionBuilder-1.html>`__
+- `SortDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.SortDefinitionBuilder-1.html>`__
+- `UpdateDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.UpdateDefinitionBuilder-1.html>`__
+- `IndexKeysDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IndexKeysDefinitionBuilder-1.html>`__
+- `PipelineDefinitionBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.PipelineDefinitionBuilder.html>`__

source/fundamentals/connection/connection-options.txt

@@ -94,14 +94,14 @@ relevant options.
    * - **AutoEncryptionOptions**
      - | Settings for automatic client-side encryption.
        |
-       | **Data Type**: `AutoEncryptionOptions <{+api-root+}/T_MongoDB_Driver_Encryption_AutoEncryptionOptions.htm>`__
+       | **Data Type**: `AutoEncryptionOptions <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Encryption.AutoEncryptionOptions.html>`__
        | **Default**: ``null``
        | **Connection URI Example**: {+not-available+}
 
    * - **ClusterConfigurator**
      - | Low-level configuration options for sockets, TLS, cluster, and others.
        |
-       | **Data Type**: Action<`ClusterBuilder <{+api-root+}/T_MongoDB_Driver_Core_Configuration_ClusterBuilder.htm>`__>
+       | **Data Type**: Action<`ClusterBuilder <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Core.Configuration.ClusterBuilder.html>`__>
        | **Default**: ``null``
        | **Connection URI Example**: {+not-available+}
 
@@ -110,7 +110,7 @@ relevant options.
        | or received from the server. The driver uses the first of these compression types
        | that the server supports.
        |
-       | **Data Type**: `CompressorConfiguration <{+api-root+}/T_MongoDB_Driver_Core_Configuration_CompressorConfiguration.htm>`__
+       | **Data Type**: `CompressorConfiguration <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Core.Configuration.CompressorConfiguration.html>`__
        | **Default**: ``null``
        | **Connection URI Example**: ``compressors=snappy,zstd``
 
@@ -131,7 +131,7 @@ relevant options.
        | :ref:`authentication mechanisms <csharp-authentication-mechanisms>` for available
        | authentication mechanisms.
        |
-       | **Data Type**: `MongoCredential <{+api-root+}/T_MongoDB_Driver_MongoCredential.htm>`__
+       | **Data Type**: `MongoCredential <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoCredential.html>`__
        | **Default**: ``null``
        | **Connection URI Example**:
 
@@ -190,7 +190,7 @@ relevant options.
    * - **LinqProvider**
      - | The LINQ provider to use.
        |
-       | **Data Type**: `LinqProvider <{+api-root+}/T_MongoDB_Driver_Linq_LinqProvider.htm>`__
+       | **Data Type**: `LinqProvider <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Linq.LinqProvider.html>`__
        | **Default**: ``LinqProvider.V3``
        | **Connection URI Example**: {+not-available+}
 
@@ -219,7 +219,7 @@ relevant options.
    * - **LoggingSettings**
      - | The settings used for :ref:`logging. <csharp-logging>`
        |
-       | **Data Type**: `LoggingSettings <{+api-root+}/T_MongoDB_Driver_Core_Configuration_LoggingSettings.htm>`__
+       | **Data Type**: `LoggingSettings <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Core.Configuration.LoggingSettings.html>`__
        | **Default**: ``null``
        | **Connection URI Example**: {+not-available+}
 
@@ -266,7 +266,7 @@ relevant options.
      - | The client's default read concern.
        | See :ref:`read concern <read-concern>` for more information.
        |
-       | **Data Type**: `ReadConcern <{+api-root+}/T_MongoDB_Driver_ReadConcern.htm>`__
+       | **Data Type**: `ReadConcern <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.ReadConcern.html>`__
        | **Default**: ``ReadConcern.Default``
        | **Connection URI Example**: ``readConcernLevel=local``
 
@@ -285,7 +285,7 @@ relevant options.
        | still be eligible for server selection. Specifying ``-1`` means no maximum.
        | See :ref:`read preference <read-preference>` for more information.
        |
-       | **Data Type**: `ReadPreference <{+api-root+}/T_MongoDB_Driver_ReadPreference.htm>`__
+       | **Data Type**: `ReadPreference <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.ReadPreference.html>`__
        | **Default**: ``ReadPreference.Primary``
        | **Connection URI Example**:
 
@@ -336,14 +336,14 @@ relevant options.
        | try to use the DNS seed list format, the {+driver-short+} will throw an
        | exception.
        |
-       | **Data Type**: `ConnectionStringScheme <{+api-root+}/T_MongoDB_Driver_Core_Configuration_ConnectionStringScheme.htm>`__
+       | **Data Type**: `ConnectionStringScheme <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Core.Configuration.ConnectionStringScheme.html>`__
        | **Default**: ``ConnectionStringScheme.MongoDB``
        | **Connection URI Example**: ``mongodb+srv://``
 
    * - **Server**
      - | The host and port number where MongoDB is running.
        |
-       | **Data Type**: `MongoServerAddress <{+api-root+}/T_MongoDB_Driver_MongoServerAddress.htm>`__
+       | **Data Type**: `MongoServerAddress <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoServerAddress.html>`__
        | **Default**: ``localhost:27017``
        | **Connection URI Example**: ``mongodb://sample.host:27017``
 
@@ -352,14 +352,14 @@ relevant options.
        | :manual:`the MongoDB Manual</reference/stable-api>` for more information about
        | Stable API versioning.
        |
-       | **Data Type**: `ServerApi <{+api-root+}/T_MongoDB_Driver_ServerApi.htm>`__
+       | **Data Type**: `ServerApi <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.ServerApi.html>`__
        | **Default**: ``null``
        | **Connection URI Example**: {+not-available+}
 
    * - **Servers**
      - | The cluster members where MongoDB is running.
        |
-       | **Data Type**: IEnumerable<`MongoServerAddress <{+api-root+}/T_MongoDB_Driver_MongoServerAddress.htm>`__>
+       | **Data Type**: IEnumerable<`MongoServerAddress <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoServerAddress.html>`__>
        | **Default**: ``localhost:27017``
        | **Connection URI Example**: ``mongodb://sample.host1:27017,sample.host2:27017``
 
@@ -398,7 +398,7 @@ relevant options.
        | ``AllowInsecureTls`` is set to ``true``, the {+driver-short+} will throw
        | an exception.
        |
-       | **Data Type**: `SslSettings <{+api-root+}/T_MongoDB_Driver_SslSettings.htm>`__
+       | **Data Type**: `SslSettings <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.SslSettings.html>`__
        | **Default**: ``null``
        | **Connection URI Example**: ``tlsDisableCertificateRevocationCheck=false``
 
@@ -424,7 +424,7 @@ relevant options.
        | journaling, for the client.
        | See :ref:`write concern <wc-j>` for more information.
        |
-       | **Data Type**: `WriteConcern <{+api-root+}/T_MongoDB_Driver_WriteConcern.htm>`__
+       | **Data Type**: `WriteConcern <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.WriteConcern.html>`__
        | **Default**: ``WriteConcern.Acknowledged``
        | **Connection URI Example**: ``w=majority&wTimeoutMS=0&journal=true``
 

source/fundamentals/connection/network-compression.txt

@@ -52,7 +52,7 @@ specify the algorithms you want to use in one of the following ways:
       :tabid: mongoclientsettings
 
       To enable compression by using
-      `MongoClientSettings <{+api-root+}/T_MongoDB_Driver_MongoClientSettings.htm>`__,
+      `MongoClientSettings <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoClientSettings.html>`__,
       set the ``Compressors`` property of your ``MongoClientSettings`` object to a
       ``List`` of one or more ``CompressorConfiguration`` objects. Each
       ``CompressorConfiguration`` object in the ``List`` represents an algorithm you

source/fundamentals/connection/tls.txt

@@ -225,4 +225,4 @@ API Documentation
 To learn more about any of the connection options discussed in this
 guide, see the following API documentation:
 
-- `MongoClientSettings <{+api-root+}/T_MongoDB_Driver_MongoClientSettings.htm>`__
+- `MongoClientSettings <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoClientSettings.html>`__

source/fundamentals/crud/read-operations/count.txt

@@ -240,7 +240,7 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API Documentation:
 
-- `CountDocuments() <{+api-root+}/M_MongoDB_Driver_IMongoCollection_1_CountDocuments.htm>`__
-- `CountOptions <{+api-root+}/T_MongoDB_Driver_CountOptions.htm>`__
-- `EstimatedDocumentCount() <{+api-root+}/M_MongoDB_Driver_MongoCollectionBase_1_EstimatedDocumentCount.htm>`__
-- `EstimatedDocumentCountOptions <{+api-root+}/T_MongoDB_Driver_EstimatedDocumentCountOptions.htm>`__
+- `CountDocuments() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IMongoCollection-1.html#MongoDB_Driver_IMongoCollection_1_CountDocuments_MongoDB_Driver_FilterDefinition__0__MongoDB_Driver_CountOptions_System_Threading_CancellationToken_>`__
+- `CountOptions <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CountOptions.html>`__
+- `EstimatedDocumentCount() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.MongoCollectionBase-1.html>`__
+- `EstimatedDocumentCountOptions <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.EstimatedDocumentCountOptions.html>`__

source/fundamentals/crud/read-operations/retrieve.txt

@@ -211,7 +211,7 @@ You can configure the commonly used options with the following methods:
      - | Sets the maximum execution time on the server for this operation.
 
 To see a full list of available options, see 
-`FindOptions Properties <{+api-root+}/Properties_T_MongoDB_Driver_FindOptions.htm>`__.
+`FindOptions Properties <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.FindOptions.html>`__.
 
 Example
 ~~~~~~~
@@ -288,11 +288,11 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API Documentation:
 
-- `Find() <{+api-root+}/Overload_MongoDB_Driver_IMongoCollectionExtensions_Find.htm>`__
-- `FirstOrDefault() <{+api-root+}/M_MongoDB_Driver_IFindFluentExtensions_FirstOrDefault__2.htm>`__
-- `FirstOrDefaultAsync() <{+api-root+}/M_MongoDB_Driver_IAsyncCursorSourceExtensions_FirstOrDefaultAsync__1.htm>`__
-- `FindOptions <{+api-root+}/T_MongoDB_Driver_FindOptions.htm>`__
-- `ToList() <{+api-root+}/M_MongoDB_Driver_IAsyncCursorSourceExtensions_ToList__1.htm>`__
-- `ToListAsync() <{+api-root+}/M_MongoDB_Driver_IAsyncCursorSourceExtensions_ToListAsync__1.htm>`__
-- `ToCursor() <{+api-root+}/M_MongoDB_Driver_IAsyncCursorSource_1_ToCursor.htm>`__
-- `ToCursorAsync() <{+api-root+}/M_MongoDB_Driver_IAsyncCursorSource_1_ToCursorAsync.htm>`__
+- `Find() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IMongoCollectionExtensions.html#MongoDB_Driver_IMongoCollectionExtensions_Find__1_MongoDB_Driver_IMongoCollection___0__MongoDB_Driver_FilterDefinition___0__MongoDB_Driver_FindOptions_>`__
+- `FirstOrDefault() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IFindFluentExtensions.html#MongoDB_Driver_IFindFluentExtensions_FirstOrDefault__2_MongoDB_Driver_IFindFluent___0___1__System_Threading_CancellationToken_>`__
+- `FirstOrDefaultAsync() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IAsyncCursorSourceExtensions.html#MongoDB_Driver_IAsyncCursorSourceExtensions_FirstOrDefaultAsync__1_MongoDB_Driver_IAsyncCursorSource___0__System_Threading_CancellationToken_>`__
+- `FindOptions <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.FindOptions.html>`__
+- `ToList() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IAsyncCursorSourceExtensions.html#MongoDB_Driver_IAsyncCursorSourceExtensions_ToList__1_MongoDB_Driver_IAsyncCursorSource___0__System_Threading_CancellationToken_>`__
+- `ToListAsync() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IAsyncCursorSourceExtensions.html#MongoDB_Driver_IAsyncCursorSourceExtensions_FirstOrDefaultAsync__1_MongoDB_Driver_IAsyncCursorSource___0__System_Threading_CancellationToken_>`__
+- `ToCursor() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IAsyncCursorSource-1.html#MongoDB_Driver_IAsyncCursorSource_1_ToCursor_System_Threading_CancellationToken_>`__
+- `ToCursorAsync() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IAsyncCursorSource-1.html#MongoDB_Driver_IAsyncCursorSource_1_ToCursorAsync_System_Threading_CancellationToken_>`__