🧹 update documentation

docs/resources/registration_token.md

@@ -52,17 +52,17 @@ output "generated_token" {
 
 ### Required
 
-- `space_id` (String) Example configurable attribute with default value
+- `space_id` (String) Mondoo Space Identifier to create the token in.
 
 ### Optional
 
-- `description` (String) Example configurable attribute with default value
-- `expires_at` (String) Example configurable attribute with default value
-- `expires_in` (String) Example configurable attribute with default value
-- `no_expiration` (Boolean) Example configurable attribute with default value
-- `revoked` (Boolean) Example configurable attribute with default value
+- `description` (String) Description of the token.
+- `expires_at` (String) The date and time when the token will expire.
+- `expires_in` (String) The duration after which the token will expire. Format: 1h, 1d, 1w, 1m, 1y
+- `no_expiration` (Boolean) If set to true, the token will not expire.
+- `revoked` (Boolean) If set to true, the token is revoked.
 
 ### Read-Only
 
-- `mrn` (String) Example identifier
-- `result` (String, Sensitive) The generated random string.
+- `mrn` (String) The Mondoo Resource Name (MRN) of the created token.
+- `result` (String, Sensitive) The generated token.

docs/resources/service_account.md

@@ -3,12 +3,12 @@
 page_title: "mondoo_service_account Resource - terraform-provider-mondoo"
 subcategory: ""
 description: |-
-  Example resource
+  Service account resource
 ---
 
 # mondoo_service_account (Resource)
 
-Example resource
+Service account resource
 
 ## Example Usage
 
@@ -50,12 +50,12 @@ resource "mondoo_service_account" "service_account" {
 
 ### Optional
 
-- `description` (String) Example configurable attribute with default value
-- `name` (String) Example configurable attribute
-- `org_id` (String) Example configurable attribute with default value
-- `roles` (List of String) tbd
-- `space_id` (String) Example configurable attribute with default value
+- `description` (String) Description of the service account.
+- `name` (String) Name of the service account.
+- `org_id` (String) Mondoo Organization Identifier to create the service account in.
+- `roles` (List of String) Roles to assign to the service account.
+- `space_id` (String) Mondoo Space Identifier to create the service account in.
 
 ### Read-Only
 
-- `mrn` (String) Example identifier
+- `mrn` (String) The Mondoo Resource Name (MRN) of the created service account.

docs/resources/space.md

@@ -37,12 +37,12 @@ resource "mondoo_space" "my_space" {
 
 ### Required
 
-- `org_id` (String) Organization where the space is created
+- `org_id` (String) Id of the organization.
 
 ### Optional
 
-- `name` (String) Space Name
+- `name` (String) Name of the space.
 
 ### Read-Only
 
-- `id` (String) Space identifier
+- `id` (String) Id of the space. Must be globally within the organization.