diff --git a/docs/sources/k6/next/set-up/set-up-distributed-k6/usage/common-options.md b/docs/sources/k6/next/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
similarity index 77%
rename from docs/sources/k6/next/set-up/set-up-distributed-k6/usage/common-options.md
rename to docs/sources/k6/next/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
index 43d95d8625..21d70ad0e0 100644
--- a/docs/sources/k6/next/set-up/set-up-distributed-k6/usage/common-options.md
+++ b/docs/sources/k6/next/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
@@ -1,13 +1,15 @@
 ---
 weight: 300
-title: Common options
+title: Configuring TestRun CRD
 ---
 
-# Common options
+# Configuring `TestRun` CRD
 
-<!-- TODO: consider removing this page once full reference is generated -->
+<!-- TODO: consider removing this page once machine-generated reference becomes part of the docs -->
 
-The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. This guide covers some of the most common options.
+The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. But there are many other options that can be set in `TestRun` CRD. Refer to the [crd-generated.md](https://github.com/grafana/k6-operator/blob/main/docs/crd-generated.md) for a complete list of all available fields.
+
+Let's look at some of the most common options in greater detail.
 
 ## Parallelism
 
diff --git a/docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/common-options.md b/docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
similarity index 77%
rename from docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/common-options.md
rename to docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
index 43d95d8625..21d70ad0e0 100644
--- a/docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/common-options.md
+++ b/docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
@@ -1,13 +1,15 @@
 ---
 weight: 300
-title: Common options
+title: Configuring TestRun CRD
 ---
 
-# Common options
+# Configuring `TestRun` CRD
 
-<!-- TODO: consider removing this page once full reference is generated -->
+<!-- TODO: consider removing this page once machine-generated reference becomes part of the docs -->
 
-The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. This guide covers some of the most common options.
+The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. But there are many other options that can be set in `TestRun` CRD. Refer to the [crd-generated.md](https://github.com/grafana/k6-operator/blob/main/docs/crd-generated.md) for a complete list of all available fields.
+
+Let's look at some of the most common options in greater detail.
 
 ## Parallelism
 
diff --git a/docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/common-options.md b/docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
similarity index 77%
rename from docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/common-options.md
rename to docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
index 43d95d8625..21d70ad0e0 100644
--- a/docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/common-options.md
+++ b/docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/configuring-testrun-crd.md
@@ -1,13 +1,15 @@
 ---
 weight: 300
-title: Common options
+title: Configuring TestRun CRD
 ---
 
-# Common options
+# Configuring `TestRun` CRD
 
-<!-- TODO: consider removing this page once full reference is generated -->
+<!-- TODO: consider removing this page once machine-generated reference becomes part of the docs -->
 
-The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. This guide covers some of the most common options.
+The only options that are required as part of the `TestRun` CRD spec are `script` and `parallelism`. But there are many other options that can be set in `TestRun` CRD. Refer to the [crd-generated.md](https://github.com/grafana/k6-operator/blob/main/docs/crd-generated.md) for a complete list of all available fields.
+
+Let's look at some of the most common options in greater detail.
 
 ## Parallelism