update docs

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:
 

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