From 22875aa3924478fbe7f7d4eae86fe68346a2113b Mon Sep 17 00:00:00 2001
From: Olha Yevtushenko <yorugac@gmail.com>
Date: Fri, 8 Aug 2025 20:35:11 +0300
Subject: [PATCH] k6-operator: add reference to crd-generated doc

---
 .../{common-options.md => configuring-testrun-crd.md}  | 10 ++++++----
 .../{common-options.md => configuring-testrun-crd.md}  | 10 ++++++----
 .../{common-options.md => configuring-testrun-crd.md}  | 10 ++++++----
 3 files changed, 18 insertions(+), 12 deletions(-)
 rename docs/sources/k6/next/set-up/set-up-distributed-k6/usage/{common-options.md => configuring-testrun-crd.md} (77%)
 rename docs/sources/k6/v1.0.x/set-up/set-up-distributed-k6/usage/{common-options.md => configuring-testrun-crd.md} (77%)
 rename docs/sources/k6/v1.1.x/set-up/set-up-distributed-k6/usage/{common-options.md => configuring-testrun-crd.md} (77%)

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