fix: update entity naming conventions to use singular form for consistency
This commit is contained in:
+2
-1
@@ -35,7 +35,7 @@ dev-checkout concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 4.8.0-beta.4 - 2026-09-05 - raw accept: Stem-Eindeutigkeit im Typverzeichnis erzwingen, --replaces als einziger Weg daran vorbei (schliesst #64)
|
||||
## 4.8.0-beta.5 - 2026-09-05 - update entity naming conventions to use singular form for consistency
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -45,6 +45,7 @@ dev-checkout concern - readable here, never shipped as something to parse.
|
||||
- kb/CONTRACT.md: Tiefe 1 als Grenze - Katalog liest nur eine Area-Ebene
|
||||
- raw accept: incoming/ als abgeleiteter Rohablage-Eingang (schliesst #58)
|
||||
- raw accept: Stem-Eindeutigkeit im Typverzeichnis erzwingen, --replaces als einziger Weg daran vorbei (schliesst #64)
|
||||
- update entity naming conventions to use singular form for consistency
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
Das Label `status/incoming` gibt es seit heute in Gitea: der Mensch legt einen
|
||||
|
||||
-26
@@ -265,32 +265,6 @@ ausführen kann), findet die Dateiliste im `files`-Block der `.wikitool-release.
|
||||
Ausnahmen (`kb/CONVENTIONS.md`, `kb/*/COLLECTION.md`, `.wikitool-kb.json`) in
|
||||
[tools/CONTRACT.md](tools/CONTRACT.md)s `dist upgrade`-Zeile.
|
||||
|
||||
### Sonderfall: Update von 1.x auf 2.0.0
|
||||
|
||||
Mit `2.0.0` wurde das Ursprungs-Repo von `torben/llm-wiki-test1` auf `torben/chemenu`
|
||||
umbenannt. Eine Instanz, die vor diesem Release exportiert wurde, trägt in
|
||||
`.wikitool-release.json` noch den alten Feed - und `version check` fragt damit einen Pfad ab,
|
||||
den es unter diesem Namen nicht mehr gibt. Der Befehl bricht also nicht kaputt, er erfährt nur
|
||||
nichts mehr. Einmalig überschreiben:
|
||||
|
||||
```bash
|
||||
export WIKITOOL_UPDATE_URL="https://gitea.nehmer.net/api/v1/repos/torben/chemenu/releases/latest"
|
||||
tools/wikitool version check
|
||||
```
|
||||
|
||||
Danach den Tarball aus Weg A holen - er heißt seit `2.0.0` `chemenu-stack-<version>.tar.gz`
|
||||
statt `llm-wiki-stack-<version>.tar.gz` - und den Ablauf oben normal durchlaufen. Das
|
||||
mitkopierte `.wikitool-release.json` trägt den neuen Feed, die Variable wird danach nicht mehr
|
||||
gebraucht.
|
||||
|
||||
Zwei Nachräumarbeiten, weil Schritt 3 `tools/` kopiert und nichts löscht: das alte Paket
|
||||
`tools/wiki_tools/` bleibt neben dem neuen `tools/chemenu/` liegen und kann weg - der
|
||||
`tools/wikitool`-Shim ruft seit `2.0.0` `-m chemenu.cli` auf und rührt es nicht mehr an. Und
|
||||
eigene Skripte, die `from wiki_tools import …` machen, müssen auf `chemenu` gezogen werden.
|
||||
|
||||
Eine Inhaltsmigration verlangt dieses Release nicht: `migrate status` bleibt leer, `kb/`
|
||||
behält Schema und Shape.
|
||||
|
||||
## Konfiguration
|
||||
|
||||
| Variable | Zweck | Fallback |
|
||||
|
||||
@@ -157,7 +157,7 @@ working *on* that layer, the contract is what binds an agent working *with* it.
|
||||
|
||||
Ask questions naturally:
|
||||
- "What projects use MQTT?"
|
||||
- "Show me the architecture of ha-core"
|
||||
- "Show me the architecture of HA Integration"
|
||||
- "Compare gdeploy and plugnburn-edl"
|
||||
- "What decisions were made about E3DC integration?"
|
||||
|
||||
@@ -247,7 +247,7 @@ Ingest incoming/notes/my-notes.md
|
||||
### Naming
|
||||
|
||||
- Use human-readable titles with spaces for files: `Hybrid Search.md`, not kebab-case
|
||||
- Use singular for entities: `ha-core.md` (not `ha-cores.md`)
|
||||
- Use singular for entities: `HA Integration.md` (not `HA Integration.md`)
|
||||
- Use wikilinks matching the file name exactly: `[[Entity Name]]`
|
||||
- **Titles follow the subject's own established name, not the wiki's language.** `Act Runner` and
|
||||
`GitOps Ownership Model` keep theirs. A title is the only identifier a page has - it also lives
|
||||
|
||||
@@ -79,6 +79,6 @@ An answer in chat, with citations. Occasionally a new page.
|
||||
**Example queries:**
|
||||
|
||||
- "What projects use MQTT?"
|
||||
- "Show me the architecture of ha-core"
|
||||
- "Show me the architecture of HA Integration"
|
||||
- "Compare gdeploy and plugnburn-edl"
|
||||
- "What decisions were made about E3DC integration?"
|
||||
|
||||
+1
-1
@@ -60,7 +60,7 @@ There is no `## Siehe auch` region any more. It was the reciprocal half of a bid
|
||||
## Naming
|
||||
|
||||
- Human-readable titles with spaces: `Hybrid Search.md`, `Gitea Actions.md` - not kebab-case.
|
||||
- Singular for entities: `ha-core.md`, not `ha-cores.md`.
|
||||
- Singular for entities: `HA Integration.md`, not `HA Integrations.md`.
|
||||
- Comparison pages read as a comparison: `Go vs Rust.md`.
|
||||
- A decision (`concept_type: decision`) is named like any other concept - no `adr-NNN-` prefix.
|
||||
See [kb/concepts/COLLECTION.md § Decisions](concepts/COLLECTION.md#decisions).
|
||||
|
||||
@@ -80,4 +80,4 @@ the *why* lives, and the entity page should not restate it.
|
||||
- A pattern, protocol, architecture or decision - those are concepts, even when only one entity
|
||||
uses them.
|
||||
- A page about a source document - that is a `source` page in `kb/sources/`.
|
||||
- Singular naming is required: `ha-core.md`, not `ha-cores.md`.
|
||||
- Singular naming is required: `HA Integration.md`, not `HA Integrations.md`.
|
||||
|
||||
Reference in New Issue
Block a user