diff --git a/docs/source/rbac/generate-scope-table.py b/docs/source/rbac/generate-scope-table.py
index 5024eb48..2934f058 100644
--- a/docs/source/rbac/generate-scope-table.py
+++ b/docs/source/rbac/generate-scope-table.py
@@ -84,6 +84,9 @@ class ScopeTableGenerator:
         with open(filename, 'w') as f:
             f.write(content)
         print(f"Generated {filename}.")
+        print(
+            "Run 'make clean' before 'make html' to ensure the built scopes.html contains latest scope table changes."
+        )
 
 
 def main():