Refactor by comments

Author: LijieZhang1998

docs/data-sources/stream_connection.md

@@ -50,11 +50,11 @@ If `type` is of value `Https` the following additional attributes are defined:
 * `mechanism` - Style of authentication. Can be one of `PLAIN`, `SCRAM-256`, `SCRAM-512`, or `OAUTHBEARER`.
 * `username` - Username of the account to connect to the Kafka cluster.
 * `password` - Password of the account to connect to the Kafka cluster.
-* `token_endpoint_url` -  OAUTH issuer token endpoint HTTP(S) URI used to retrieve the token.
-* `client_id` - Public identifier for the kafka client. It must be unique across all clients that the authorization server handles.
-* `client_secret` - Secret known only to the kafka client and the authorization server.
+* `token_endpoint_url` -  OAUTH issuer(IdP provider) token endpoint HTTP(S) URI used to retrieve the token.
+* `client_id` - Public identifier for the Kafka client.
+* `client_secret` - Secret known only to the Kafka client and the authorization server.
 * `scope` - Kafka clients use this to specify the scope of the access request to the broker.
-* `sasl_oauthbearer_extensions` - Additional information to be provided to the kafka broker.
+* `sasl_oauthbearer_extensions` - Additional information to be provided to the Kafka broker.
 * `https_ca_pem` - The CA certificates as a PEM string.
 
 ### Security

docs/data-sources/stream_connections.md

@@ -61,11 +61,11 @@ If `type` is of value `Https` the following additional attributes are defined:
 * `mechanism` - Style of authentication. Can be one of `PLAIN`, `SCRAM-256`, `SCRAM-512`, or `OAUTHBEARER`.
 * `username` - Username of the account to connect to the Kafka cluster.
 * `password` - Password of the account to connect to the Kafka cluster.
-* `token_endpoint_url` -  OAUTH issuer token endpoint HTTP(S) URI used to retrieve the token.
-* `client_id` - Public identifier for the kafka client. It must be unique across all clients that the authorization server handles.
-* `client_secret` - Secret known only to the kafka client and the authorization server.
+* `token_endpoint_url` -  OAUTH issuer(IdP provider) token endpoint HTTP(S) URI used to retrieve the token.
+* `client_id` - Public identifier for the Kafka client. It must be unique across all clients that the authorization server handles.
+* `client_secret` - Secret known only to the Kafka client and the authorization server.
 * `scope` - Kafka clients use this to specify the scope of the access request to the broker.
-* `sasl_oauthbearer_extensions` - Additional information to be provided to the kafka broker.
+* `sasl_oauthbearer_extensions` - Additional information to be provided to the Kafka broker.
 * `https_ca_pem` - The CA certificates as a PEM string.
 
 ### Security

docs/resources/stream_connection.md

@@ -72,7 +72,7 @@ resource "mongodbatlas_stream_connection" "example-kafka-oauthbearer" {
     type            = "Kafka"
     authentication = {
         mechanism = "OAUTHBEARER"
-        token_endpoint_url = "https://your-domain.com/oauth/token"
+        token_endpoint_url = "https://example.com/oauth/token"
         client_id  = "auth0Client"
         client_secret  = var.kafka_client_secret
         scope = "read:messages write:messages"

examples/mongodbatlas_stream_connection/main.tf

@@ -63,7 +63,7 @@ resource "mongodbatlas_stream_connection" "example-kafka-oauthbearer" {
   type            = "Kafka"
   authentication = {
     mechanism                   = "OAUTHBEARER"
-    token_endpoint_url          = "https://your-domain.com/oauth/token"
+    token_endpoint_url          = "https://example.com/oauth/token"
     client_id                   = "auth0Client"
     client_secret               = var.kafka_client_secret
     scope                       = "read:messages write:messages"

examples/mongodbatlas_stream_connection/variables.tf

@@ -22,7 +22,7 @@ variable "kafka_password" {
 }
 
 variable "kafka_client_secret" {
-  description = "Secret known only to the kafka client and the authorization server"
+  description = "Secret known only to the Kafka client and the authorization server"
   type        = string
 }