-
Notifications
You must be signed in to change notification settings - Fork 2
docs(5/10): consolidate extension and target contracts #747
Copy link
Copy link
Open
Labels
choreMaintenance / refactor / toolingMaintenance / refactor / toolingdocsDocumentation changesDocumentation changeslegend:DOCSDocumentation truth workDocumentation truth worklegend:SOURCESource/schema/docs truth workSource/schema/docs truth worklegend:TRANSMUTETransformation/emitter/generator workTransformation/emitter/generator workpkg:wesley-clipkg:wesley-coretestsTest suite and coverageTest suite and coveragev0.3.0Scheduled work for the v0.3.0 release.Scheduled work for the v0.3.0 release.work:integrityRemoves lies, drift, flake, or trust debtRemoves lies, drift, flake, or trust debt
Description
Metadata
Metadata
Assignees
Labels
choreMaintenance / refactor / toolingMaintenance / refactor / toolingdocsDocumentation changesDocumentation changeslegend:DOCSDocumentation truth workDocumentation truth worklegend:SOURCESource/schema/docs truth workSource/schema/docs truth worklegend:TRANSMUTETransformation/emitter/generator workTransformation/emitter/generator workpkg:wesley-clipkg:wesley-coretestsTest suite and coverageTest suite and coveragev0.3.0Scheduled work for the v0.3.0 release.Scheduled work for the v0.3.0 release.work:integrityRemoves lies, drift, flake, or trust debtRemoves lies, drift, flake, or trust debt
Decision
Make the topic tree self-sufficient for project manifests, directives, emitters, target descriptors, and the post-Node extension boundary.
This is documentation reconstruction slice 5 of 10.
Scope
Rewrite current, tested contract truth into:
docs/topics/project-manifests.mddocs/topics/directives.mddocs/topics/emitters.mddocs/topics/extension-modules.mddocs/topics/compiler-boundary.mddocs/topics/artifacts-and-cache.mddocs/topics/legacy-node.mdExtract from and then delete the superseded reader-facing material under:
docs/reference/for project manifests, directives, external targets, and extension generation;docs/guides/for extending, generators, and module authoring;docs/hosts/;docs/build-artifacts.md;docs/LEGACY_NODE_MIGRATION.md;Preserve the distinction between the shipped
target verifydescriptor validator, embedded Rust generation examples, and future external target execution. Do not resurrect arbitrary module command loading. Historical Node command rewrites belong only in the concise legacy topic.RED
Add focused examples that fail when docs claim nonexistent target execution, an unsupported descriptor field, a dead package path, or a retired Node command as current behavior.
Acceptance
git diff --checkpass.Scheduling
v0.3.0label is temporary until the plain version-milestone cutover.