More editing

Signed-off-by: Ian Maddaus <ian.maddaus@progress.com>

Author: IanMadd

docs-chef-io/content/_index.md

@@ -1,15 +1,18 @@
 +++
-title = "About Chef InSpec Kubernetes resources"
-platform = "k8s"
+title = "About the Chef InSpec Kubernetes resource pack"
 draft = false
-gh_repo = "inspec-k8s"
-linkTitle = "Kubernetes resources"
-summary = "Chef InSpec resources for auditing Kubernetes"
+linkTitle = "Kubernetes resource pack"
+summary = "Chef InSpec resources for auditing Kubernetes."
+
+[cascade]
+  [cascade.params]
+    platform = "k8s"
 
 [menu.k8s]
-title = "About resources"
-identifier = "inspec/resources/k8s/about"
-parent = "inspec/resources/k8s"
+  title = "About Kubernetes resources"
+  identifier = "inspec/resources/k8s/about"
+  parent = "inspec/resources/k8s"
+  weight = 10
 +++
 
 Chef InSpec Kubernetes resources allow you to audit and validate the configuration, security, and compliance of your Kubernetes clusters.
@@ -19,6 +22,34 @@ Chef InSpec Kubernetes resources allow you to audit and validate the configurati
 - Inspec 3.7 or greater
 - InSpec K8s train/backend plugin [train-kubernetes](https://github.com/inspec/train-kubernetes)
 
+## Usage
+
+To create and run a profile against a Kubernetes cluster, follow these steps:
+
+1. Ensure your `KUBECONFIG` environment variable or `~/.kube/config` file has a valid configuration and credentials for the target cluster.
+
+1. Define the platform and this resource pack as a dependency in your profile's `inspec.yml` file:
+
+    ```yml
+    supports:
+      platform: k8s
+    depends:
+      - name: inspec-k8s
+        url: https://github.com/inspec/inspec-k8s/archive/main.tar.gz
+    ```
+
+1. Define controls using the resources listed below.
+
+1. Execute the profile against your cluster:
+
+    ```sh
+    inspec exec profile -t k8s://
+    ```
+
+## Example
+
+For an example profile, see the [inspec-k8s-sample example repository](https://github.com/inspec/inspec-k8s-sample).
+
 ## Kubernetes resources
 
 {{< inspec_resources_filter >}}

docs-chef-io/content/k8s_api_resources.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_api_resources resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_api_resources"

docs-chef-io/content/k8s_config_map.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_config_map resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_config_map"

docs-chef-io/content/k8s_config_maps.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_config_maps resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_config_maps"

docs-chef-io/content/k8s_container.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_container resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_container"

docs-chef-io/content/k8s_containers.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_containers resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_containers"

docs-chef-io/content/k8s_cronjob.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_cronjob resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_cronjob"

docs-chef-io/content/k8s_cronjobs.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_cronjobs resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_cronjobs"

docs-chef-io/content/k8s_daemon_set.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_daemon_set resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_daemon_set"

docs-chef-io/content/k8s_daemon_sets.md

@@ -1,8 +1,6 @@
 +++
 title = "k8s_daemon_sets resource"
 draft = false
-gh_repo = "inspec"
-platform = "k8s"
 
 [menu.k8s]
 title = "k8s_daemon_sets"