Commit d2ff0bb
feat(wiki): add installation / troubleshooting / contributing how-to scopes
The 15-scope catalogue covered explanation (architecture, services,
data-flow), reference (api, commands, tools, mcp, ci-cd), and one
tutorial (onboarding) — but the Diátaxis how-to quadrant was empty.
Users with a concrete goal (install on a fresh box, fix a known
error, land their first PR) had no canonical landing page.
Three new universal scopes:
* ``installation`` — install + configuration walk-through, OS by OS,
every env var named with its default, post-install verification
commands. Anchor filenames: install / installation /
configuration. Suggested kind: how-to.
* ``troubleshooting`` — symptom → diagnosis → fix table for every
known issue and common error. Sourced from runbook incidents
+ ADR consequences + lessons. Anchor filenames: troubleshooting /
known-issues / faq / common-errors. Suggested kind: how-to.
* ``contributing`` — fork/branch policy, test commands, lint rules,
commit convention, PR review expectations. Distinct from onboarding
(which is day-one setup); this is the edit-to-merge path. Anchor
filenames: contributing / CONTRIBUTING / contribute / development.
Suggested kind: how-to.
Total canonical scopes: 15 → 18. cortex coverage drops from 15/15
to 15/18 until the autonomous worker authors the new anchors on the
next cycle; every other project's coverage gap grows by 3 likewise
and the worker drains them in priority order.
121 wiki tests + ruff format + ruff check all green.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 04b7b08 commit d2ff0bb
1 file changed
Lines changed: 68 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
340 | 340 | | |
341 | 341 | | |
342 | 342 | | |
| 343 | + | |
| 344 | + | |
| 345 | + | |
| 346 | + | |
| 347 | + | |
| 348 | + | |
| 349 | + | |
| 350 | + | |
| 351 | + | |
| 352 | + | |
| 353 | + | |
| 354 | + | |
| 355 | + | |
| 356 | + | |
| 357 | + | |
| 358 | + | |
| 359 | + | |
| 360 | + | |
| 361 | + | |
| 362 | + | |
| 363 | + | |
| 364 | + | |
| 365 | + | |
| 366 | + | |
| 367 | + | |
| 368 | + | |
| 369 | + | |
| 370 | + | |
| 371 | + | |
| 372 | + | |
| 373 | + | |
| 374 | + | |
| 375 | + | |
| 376 | + | |
| 377 | + | |
| 378 | + | |
| 379 | + | |
| 380 | + | |
| 381 | + | |
| 382 | + | |
| 383 | + | |
| 384 | + | |
| 385 | + | |
| 386 | + | |
| 387 | + | |
| 388 | + | |
| 389 | + | |
| 390 | + | |
| 391 | + | |
| 392 | + | |
| 393 | + | |
| 394 | + | |
| 395 | + | |
| 396 | + | |
| 397 | + | |
| 398 | + | |
| 399 | + | |
| 400 | + | |
| 401 | + | |
| 402 | + | |
| 403 | + | |
| 404 | + | |
| 405 | + | |
| 406 | + | |
| 407 | + | |
| 408 | + | |
| 409 | + | |
| 410 | + | |
343 | 411 | | |
344 | 412 | | |
345 | 413 | | |
| |||
0 commit comments