full edit connector topics (2)

anita-flegg · anita-flegg · commit f45262fdc0eb · 2025-03-05T14:05:26.000-08:00
diff --git a/api/v4/connectors/cosmosdb.md b/api/v4/connectors/cosmosdb.md
@@ -2,11 +2,12 @@
 
 This connector simplifies accessing [Azure CosmosDB](https://azure.microsoft.com/products/cosmos-db/) databases.
 It supports the following .NET drivers:
-- [Microsoft.Azure.Cosmos](https://www.nuget.org/packages/Microsoft.Azure.Cosmos), which provides a `CosmosClient`.
 
-The remainder of this page assumes you're familiar with the [basic concepts of Steeltoe Connectors](./usage.md).
+- [Microsoft.Azure.Cosmos](https://www.nuget.org/packages/Microsoft.Azure.Cosmos), which provides a `CosmosClient`
 
-## Usage
+The remainder of this topic assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md) for more information.
+
+## Using the CosmosDB connector
 
 To use this connector:
 
@@ -24,7 +25,7 @@ Also add a NuGet reference to one of the .NET drivers listed above, as you would
 
 ### Configure connection string
 
-The CosmosDB connection string can be obtained as described [here](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-dotnet-get-started#retrieve-your-account-connection-string).
+The CosmosDB connection string can be obtained as described in the [Microsoft documentation](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-dotnet-get-started#retrieve-your-account-connection-string).
 
 The following example `appsettings.json` uses the emulator:
 
@@ -43,12 +44,12 @@ The following example `appsettings.json` uses the emulator:
 }
 ```
 
-Notice this configuration file contains the database name, in addition to the connection string. This value is exposed
+Notice that this configuration file contains the database name, in addition to the connection string. This value is exposed
 as `CosmosDbOptions.Database`.
 
 ### Initialize Steeltoe Connector
 
-Update your `Program.cs` as below to initialize the Connector:
+Update your `Program.cs` to initialize the Connector:
 
 ```csharp
 using Steeltoe.Connectors.CosmosDb;
@@ -59,71 +60,75 @@ builder.AddCosmosDb();
 
 ### Use CosmosClient
 
-Start by defining a class that contains container data:
-```csharp
-using Newtonsoft.Json;
+Follow this procedure:
 
-public class SampleObject
-{
-    [JsonProperty(PropertyName = "id")]
-    public string Id { get; set; }
+1. Define a class that contains container data:
 
-    public string? Text { get; set; }
-}
-```
+    ```csharp
+    using Newtonsoft.Json;
 
-To obtain a `CosmosClient` instance in your application, inject the Steeltoe factory in a controller or view:
+    public class SampleObject
+    {
+        [JsonProperty(PropertyName = "id")]
+        public string Id { get; set; }
 
-```csharp
-using Microsoft.AspNetCore.Mvc;
-using Microsoft.Azure.Cosmos;
-using Microsoft.Azure.Cosmos.Linq;
-using Steeltoe.Connectors;
-using Steeltoe.Connectors.CosmosDb;
+        public string? Text { get; set; }
+    }
+    ```
 
-public class HomeController : Controller
-{
-    public async Task<IActionResult> Index(
-        [FromServices] ConnectorFactory<CosmosDbOptions, CosmosClient> connectorFactory)
-    {
-        var connector = connectorFactory.Get();
-        CosmosClient client = connector.GetConnection();
+1. To obtain a `CosmosClient` instance in your application, inject the Steeltoe factory in a controller or view:
 
-        Container container = client.GetContainer(connector.Options.Database, "TestContainer");
-        List<SampleObject> sampleObjects = new();
+    ```csharp
+    using Microsoft.AspNetCore.Mvc;
+    using Microsoft.Azure.Cosmos;
+    using Microsoft.Azure.Cosmos.Linq;
+    using Steeltoe.Connectors;
+    using Steeltoe.Connectors.CosmosDb;
 
-        await foreach (SampleObject sampleObject in GetAllAsync(container))
+    public class HomeController : Controller
+    {
+        public async Task<IActionResult> Index(
+            [FromServices] ConnectorFactory<CosmosDbOptions, CosmosClient> connectorFactory)
         {
-            sampleObjects.Add(sampleObject);
-        }
+            var connector = connectorFactory.Get();
+            CosmosClient client = connector.GetConnection();
 
-        return View(sampleObjects);
-    }
+            Container container = client.GetContainer(connector.Options.Database, "TestContainer");
+            List<SampleObject> sampleObjects = new();
 
-    private async IAsyncEnumerable<SampleObject> GetAllAsync(Container container)
-    {
-        using FeedIterator<SampleObject> iterator =
-            container.GetItemLinqQueryable<SampleObject>().ToFeedIterator();
+            await foreach (SampleObject sampleObject in GetAllAsync(container))
+            {
+                sampleObjects.Add(sampleObject);
+            }
 
-        while (iterator.HasMoreResults)
+            return View(sampleObjects);
+        }
+
+        private async IAsyncEnumerable<SampleObject> GetAllAsync(Container container)
         {
-            FeedResponse<SampleObject> response = await iterator.ReadNextAsync();
+            using FeedIterator<SampleObject> iterator =
+                container.GetItemLinqQueryable<SampleObject>().ToFeedIterator();
 
-            foreach (SampleObject sampleObject in response)
+            while (iterator.HasMoreResults)
             {
-                yield return sampleObject;
+                FeedResponse<SampleObject> response = await iterator.ReadNextAsync();
+
+                foreach (SampleObject sampleObject in response)
+                {
+                    yield return sampleObject;
+                }
             }
         }
     }
-}
-```
+    ```
 
 A complete sample app that uses `CosmosClient` is provided at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/CosmosDb.
 
 ## Cloud Foundry
 
 This Connector supports the following service brokers:
