Merge pull request #139 from cloudsmith-io/chore-fix-typo-entitlement_control

chore(Update entitlement_control.md)

Author: BartoszBlizniak

docs/resources/entitlement_control.md

@@ -9,6 +9,7 @@ See [help.cloudsmith.io](https://help.cloudsmith.io/docs/entitlements) for full
 
 ## Example Usage 
 
+> **Note:** Ensure `entitlement_tokens` array is returning entitlement tokens (and not an empty array) before using the control resource. By default the example should work, but if there were any changes made to repo settings, the expected behaviour might be different.
 
 Disable repository "Default" entitlement token:
 
@@ -38,7 +39,7 @@ data "cloudsmith_entitlement_list" "my_tokens" {
 resource "cloudsmith_entitlement_control" "my_entitlement_control" {
     namespace  = resource.cloudsmith_repository.my_repository.namespace
     repository = resource.cloudsmith_repository.my_repository.slug_perm
-    identifier = data.cloudsmith_entitlement_list.my_tokens.tokens[0].slug_perm
+    identifier = data.cloudsmith_entitlement_list.my_tokens.entitlement_tokens[0].slug_perm
     enabled    = false
 }
 ```

docs/resources/repository_upstream.md

@@ -81,16 +81,36 @@ resource "cloudsmith_repository_upstream" "enpass" {
 
 ### Docker
 
+> **Note:** Dockerhub requires username and password authentication or the creation of resource will fail.
+
 ```hcl
 resource "cloudsmith_repository_upstream" "docker_hub" {
     name          = "Docker Hub"
+    auth_mode     = "Username and Password"
+    auth_username = "my-username"
+    auth_password = "my-password"
     namespace     = "${data.cloudsmith_organization.my_organization.slug_perm}"
     repository    = "${resource.cloudsmith_repository.my_repository.slug_perm}"
     upstream_type = "docker"
     upstream_url  = "https://index.docker.io"
 }
 ```
 
+> **Note:** Certificate and Key authentication is only supported for Docker, we recommend using a unique filename for the certificate and key files to avoid conflicts.
+
+```hcl
+resource "cloudsmith_repository_upstream" "other_docker_upstream" {
+    name          = "Other Docker Upstream"
+    namespace     = "${data.cloudsmith_organization.my_organization.slug_perm}"
+    repository    = "${resource.cloudsmith_repository.my_repository.slug_perm}"
+    upstream_type = "docker"
+    upstream_url  = "https://other.docker.io"
+    auth_mode     = "Certificate and Key"
+    auth_certificate = "/path/to/certificate_date.crt"
+    auth_certificate_key = "/path/to/certificate_date.key"
+}
+```
+
 ### Helm
 
 ```hcl