diff --git a/tools/ibm-openapi-validator/config.yaml b/tools/ibm-openapi-validator/config.yaml
index 57e3c5d845..a8f442572d 100644
--- a/tools/ibm-openapi-validator/config.yaml
+++ b/tools/ibm-openapi-validator/config.yaml
@@ -2,4 +2,6 @@ errorsOnly: true
 summaryOnly: false
 limits:
   warnings: 25
+# This path to the spectral config file assumes that the validator is using the workspace root
+# folder as its current working directory.
 ruleset: tools/ibm-openapi-validator/spectral.yaml