-- [VMware Tanzu Cloud Service Broker for Azure](https://docs.vmware.com/en/Tanzu-Cloud-Service-Broker-for-Azure/1.4/csb-azure/GUID-index.html)
+
+- [VMware Tanzu Cloud Service Broker for Azure](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-microsoft-azure/1-12/csb-azure/index.html)
 
 You can create and bind an instance to your application by using the Cloud Foundry CLI:
 
diff --git a/api/v4/connectors/mongodb.md b/api/v4/connectors/mongodb.md
@@ -2,11 +2,12 @@
 
 This connector simplifies accessing [MongoDB](https://www.mongodb.com/) databases.
 It supports the following .NET drivers:
-- [MongoDB.Driver](https://www.nuget.org/packages/MongoDB.Driver), which provides an `IMongoClient`.
 
-The remainder of this page assumes you're familiar with the [basic concepts of Steeltoe Connectors](./usage.md).
+- [MongoDB.Driver](https://www.nuget.org/packages/MongoDB.Driver), which provides an `IMongoClient`
 
-## Usage
+The remainder of this topic assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md) for more information.
+
+## Using the MongoDB connector
 
 To use this connector:
 
@@ -24,9 +25,9 @@ Also add a NuGet reference to one of the .NET drivers listed above, as you would
 
 ### Configure connection string
 
-The available connection string parameters for MongoDB are documented [here](https://www.mongodb.com/docs/manual/reference/connection-string/).
+The available connection string parameters for MongoDB are described in the [MongoDB documentation](https://www.mongodb.com/docs/manual/reference/connection-string/).
 
-The following example `appsettings.json` uses the docker container from above:
+The following example `appsettings.json` uses the docker container used earlier:
 
 ```json
 {
@@ -43,12 +44,12 @@ The following example `appsettings.json` uses the docker container from above:
 }
 ```
 
-Notice this configuration file contains the database name, in addition to the connection string. This value is exposed
+Notice that this configuration file contains the database name, in addition to the connection string. This value is exposed
 as `MongoDbOptions.Database`.
 
 ### Initialize Steeltoe Connector
 
-Update your `Program.cs` as below to initialize the Connector:
+Update your `Program.cs` to initialize the Connector:
 
 ```csharp
 using Steeltoe.Connectors.MongoDb;
@@ -101,7 +102,8 @@ A complete sample app that uses `IMongoClient` is provided at https://github.com
 ## Cloud Foundry
 
 This Connector supports the following service brokers:
-- [VMware Tanzu Cloud Service Broker for Azure](https://docs.vmware.com/en/Tanzu-Cloud-Service-Broker-for-Azure/1.4/csb-azure/GUID-index.html)
+
+- [VMware Tanzu Cloud Service Broker for Azure](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-microsoft-azure/1-12/csb-azure/index.html)
 
 You can create and bind an instance to your application by using the Cloud Foundry CLI:
 
@@ -119,6 +121,6 @@ cf restage myApp
 ## Kubernetes
 
 This Connector supports the [Service Binding Specification for Kubernetes](https://github.com/servicebinding/spec).
-It can be used through the Bitnami [Services Toolkit](https://docs.vmware.com/en/VMware-Tanzu-Application-Platform/1.5/tap/services-toolkit-install-services-toolkit.html).
+It can be used through the [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
 
-For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/MongoDb#running-on-tanzu-application-platform-tap.
+For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/MongoDb#running-on-tanzu-platform-for-kubernetes.
diff --git a/api/v4/connectors/mysql.md b/api/v4/connectors/mysql.md
@@ -8,7 +8,7 @@ It supports the following .NET drivers:
 - [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql), which provides [Entity Framework Core](https://learn.microsoft.com/ef/core) support
 - [MySql.EntityFrameworkCore](https://www.nuget.org/packages/MySql.EntityFrameworkCore), which provides [Entity Framework Core](https://learn.microsoft.com/ef/core) support
 
-The remainder of this page assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md).
+The remainder of this topic assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md).
 
 ## Using the MySQL connector
 
@@ -152,6 +152,7 @@ A complete sample app that uses Entity Framework Core with MySQL is provided at
 ## Cloud Foundry
 
 This Connector supports the following service brokers:
+
 - [VMware Tanzu for MySQL on Cloud Foundry](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-for-mysql-on-cloud-foundry/3-3/mysql-for-tpcf/about_mysql_vms.html)
 - [VMware Tanzu Cloud Service Broker for Azure](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-gcp/1-8/csb-gcp/index.html)
 - [VMware Tanzu Cloud Service Broker for GCP](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-gcp/1-8/csb-gcp/index.html)
@@ -172,6 +173,6 @@ cf restage myApp
 ## Kubernetes
 
 This Connector supports the [Service Binding Specification for Kubernetes](https://github.com/servicebinding/spec).
-It can be used through the Bitnami [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
+It can be used through the [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
 
 For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/MySql#running-on-tanzu-platform-for-kubernetes.
diff --git a/api/v4/connectors/postgresql.md b/api/v4/connectors/postgresql.md
@@ -7,7 +7,7 @@ It supports the following .NET drivers:
 
 The remainder of this page assumes you're familiar with the [basic concepts of Steeltoe Connectors](./usage.md).
 
-## Usage
+## Using the PostgreSQL connector
 
 To use this connector:
 
@@ -165,6 +165,6 @@ cf restage myApp
 ## Kubernetes
 
 This Connector supports the [Service Binding Specification for Kubernetes](https://github.com/servicebinding/spec).
-It can be used through the Bitnami [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
+It can be used through the [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
 
 For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/PostgreSql#running-on-tanzu-platform-for-kubernetes.
diff --git a/api/v4/connectors/rabbitmq.md b/api/v4/connectors/rabbitmq.md
@@ -5,7 +5,7 @@ It supports the following .NET drivers:
 
 - [RabbitMQ.Client](https://www.nuget.org/packages/RabbitMQ.Client), which provides an `IConnection`.
 
-The remainder of this page assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md) for more information.
+The remainder of this topic assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md) for more information.
 
 ## Using the RabbitMQ connector
 
@@ -107,6 +107,6 @@ cf restage myApp
 ## Kubernetes
 
 This Connector supports the [Service Binding Specification for Kubernetes](https://github.com/servicebinding/spec).
-It can be used through the Bitnami [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
+It can be used through the [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
 
 For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/RabbitMQ#running-on-tanzu-platform-for-kubernetes.
diff --git a/api/v4/connectors/redis.md b/api/v4/connectors/redis.md
@@ -7,12 +7,12 @@ This connector simplifies accessing [Redis](https://redis.io/) databases.
 
 It supports the following .NET drivers:
 
-- [StackExchange.Redis](https://www.nuget.org/packages/StackExchange.Redis), which provides an `IConnectionMultiplexer`.
-- [Microsoft.Extensions.Caching.StackExchangeRedis](https://www.nuget.org/packages/Microsoft.Extensions.Caching.StackExchangeRedis), which provides an `IDistributedCache`.
+- [StackExchange.Redis](https://www.nuget.org/packages/StackExchange.Redis), which provides an `IConnectionMultiplexer`
+- [Microsoft.Extensions.Caching.StackExchangeRedis](https://www.nuget.org/packages/Microsoft.Extensions.Caching.StackExchangeRedis), which provides an `IDistributedCache`
 
-The remainder of this page assumes you're familiar with the [basic concepts of Steeltoe Connectors](./usage.md).
+The remainder of this topic assumes that you are familiar with the basic concepts of Steeltoe Connectors. See [Overview](./usage.md) for more information.
 
-## Usage
+## Using the Redis Connector
 
 To use this connector:
 
@@ -30,9 +30,9 @@ Also add a NuGet reference to one of the .NET drivers listed above, as you would
 
 ### Configure connection string
 
-The available connection string parameters for Redis are documented [here](https://stackexchange.github.io/StackExchange.Redis/Configuration.html).
+The available connection string parameters for Redis are described in [StackExchange.Redis](https://stackexchange.github.io/StackExchange.Redis/Configuration.html).
 
-The following example `appsettings.json` uses the docker container from above:
+The following example `appsettings.json` uses the docker container used earlier:
 
 ```json
 {
@@ -50,7 +50,7 @@ The following example `appsettings.json` uses the docker container from above:
 
 ### Initialize Steeltoe Connector
 
-Update your `Program.cs` as below to initialize the Connector:
+Update your `Program.cs` to initialize the Connector:
 
 ```csharp
 using Steeltoe.Connectors.Redis;
@@ -86,7 +86,7 @@ public class HomeController : Controller
 }
 ```
 
-A complete sample app that uses `IConnectionMultiplexer` is provided at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis.
+For a complete sample app that uses `IConnectionMultiplexer`, see https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis.
 
 ### Use IDistributedCache
 
@@ -114,14 +114,16 @@ public class HomeController : Controller
 }
 ```
 
-A complete sample app that uses `IDistributedCache` is provided at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis.
+For a complete sample app that uses `IDistributedCache`, see https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis.
 
 ## Cloud Foundry
 
 This Connector supports the following service brokers:
-- [Redis for VMware Tanzu Application Service](https://docs.vmware.com/en/Redis-for-VMware-Tanzu-Application-Service/3.1/redis-tanzu-application-service/GUID-index.html)
-- [VMware Tanzu Cloud Service Broker for Azure](https://docs.vmware.com/en/Tanzu-Cloud-Service-Broker-for-Azure/1.4/csb-azure/GUID-index.html)
-- [VMware Tanzu Cloud Service Broker for GCP](https://docs.vmware.com/en/Tanzu-Cloud-Service-Broker-for-GCP/1.2/csb-gcp/GUID-index.html)
+
+- [Redis for VMware Tanzu Application Service](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/redis-for-tanzu-application-service/3-5/redis-for-tas/index.html)
+- [Tanzu for Valkey on Cloud Foundry](https://techdocs.broadcom.com/us/en/vmware-tanzu/data-solutions/tanzu-for-valkey-on-cloud-foundry/4-0/valkey-on-cf/index.html)
+- [VMware Tanzu Cloud Service Broker for Azure](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-gcp/1-8/csb-gcp/index.html)
+- [VMware Tanzu Cloud Service Broker for GCP](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform-services/tanzu-cloud-service-broker-for-gcp/1-8/csb-gcp/index.html)
 
 You can create and bind an instance to your application by using the Cloud Foundry CLI:
 
@@ -139,6 +141,6 @@ cf restage myApp
 ## Kubernetes
 
 This Connector supports the [Service Binding Specification for Kubernetes](https://github.com/servicebinding/spec).
-It can be used through the Bitnami [Services Toolkit](https://docs.vmware.com/en/VMware-Tanzu-Application-Platform/1.5/tap/services-toolkit-install-services-toolkit.html).
+It can be used through the [Services Toolkit](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-application-platform/1-12/tap/services-toolkit-install-services-toolkit.html).
 
-For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis#running-on-tanzu-application-platform-tap.
+For details on how to use this, see the instructions at https://github.com/SteeltoeOSS/Samples/tree/main/Connectors/src/Redis#running-on-tanzu-platform-for-kubernetes.
diff --git a/api/v4/toc.yml b/api/v4/toc.yml
@@ -124,7 +124,7 @@
     - topicHref: connectors/cosmosdb.md
       name: CosmosDB
     - topicHref: connectors/redis.md
-      name: Redis
+      name: Redis/Valkey
 - name: Service Discovery
   topicHref: discovery/
   items:
