[docs-scanner] YOLO mode mentioned but never explained in Gordon documentation

[docker-agent]

Files:

• content/manuals/ai/gordon/how-to/configure-tools.md
• content/manuals/ai/gordon/how-to/permissions.md

Issue

"YOLO mode" is referenced in two places but never explained:

In configure-tools.md:

Gordon still requests approval before running allow-listed tools, unless YOLO mode (auto-approve mode that bypasses permission checks) is enabled.

In permissions.md:

You can also enable YOLO mode to bypass permission checking altogether.

The term "YOLO mode" appears without:

• An explanation of what "YOLO" means
• Instructions on how to enable it
• Guidance on when to use it
• Warning about security implications

The parenthetical in configure-tools.md provides a brief description but this is insufficient for users who need to understand whether they should enable this feature.

Why this matters

Readers who want to enable YOLO mode cannot find instructions on how to do so. The feature is mentioned as an option in the settings but there's no dedicated explanation of what it does, how it works, or what risks it introduces. Users need this information to make informed decisions about their security posture.

Suggested fix

Add a dedicated section in permissions.md explaining YOLO mode:

What to include:

• What YOLO stands for (You Only Live Once)
• What it does (auto-approves all tool usage without prompting)
• How to enable it (in the settings dialog)
• Security implications (Gordon can execute any command without confirmation)
• When you might use it (trusted environments, demos, automated workflows)
• How to disable it

Alternatively, if YOLO mode is considered an advanced/dangerous feature that shouldn't be prominently documented, remove the references to it or move them to a troubleshooting/advanced section with appropriate warnings.

---

Found by nightly documentation quality scanner