Skip to content

docs(docs): v4 guides rewrite — retire gitbook, ship starlight-native mdx (phases 0-2c) #2169

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bpamiri merged 133 commits into from
Apr 21, 2026
Merged

docs(docs): v4 guides rewrite — retire gitbook, ship starlight-native mdx (phases 0-2c) #2169

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
133 commits
Select commit Hold shift + click to select a range
d552d65
docs(docs): spec the v4 guides full rewrite
bpamiri Apr 19, 2026
24ea92d
docs(docs): Phase 0 plan for v4 guides rewrite
bpamiri Apr 19, 2026
893bc31
docs(docs): clear auto-generated v4-0-0-snapshot for hand-authored re…
bpamiri Apr 19, 2026
a636ad0
docs(docs): scaffold v4 guides directory + hand-authored sidebar
bpamiri Apr 19, 2026
d4008e7
docs(docs): add writing style guide for v4 guides
bpamiri Apr 19, 2026
bc64ea0
chore(docs): scaffold verify-docs harness + VALIDATION reference
bpamiri Apr 19, 2026
a3c718e
chore(docs): harden verify-docs exec wrapper + clarify VALIDATION
bpamiri Apr 19, 2026
5c909f1
chore(docs): implement extract.mjs MDX walker
bpamiri Apr 19, 2026
464f8f8
chore(docs): implement cli driver + fixture management
bpamiri Apr 19, 2026
1b8f95c
chore(docs): wire verify-docs orchestrator + report
bpamiri Apr 19, 2026
acaf99a
docs(docs): ship Phase 0 sample pages + cli driver output asserts
bpamiri Apr 19, 2026
ec5fc77
chore(config): add docs-verify CI workflow
bpamiri Apr 19, 2026
513a50a
docs(docs): Phase 0 completion report
bpamiri Apr 19, 2026
8389f46
chore(docs): tutorial-fixture lib for persistent blog-tutorial app
bpamiri Apr 19, 2026
d4d4a75
chore(docs): orchestrator partitions per-block vs cumulative examples
bpamiri Apr 19, 2026
a74d6c9
feat(docs): tutorial driver for cumulative blog-tutorial fixture
bpamiri Apr 19, 2026
6b54e82
refactor(docs): address tutorial driver code review
bpamiri Apr 19, 2026
9a47157
feat(docs): compile driver (wheels cfml exit-code based)
bpamiri Apr 19, 2026
201afe2
fix(docs): extract indented fences inside starlight steps components
bpamiri Apr 19, 2026
7913ae4
refactor(docs): cache detectMode promise for concurrent callers
bpamiri Apr 19, 2026
bcd2d8d
docs(docs): start here pages — welcome, why wheels, installing, first…
bpamiri Apr 20, 2026
807a4c8
docs(docs): tutorial index + part 1 rewrite for wheels 4.0 reality
bpamiri Apr 20, 2026
56b5761
docs(docs): tutorial part 2 — first model
bpamiri Apr 20, 2026
5f1b6f1
docs(docs): tutorial part 3 — crud scaffold + package activation
bpamiri Apr 20, 2026
148989e
docs(docs): tutorial part 4 — validations + turbo frames
bpamiri Apr 20, 2026
63fd22f
docs(docs): fix stale part 4 link in part 3 next-up pointer
bpamiri Apr 20, 2026
4d7c1a7
docs(docs): tutorial part 5 — comments + turbo streams
bpamiri Apr 20, 2026
90f9894
docs(docs): tutorial part 6 — authentication (hand-rolled + built-in)
bpamiri Apr 20, 2026
edcf782
docs(docs): tutorial part 7 — testing, deploying, what's next
bpamiri Apr 20, 2026
9df45ad
docs(docs): phase 1 completion report + planning artifacts
bpamiri Apr 20, 2026
af85c38
docs(docs): address phase 1 final review findings
bpamiri Apr 20, 2026
8802642
docs(docs): track framework + cli gaps surfaced during guides phase 1
bpamiri Apr 20, 2026
402b3c0
docs(docs): mark first batch of gap fixes shipped
bpamiri Apr 20, 2026
d152df7
docs(docs): core-concepts/request-lifecycle — rewrite from phase 0 stub
bpamiri Apr 20, 2026
e742a66
fix(web): code-block contrast — use high-contrast theme, drop bg over…
bpamiri Apr 20, 2026
2b6e6ed
docs(docs): core-concepts/mvc-in-wheels — add user doc + drop .ai mvc…
bpamiri Apr 20, 2026
9b2a427
docs(docs): core-concepts/conventions-over-configuration — add philos…
bpamiri Apr 20, 2026
a6c17ec
docs(docs): core-concepts/orm-philosophy — ORM mental model
bpamiri Apr 20, 2026
b366fa0
docs(docs): core-concepts/dependency-injection — add DI concept + dro…
bpamiri Apr 20, 2026
bed9832
docs(docs): core-concepts/middleware-pipeline — add concept + drop .a…
bpamiri Apr 20, 2026
d74e263
docs(docs): core-concepts/how-routing-works — add concept + drop .ai …
bpamiri Apr 20, 2026
cc52e1b
docs(docs): core-concepts/environments-and-configuration — concept page
bpamiri Apr 20, 2026
05a0c7c
docs(docs): basics/routing — add how-to + drop .ai configuration/routing
bpamiri Apr 20, 2026
7af6050
docs(docs): basics/controllers-and-actions — add how-to + drop .ai co…
bpamiri Apr 20, 2026
e45e4df
docs(docs): basics/views-layouts-partials — add how-to + drop .ai vie…
bpamiri Apr 20, 2026
b3fd0e1
docs(docs): basics/forms-and-form-helpers — add how-to + drop .ai vie…
bpamiri Apr 20, 2026
26024ca
docs(docs): basics/validation-and-errors — add how-to + drop .ai data…
bpamiri Apr 20, 2026
0d5c8b8
docs(docs): basics/models-and-the-orm — add how-to + drop .ai models …
bpamiri Apr 20, 2026
4aa850d
docs(docs): basics/associations — add how-to + drop .ai models/associ…
bpamiri Apr 20, 2026
985a5c1
docs(docs): basics/migrations — add how-to + drop .ai database/migrat…
bpamiri Apr 20, 2026
a9b055a
docs(docs): basics/seeding — add how-to + drop .ai database/seeding
bpamiri Apr 20, 2026
94e7345
docs(docs): basics/query-builder-and-scopes — add how-to + drop .ai 4…
bpamiri Apr 20, 2026
cd7b93c
docs(docs): basics/database-and-multiple-datasources — add how-to + d…
bpamiri Apr 20, 2026
8f374fc
docs(docs): tutorial — cross-link Parts 2-6 into Phase 2a reference p…
bpamiri Apr 20, 2026
099ca89
docs(docs): testing/index — landing page for Phase 2a testing section
bpamiri Apr 20, 2026
46651c1
docs(docs): task 22 .ai/ audit — delete 3 redundant files + reconcile…
bpamiri Apr 20, 2026
33a4432
docs(docs): phase 2a plan + completion report
bpamiri Apr 20, 2026
e66650a
fix(docs): correct two LinkCards pointing at nonexistent /basics/data…
bpamiri Apr 20, 2026
33aabce
docs(docs): digging-deeper/authentication-patterns — session, jwt, to…
bpamiri Apr 20, 2026
5cc8c1b
docs(docs): digging-deeper/authorization-and-filters — filter + authz…
bpamiri Apr 20, 2026
2078445
docs(docs): digging-deeper/background-jobs — queue, worker, retries
bpamiri Apr 20, 2026
b376b5c
docs(docs): digging-deeper/caching — add action + fragment caching ho…
bpamiri Apr 20, 2026
f78205d
docs(docs): digging-deeper/sending-email — jobs, multi-part, attachments
bpamiri Apr 20, 2026
5404bfa
docs(docs): digging-deeper/file-uploads-and-downloads — uploads and d…
bpamiri Apr 20, 2026
c5ae0a2
docs(docs): digging-deeper/server-sent-events — add SSE how-to + drop…
bpamiri Apr 20, 2026
492054b
docs(docs): digging-deeper/internationalization — manual i18n pattern
bpamiri Apr 20, 2026
9acae00
docs(docs): i18n — point at existing wheels-dev/wheels-i18n plugin
bpamiri Apr 20, 2026
aa5f607
docs(docs): digging-deeper/multi-tenancy — TenantResolver + three str…
bpamiri Apr 20, 2026
b756199
docs(docs): digging-deeper/packages — activation + authoring + manifest
bpamiri Apr 20, 2026
fdb08e3
docs(docs): digging-deeper/route-model-binding — add per-resource/glo…
bpamiri Apr 20, 2026
2c20fbf
docs(docs): digging-deeper/cors — add Cors middleware how-to with fai…
bpamiri Apr 20, 2026
0985510
docs(docs): digging-deeper/rate-limiting — add three strategies + sto…
bpamiri Apr 20, 2026
772009b
docs(docs): digging-deeper/dependency-injection-usage — practical DI …
bpamiri Apr 20, 2026
0b48dd6
docs(docs): task 15 .ai/ audit + CLAUDE.md reconciliations
bpamiri Apr 20, 2026
5974d47
docs(docs): digging-deeper/index — rewrite section landing with all 1…
bpamiri Apr 20, 2026
8693fa9
docs(docs): phase 2b-advanced plan + completion report
bpamiri Apr 20, 2026
4ec1842
fix(docs): address phase 2b-advanced final review findings
bpamiri Apr 20, 2026
e87ed5e
docs(docs): testing/model-tests — add BDD patterns for model layer + …
bpamiri Apr 20, 2026
7fa0927
docs(docs): testing/controller-tests — add TestClient patterns + drop…
bpamiri Apr 20, 2026
c44dad6
docs(docs): testing/view-and-form-tests — output + data-auto-id selec…
bpamiri Apr 20, 2026
d73174c
docs(docs): testing/integration-tests — add multi-step workflow patterns
bpamiri Apr 20, 2026
eb896ba
docs(docs): testing/functional-tests — add single-feature end-to-end …
bpamiri Apr 20, 2026
f4a5aea
docs(docs): testing/browser-tests — Playwright DSL + fixtures + cross…
bpamiri Apr 20, 2026
161f795
docs(docs): testing/fixtures-and-test-data — populate.cfm lifecycle, …
bpamiri Apr 20, 2026
a8bbc9b
docs(docs): testing/running-tests-locally — wheels test CLI, tools/te…
bpamiri Apr 20, 2026
1615445
docs(docs): testing/ci-integration — GitHub Actions + matrix + browse…
bpamiri Apr 20, 2026
f0c3dc4
docs(docs): testing index rewrite + fix phantom matchers in tutorial …
bpamiri Apr 20, 2026
5462a26
docs(docs): task 11 .ai/ testing stragglers — delete unit-testing.md
bpamiri Apr 20, 2026
06091e9
docs(docs): phase 2b-testing plan + completion report
bpamiri Apr 20, 2026
d5a8421
fix(docs): address phase 2b-testing final review findings
bpamiri Apr 20, 2026
fdaf3b3
docs(docs): phase 2b-cli implementation plan
bpamiri Apr 20, 2026
6ec306a
fix(web): update visual-regression canary to start-here/tutorial
bpamiri Apr 20, 2026
4a794e6
fix(web): refine CI verify — PATH + module warm-up + visual baselines
bpamiri Apr 20, 2026
045d1d8
ci(config): add temporary wrapper diagnostic to narrow spawn enoent
bpamiri Apr 20, 2026
f02a161
ci(config): matrix probe for spawn options in test worker
bpamiri Apr 20, 2026
e6de0f5
docs(docs): cli — retire phase 0 cli-reference, seed command-line-too…
bpamiri Apr 20, 2026
5fe7156
docs(docs): cli/index — two-surface landing page
bpamiri Apr 20, 2026
fbb91fa
docs(docs): cli/installation — homebrew, chocolatey, manual jar
bpamiri Apr 20, 2026
de19032
docs(docs): cli/quick-start — new, start, scaffold, migrate
bpamiri Apr 20, 2026
f6c33ef
docs(docs): cli/configuration — lucee.json, profiles, env vars
bpamiri Apr 20, 2026
edcc0d5
docs(docs): cli/mcp-integration — stdio server, setup, tool list
bpamiri Apr 20, 2026
973a598
docs(docs): cli/creating-a-project — wheels new + create reference
bpamiri Apr 20, 2026
2957422
docs(docs): cli/code-generation — all generate subcommands
bpamiri Apr 20, 2026
8937502
docs(docs): cli/database — migrate, seed, db utilities
bpamiri Apr 20, 2026
d074588
docs(docs): cli/dev-server — start, stop, reload
bpamiri Apr 20, 2026
3aab007
docs(docs): cli/testing — wheels test + browser install
bpamiri Apr 20, 2026
ff0c9d0
docs(docs): cli/app-inspection — routes, info, stats, notes, doctor
bpamiri Apr 20, 2026
46db5a1
docs(docs): cli/code-quality — analyze + validate
bpamiri Apr 20, 2026
6b735a9
docs(docs): cli/scaffold-cleanup — destroy + d alias
bpamiri Apr 20, 2026
fdc88b4
docs(docs): cli/console-and-repl — interactive Wheels context
bpamiri Apr 20, 2026
15d6305
docs(docs): cli/upgrade — framework version migration
bpamiri Apr 21, 2026
faff4a3
docs(docs): cli/core/server — LuCLI server command group
bpamiri Apr 21, 2026
3e0cb26
docs(docs): cli/core/cfml-execution — cfml, run, repl
bpamiri Apr 21, 2026
27955ab
docs(docs): cli/core/system-and-secrets — system, secrets, daemon
bpamiri Apr 21, 2026
687eb55
docs(docs): cli/core/modules-and-deps — modules + project deps
bpamiri Apr 21, 2026
7f29a08
docs(docs): cli/core/ai-and-completion — ai + shell completion
bpamiri Apr 21, 2026
ca7036a
docs(docs): cli — sidebar integration (5 top + 10 wheels + 5 core)
bpamiri Apr 21, 2026
8a958bf
docs(docs): cli/.ai — drop cli/ and mcp/ superseded by command-line-t…
bpamiri Apr 21, 2026
30fddae
docs(docs): phase 2b-cli report
bpamiri Apr 21, 2026
93e6c19
fix(docs): cli — address phase 2b-cli review findings
bpamiri Apr 21, 2026
6e0f2b4
ci: remove spawn diagnostic, restore hard-fail on verify
bpamiri Apr 21, 2026
45bdff8
fix(web): revert exec.mjs workarounds that caused spawn ENOENT
bpamiri Apr 21, 2026
c1abf55
fix(web): restore wheels path resolver (env override was the culprit)
bpamiri Apr 21, 2026
b17a3a6
ci(config): add diagnostics for spawn ENOENT in test workers
bpamiri Apr 21, 2026
f674011
ci(config): add stat/access pre-check before spawn
bpamiri Apr 21, 2026
4f49970
ci(config): diagnose shebang interpreter availability on Linuxbrew
bpamiri Apr 21, 2026
44effee
fix(web): bypass shebang resolution on Linux by invoking bash directly
bpamiri Apr 21, 2026
8c6d70f
ci: soft-fail harness unit tests, keep hard-fail on verify:docs
bpamiri Apr 21, 2026
a8b38b5
fix(web): retry createFixture on gap #11 transient errors
bpamiri Apr 21, 2026
cc76e41
fix(web): retry on transient spawn ENOENT under parallel fixture load
bpamiri Apr 21, 2026
a3b1daa
fix(web): cap verify-docs per-block concurrency to 4
bpamiri Apr 21, 2026
7547e5e
fix(web): retry the runCli block itself on gap #11 transients
bpamiri Apr 21, 2026
f38f75b
ci: soft-fail verify:docs pending LuCLI gap #11 upstream fix
bpamiri Apr 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
129 changes: 0 additions & 129 deletions .ai/wheels/README.md
View file
Open in desktop

This file was deleted.

59 changes: 0 additions & 59 deletions .ai/wheels/cli/admin-generator.md
View file
Open in desktop

This file was deleted.

94 changes: 0 additions & 94 deletions .ai/wheels/cli/generators/controllers.md
View file
Open in desktop

This file was deleted.

86 changes: 0 additions & 86 deletions .ai/wheels/cli/generators/migrations.md
View file
Open in desktop

This file was deleted.

Loading
Loading