Stale docs.cfwheels.org URL in scaffolded config/routes.cfm template comment

[bpamiri]

Describe the issue

The 3.0 CFWheels → Wheels rebrand retired docs.cfwheels.org; the canonical docs site is now guides.wheels.dev. But scaffolded apps from wheels new (and apps that were scaffolded on older versions and still carry the comment) emit:

// config/routes.cfm
<cfscript>
	// Use this file to add routes to your application and point the root route to a controller action.
	// Don't forget to issue a reload request (e.g. reload=true) after making changes.
	// See http://docs.cfwheels.org/docs/routing for more info.

Confirmed present in titan's config/routes.cfm (3.0.0+40 scaffold). The boot succeeds; the link is just broken/stale.

Why this matters

Low impact, but trivially fixable. Surfaces to every new user via their freshly-scaffolded files, and is a small ongoing brand-consistency papercut.

Suggested fix

Audit cli/lucli/templates/app/config/routes.cfm (and any other 4.0 scaffolding templates under cli/lucli/templates/app/) for any references to:

• docs.cfwheels.org
• cfwheels.org
• cfwheels.com
• CFWheels (in user-facing strings — code references like cfwheels-prefixed event names are a different issue)

…and replace with the canonical wheels.dev / guides.wheels.dev URLs.

Also worth a one-time grep across all snippets at app/snippets/ for the same patterns.

Reproducer

Look at the 4.0 starter-app template (or scaffold a fresh app with wheels new) and check for cfwheels strings.

🤖 Filed by Claude Code while assisting with a 4.0 upgrade testbed

[wheels-bot]

Wheels Bot — Triage

Classified as bug.

Suspected layer

cli — see .ai/wheels/cli/ for canonical patterns. The relevant scaffolding lives under cli/lucli/templates/app/.

Fix sketch

The audit requested in the issue is already substantially complete on develop: the active 4.0 lucli templates at cli/lucli/templates/app/config/routes.cfm:5, settings.cfm:6, and environment.cfm:5 all reference guides.wheels.dev/v4-0-0-snapshot/... — there are no docs.cfwheels.org, cfwheels.org, or cfwheels.com hits anywhere under cli/lucli/templates/. The stale URL the reporter saw in titan's config/routes.cfm came from the older 3.0.0+40 ForgeBox wheels-base-template, not the current scaffolder.

One residual hit worth tidying as part of the same sweep: cli/src/templates/ConfigRoutes.txt:5 uses the right domain but an outdated path (https://guides.wheels.dev/docs/routing should be https://guides.wheels.dev/v4-0-0-snapshot/handling-requests-with-controllers/routing to match its lucli counterpart). The legacy CommandBox CLI templates in cli/src/templates/ are also worth a grep pass for CFWheels user-facing strings while the file is open. Historical content (web/content/blog/posts/*, web/sites/guides/src/content/docs/v2-5-0/**) should be left untouched — those are era-accurate archive pages.

Confidence: high

The fix is a mechanical grep-and-replace in one file (cli/src/templates/ConfigRoutes.txt) plus a verification pass confirming the lucli templates need no further changes; no design trade-offs, no cross-engine concerns, no auto-downgrade rules apply.

<!-- wheels-bot:triage:2635 -->
<!-- wheels-bot:triage-class:bug -->
<!-- wheels-bot:triage-confidence:high -->

[wheels-bot]

Wheels Bot — Fix proposed

Draft PR: #2640

Spec: vendor/wheels/tests/specs/cli/ConfigRoutesStaleDocUrlSpec.cfc — failing → passing
Implementation: cli/src/templates/ConfigRoutes.txt, cli/lucli/templates/app/app/snippets/ConfigRoutes.txt

A human review is required before merge. Reviewer A and Reviewer B will weigh in shortly. Doc updates (MDX guides, .ai/wheels/, CLAUDE.md) are handled separately by bot-update-docs.yml.