diff --git a/docs/sources/alerting/_index.md b/docs/sources/alerting/_index.md
index 959ea41de6f6..76b8d1f51f3a 100644
--- a/docs/sources/alerting/_index.md
+++ b/docs/sources/alerting/_index.md
@@ -171,6 +171,9 @@ Because the rule files are identical to Prometheus rule files, we can interact w
 An example workflow is included below:
 
 ```sh
+# lint the rules.yaml file ensuring it's valid and reformatting it if necessary
+cortextool rules lint --backend=loki ./output/rules.yaml
+
 # diff rules against the currently managed ruleset in Loki
 cortextool rules diff --rule-dirs=./output --backend=loki