18ae28f918
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
2.7 KiB
2.7 KiB
type, concept_type, tags, created, modified, related, sources, confidence, confidence_base, provenance, summary
| type | concept_type | tags | created | modified | related | sources | confidence | confidence_base | provenance | summary | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| types/concept.md | workflow |
|
2026-08-03 | 2026-08-29 |
|
|
0.80 | 0.80 | sourced | Maximale Seitengröße, ab der eine Aufteilung empfohlen wird (Farza: >120-150 Zeilen, Pascalandy: 200 Zeilen) |
Split Threshold
Typ: workflow
Definition
Split Threshold definiert die maximale Größe, die eine Wiki-Seite erreichen sollte, bevor sie in mehrere fokussierte Seiten aufgeteilt wird. Dies verhindert, dass Seiten schwerfällig und schwierig zu navigieren werden.
Kernpunkte
- Farzas Empfehlung: Seiten mit über 120-150 Zeilen sollten aufgeteilt werden1
- Pascalandys Empfehlung: 200 Zeilen als absolutes Maximum1
- Zweck: Erhält Seitenlesbarkeit und fokussierte Inhaltsorganisation
- Ergänzt Stub Threshold: Während Stub Threshold das Minimum definiert, definiert Split Threshold das Maximum für optimale Seitengröße
- Aktueller Stand: Einige vorhandene Wiki-Seiten können diese Schwellenwerte überschreiten (z. B. lange Entity-Seiten mit umfangreichen Details)1
Beispiele
Unter dem Schwellenwert:
- Eine typische Entity-Seite mit 50-80 Zeilen
- Eine Concept-Seite mit 3-4 gut strukturierten Abschnitten
Über dem Schwellenwert:
- Eine Seite mit 160+ Zeilen, die mehrere unterschiedliche Unterthemen abdeckt
- Die AGENTS.md Entity-Seite selbst könnte sich diesem Schwellenwert nähern
Split-Kandidat:
- Eine Seite über "MQTT Implementation", die auch Geschichte, Protokolldetails und Anwendungsbeispiele abdeckt, könnte in separate Seiten aufgeteilt werden
Wann zu verwenden
- Beim Überprüfen vorhandener Seiten während Audits
- Beim Erstellen neuer Seiten mit umfangreichen Inhalten
- Beim Entscheiden zwischen Erweiterung einer Seite oder Erstellen einer neuen
Wann NICHT zu verwenden
- Für Seiten, die natürlicherweise umfangreiche Inhalte erfordern (z. B. umfassende Tutorials)
- Wenn der zusätzliche Inhalt eng verknüpft ist und eine Aufteilung die Kohärenz verringern würde
Verwandte Concepts
- Content Quality Control - Breiteres Framework
- Stub Threshold - Mindestgröße-Ergänzung
- Index Scaling - Verwandte Skalierung für Index-Seiten
- Anti-Cramming Heuristic - Regel für wann neue Seiten zu erstellen sind