torben/chemenu

1 Fork 0

Files

T

History

torbenandClaude Opus 5.5 fe1de63e0f

CI / verify (push) Successful in 6m14s

Details

CI / pwsh (push) Successful in 2m2s

Details

Release / release (push) Successful in 34s

Details

feat: INSTALL.md is the English installation tutorial; new tutorial docs/tutorials/first-source-to-first-answer.md with a shipped sample source; README.md links it as its first-ingestion step (#191 )

Files changed:
- CHANGES.md
- INSTALL.md
- README.md
- VERSION
- docs/reference/commands/types-instructions-and-docs.md
- docs/tutorials/README.md
- docs/tutorials/first-source-to-first-answer.md
- docs/tutorials/sample-source.md
- instructions/dev/doc-pull-through.md
- tools/CONTRACT.md
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/install_doc.py
- tools/chemenu/tests/test_install_doc.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2

2026-10-07 06:38:40 +02:00

commands

feat: INSTALL.md is the English installation tutorial; new tutorial docs/tutorials/first-source-to-first-answer.md with a shipped sample source; README.md links it as its first-ingestion step (#191 )

2026-10-07 06:38:40 +02:00

configuration.md

feat: docs/ carries the operator's how-to guides, a configuration reference and the architecture and telemetry explanations carved out of README.md, INSTALL.md, INSTALL-MCP.md and EVALS.md; the last two retired (#190 )

2026-10-07 05:13:56 +02:00

exit-codes.md

feat: docs reference generates a human command reference under docs/reference/ from the command records, one page per group plus exit codes and gates; toc never lands inside another generated region (#188 )

2026-10-06 21:29:01 +02:00

page-types.md

feat: docs reference generates a skill catalogue and a page-type reference under docs/reference/ from the shipped defaults, checked and written in the origin repo only (#189 )

2026-10-06 22:10:09 +02:00

README.md

2026-10-07 05:13:56 +02:00

skills.md

feat: docs reference generates a skill catalogue and a page-type reference under docs/reference/ from the shipped defaults, checked and written in the origin repo only (#189 )

2026-10-06 22:10:09 +02:00

README.md

Reference

Lookup pages: the command surface, exit codes and gates, the skill catalogue, the page types. A reference page describes what is, not how to use it or why it is so - and wherever a source for it exists in the code, it is generated from that source and checked against it rather than written by hand.

Command reference - every wikitool command, one page per group, generated from the same records as tools/wikitool <command> -h.
Exit codes and gates - which commands can stop and wait for a person, and why.
Skill catalogue - the skills the stack ships, what each does and which requests start it, generated from their SKILL.md.
Page types - every page type the stack ships for kb/, its subtypes, where its pages are written and its required fields, generated from the type-specs.
Configuration - the environment variables wikitool reads and the per-checkout files an operator may create. Written by hand: it has no source to be generated from yet.

The last two describe the stack's shipped defaults, which an instance may change or extend; tools/wikitool instructions list and tools/wikitool types describe <type> show what one instance has.