stack: SKILL.md-Links auf repo-root-relative Pfade umgestellt, docs verify/instructions verify pruefen Linkziele
Files changed: - CHANGES.md - VERSION - instructions/CONTRACT.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-close/SKILL.md - instructions/dev/stack-dev/SKILL.md - instructions/wiki-ingest/SKILL.md - instructions/wiki-lint/SKILL.md - instructions/wiki-manage/SKILL.md - instructions/wiki-query/SKILL.md - instructions/wiki-status/SKILL.md - tools/CONTRACT.md - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/instructions_cmd.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_instructions_cmd.py
This commit is contained in:
@@ -11,11 +11,11 @@ catalog and the audit log in sync.
|
||||
**Trigger:** User requests a new entity/concept/comparison page, or new information needs
|
||||
integrating into an existing one.
|
||||
|
||||
**Before the first `wikitool` call:** [session-setup.md](../session-setup.md).
|
||||
**Before the first `wikitool` call:** `instructions/session-setup.md`.
|
||||
|
||||
**Read before drafting:** [kb/CONTRACT.md](../../kb/CONTRACT.md) - linking and provenance,
|
||||
**Read before drafting:** `kb/CONTRACT.md` - linking and provenance,
|
||||
both of which the tool enforces - and
|
||||
[kb/CONVENTIONS.md](../../kb/CONVENTIONS.md), which is where this instance's language, naming
|
||||
`kb/CONVENTIONS.md`, which is where this instance's language, naming
|
||||
forms, tone and relationship labels are, together with the target collection's own
|
||||
`COLLECTION.md`, which carries its quality goal and what is local to that subtree. Field-level
|
||||
requirements come from `tools/wikitool types describe <type>`.
|
||||
@@ -48,7 +48,7 @@ requirements come from `tools/wikitool types describe <type>`.
|
||||
subjects - so the prose connects to existing pages instead of restating them.
|
||||
|
||||
5. **Draft.** Fill in the generated skeleton's TODO sections, following the tone rules in
|
||||
[kb/CONVENTIONS.md](../../kb/CONVENTIONS.md#tone). If `provenance:` is `sourced` or `mixed`, cite
|
||||
`kb/CONVENTIONS.md` § Tone. If `provenance:` is `sourced` or `mixed`, cite
|
||||
hard facts as you write them with `tools/wikitool cite add --page "<Title>" --source
|
||||
"Source - X"`, which also adds `X` to `sources:` - paste the `[^cite-id]` marker it prints.
|
||||
|
||||
@@ -60,7 +60,7 @@ requirements come from `tools/wikitool types describe <type>`.
|
||||
|
||||
One per relationship. Never hand-edit `related:`.
|
||||
|
||||
7. **Close out.** [publish-cycle.md](../publish-cycle.md), `--op create`.
|
||||
7. **Close out.** `instructions/publish-cycle.md`, `--op create`.
|
||||
|
||||
## Updating a page
|
||||
|
||||
@@ -84,11 +84,11 @@ requirements come from `tools/wikitool types describe <type>`.
|
||||
|
||||
Never hand-edit `modified:`, `summary:` or `provenance:`.
|
||||
|
||||
7. **Close out.** [publish-cycle.md](../publish-cycle.md), `--op update`.
|
||||
7. **Close out.** `instructions/publish-cycle.md`, `--op update`.
|
||||
|
||||
## Renaming, deleting, or unlinking
|
||||
|
||||
That is [page-lifecycle.md](../page-lifecycle.md). A title is the wiki's only identifier for a
|
||||
That is `instructions/page-lifecycle.md`. A title is the wiki's only identifier for a
|
||||
page, so none of it is a file operation.
|
||||
|
||||
## Decision points
|
||||
@@ -98,7 +98,7 @@ page, so none of it is a file operation.
|
||||
- **Entity or concept?** A thing you can point at is an entity; a *why* or *how* is a concept.
|
||||
The collection contracts draw the line.
|
||||
- **`publish` refused?** A single page is normally well under the threshold. If it trips,
|
||||
[gates.md](../gates.md).
|
||||
`instructions/gates.md`.
|
||||
|
||||
## wikitool commands used
|
||||
|
||||
@@ -106,7 +106,7 @@ page, so none of it is a file operation.
|
||||
`sources rebuild-index`, `index rebuild`, `log append`, `publish`
|
||||
|
||||
`xref remove` belongs to the unlinking case, which this skill delegates whole to
|
||||
[page-lifecycle.md](../page-lifecycle.md) rather than describing in a step of its own.
|
||||
`instructions/page-lifecycle.md` rather than describing in a step of its own.
|
||||
|
||||
## Output
|
||||
|
||||
|
||||
Reference in New Issue
Block a user