update docs

Author: milldr

tests/fixtures/scenarios/docs-generate/.gitignore

@@ -0,0 +1 @@
+**/README.md

website/docs/cli/commands/docs/docs-generate.mdx

@@ -10,40 +10,40 @@ import Screengrab from '@site/src/components/Screengrab'
 :::note Purpose
 
 Use this command to generate one of your documentation artifacts (e.g. a README) as defined by the **named** section under `docs.generate.<KEY>` in `atmos.yaml`.  
+
 Replace `<KEY>` with the name of the section you want to run (for example, `readme`, `release-notes`, etc.).
 
 :::
 
 In `atmos.yaml`, you can define **one or more** documentation‐generation blocks under `docs.generate`.  Each top‐level key becomes a CLI argument:
 
-    ```yaml
-        docs:
-          generate:
-            readme:
-              base-dir: .
-              input:
-                - "./README.yaml"
-              template: "https://…/README.md.gotmpl"
-              output: "./README.md"
-              terraform:
-                source: src/
-                enabled: false
-                format: "markdown"
-                show_providers: false
-                show_inputs: true
-                show_outputs: true
-                sort_by: "name"
-                hide_empty: false
-                indent_level: 2
-
-            release-notes:
-              base-dir: .
-              input:
-                - "./CHANGELOG.yaml"
-              template: "./release-notes.gotmpl"
-              output: "./RELEASE_NOTES.md"
-
-    ```
+```yaml
+docs:
+  generate:
+    readme:
+      base-dir: .
+      input:
+        - "./README.yaml"
+      template: "https://.../README.md.gotmpl"
+      output: "./README.md"
+      terraform:
+        source: src/
+        enabled: false
+        format: "markdown"
+        show_providers: false
+        show_inputs: true
+        show_outputs: true
+        sort_by: "name"
+        hide_empty: false
+        indent_level: 2
+
+    release-notes:
+      base-dir: .
+      input:
+        - "./CHANGELOG.yaml"
+      template: "./release-notes.gotmpl"
+      output: "./RELEASE_NOTES.md"
+```
 
 For each CLI argument the command combines all local or remote YAML files specified at `input` and template file then generates the documentation artifact at the respective `output` folder. In case the template contains `terraform_docs` key, e.g.  
 
@@ -66,8 +66,6 @@ Extra info: {{ $data.extra_info }}
     ```
 the resultant file will also have a corresponding section rendered. By default `terraform.format` is set to `markdown table`, and can also be `markdown`, `tfvars hcl`, and `tfvars json`.  
 
-:::
-
 ## Dynamic Keys
 
 If you add a new key under docs.generate—say readme2 or release-notes —you simply pass that key to the CLI:
@@ -78,37 +76,51 @@ atmos docs generate readme2
 atmos docs generate release-notes
 ```
 
-:::
-
 ## Usage
 
 <Screengrab title="atmos docs generate --help" slug="atmos-docs-generate--help" />
 
 ```shell
 atmos docs generate readme
-
 ``` 
+
 ## Supported Sources for README.yaml and template
 
 ### Local Sources
 
 It supports the following local file sources:
+
   - Absolute paths
+
     ```yaml
-    input: - /Users/me/Documents/README.yaml
-    template: /Users/me/Documents/README.md.gotmpl
+    docs:
+      generate:
+        readme:
+          input:
+            - "/Users/me/Documents/README.yaml"
+          template: "/Users/me/Documents/README.md.gotmpl"
     ```
 
   - Paths relative to the current working directory
+
     ```yaml
-    input: - ./README.yaml
-    template: ./README.md.gotmpl
+    docs:
+      generate:
+        readme:
+          input:
+            - "./README.yaml"
+          template: "./README.md.gotmpl"
     ```
 
   - Paths relative to the `base_dir` defined in `atmos.yaml` CLI config file (then resolved as relative to cwd)
+
     ```yaml
-    input: - terraform/README.yaml
-    template: terraform/README.md.gotmpl
+    docs:
+      generate:
+        readme:
+          input: 
+            - "terraform/README.yaml"
+          template: "terraform/README.md.gotmpl"
     ```
 
 ### Remote Sources