Files
chemenu/types/source.md
T
torben f4353ccfb3
CI / verify (push) Successful in 52s
Release / release (push) Successful in 35s
raw accept: Datums-Shard statt Typverzeichnis, fidelity/authority am Drop-Punkt (Teil 1/3, #67)
Files changed:
- .gitignore
- CHANGES.md
- VERSION
- instructions/bootstrap.md
- instructions/wiki-ingest/SKILL.md
- kb/CONTRACT.md
- raw/CONTRACT.md
- tools/CONTRACT.md
- tools/chemenu/commands/dist_cmd.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/new_page.py
- tools/chemenu/commands/raw_cmd.py
- tools/chemenu/commands/touch.py
- tools/chemenu/lint_core.py
- tools/chemenu/tests/test_dist_cmd.py
- tools/chemenu/tests/test_docs_verify.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_provenance.py
- tools/chemenu/tests/test_raw_cmd.py
- tools/chemenu/tests/test_touch.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/type_resolver.py
- types/source.md
- types/source.schema.yaml
2026-09-08 21:42:27 +02:00

7.5 KiB

type, name, description, schema, subtype_field, base_dir, title_prefix, page_ref_fields, capture_fields, layout
type name description schema subtype_field base_dir title_prefix page_ref_fields capture_fields layout
types/type-spec.md source Strukturierter Typ für Source-Seiten, die eingelesenes Rohmaterial erfassen und zusammenfassen types/source.schema.yaml source_type sources Source -
entities
concepts
fidelity
authority
transcript analysis article document notes tracker unclassified
dir title
transcripts Transkripte
dir title
analyses Analysen
dir title
articles Artikel
dir title
documents Dokumente
dir title
notes Notizen
dir title
trackers Tracker-Exporte
dir title
unclassified Unklassifiziert

Source

source ist der Typ für Seiten, die eingelesenes Rohmaterial zusammenfassen und katalogisieren. Source-Seiten sind die Brücke zwischen der raw/-Schicht (unveränderliche Quelldateien) und der kb/-Schicht (kompiliertes Wissen). Eine Source-Seite steht für eine logische Quelle, die mehrere Raw-Dateien umfassen kann.

Wann zu verwenden

  • Zusammenfassung eines einzelnen externen Artikels, Dokuments oder einer Spezifikation
  • Erfassung mehrerer zusammengehöriger Notizen oder Gesprächsprotokolle als eine Quelle
  • Dokumentation eines eingelesenen PDFs, Handbuchs oder sonstigen Dokuments
  • Festhalten von Informationen zu einem Bild oder Diagramm

Wann NICHT zu verwenden

  • Für kompiliertes Wissen (dann entity oder concept)
  • Für vergleichende Analysen (dann comparison)
  • Für originären Wiki-Inhalt, der nicht aus Rohmaterial abgeleitet ist

Frontmatter

Feld Pflicht Verwendung
type Ja types/source.md
source_type Ja Eines von: transcript, analysis, article, document, notes, tracker, unclassified - kein Default, siehe unten
author Ja Urheber des Quellmaterials
raw_files Ja Raw-Dateipfade, die diese Quelle besitzt - siehe "Eine Raw-Datei, ein Besitzer" unten
fidelity Ja (im Werkzeug, nicht im Schema) Wie treu die Erfassung ist: verbatim, published, secondhand, nontextual - Capture-Feld, siehe unten
authority Ja (im Werkzeug, nicht im Schema) Was das Material über seinen Gegenstand behaupten darf: normative, reporting, opinion - Capture-Feld, siehe unten
source_url Nein Ursprungs-URL bei externen Quellen
source_language Nein ISO-639-1-Code der Sprache des Rohmaterials, z. B. de, en, fr
date Ja Veröffentlichungs- oder Erstellungsdatum (YYYY-MM-DD)
tags Nein Navigations-Tags zur Kategorisierung
entities Nein Titel der in dieser Quelle erwähnten Entities
concepts Nein Titel der in dieser Quelle erwähnten Concepts
summary Ja Einzeiler für kb/index.md

Autorenanweisungen

  • Der Titel beginnt mit "Source - ", gefolgt vom Namen der Quelle
  • source_type hat keinen Default - wikitool new source verweigert ohne einen expliziten Wert. Ist die Kategorie unklar, unclassified setzen statt zu raten; das ist ein sichtbares Katalogfach mit beratendem lint-Befund, kein Sammelbecken. Was analysis von document trennt und welche Area welchen Wert hält: kb/sources/COLLECTION.md
  • raw_files listet jede Raw-Datei, die diese Quelle abdeckt (eine Source-Seite pro logischer Quelle, nicht pro Datei)
  • fidelity und authority sind Capture-Felder (capture_fields: oben): am Drop-Punkt erhoben, danach nicht mehr frei änderbar. wikitool raw accept --fidelity <wert> --authority <wert> verweigert ohne beide; ohne --page druckt es stattdessen die fertige new source --set fidelity=... --set authority=...-Zeile, die new source seinerseits ohne beide Werte verweigert. wikitool touch --set fidelity=<wert> schreibt nur, solange das Feld fehlt - steht bereits ein Wert, verweigert es und verweist auf raw accept --replaces als einzigen Korrekturweg (eine korrigierte Erfassung ist eine neue Edition, keine Bearbeitung). unknown ist backfill-only: nur wikitool touch darf es schreiben, nie raw accept oder new source - dieselbe Konstruktion wie bei source_language für Seiten, die vor dieser Regel entstanden sind. Was die Werte bedeuten und wie sie sich unterscheiden: raw/CONTRACT.md
  • Bei externen Artikeln immer source_url auf die Ursprungs-URL setzen
  • source_language auf die Sprache des Rohmaterials setzen, nicht auf die der Seite
  • Die Seite wird in der KB-Sprache geschrieben, unabhängig von der Sprache der Quelle; wörtliche Passagen werden im Original zitiert (kb/CONVENTIONS.md § "Language")
  • Kernaussagen im Abschnitt Summary zusammenfassen
  • Handlungsbedarf in den Abschnitt Action Items
  • Bewusst Weggelassenes in den Abschnitt Not Extracted - siehe unten
  • Erwähnte Entities und Concepts unter Related Entities/Concepts verlinken

Not Extracted

Die Entscheidung, dass Material nicht übernommen werden soll, ist nicht rekonstruierbar: nichts im Repository kann sie neu herleiten, und sources coverage weiß nur, ob eine Raw-Datei von irgendeiner Source-Seite beansprucht wird - nie, ob jemand über ihren Inhalt entschieden hat. Bleibt das unaufgeschrieben, wird dieselbe Quelle bei jedem späteren Durchgang neu verhandelt.

  • Jede bewusste Auslassung mit Begründung festhalten, nicht nur mit Dateinamen.
  • Pflicht, wenn der Ingest als Tree-Ingest lief (siehe instructions/ingest-large-tree.md). Optional bei einer einzelnen kleinen Datei - aber ein leerer Abschnitt ist immer noch besser als ein fehlender.
  • Gehört auf die Source-Seite, nicht in kb/log.md: es ist eine Aussage über diese Quelle, und das Log ist chronologisch, nicht quellenbezogen.

Template

# Source: {name}

**Autor:** {author}  
**Datum:** {date}  
**Raw-Dateien:** {raw_files|join}  
**Typ:** {source_type|capitalize}

## Zusammenfassung

TODO: 2-3 Absätze zu den Kernaussagen des Quellmaterials.

## Kernaussagen

- TODO: Kernaussage 1
- TODO: Kernaussage 2
- TODO: Kernaussage 3

## Aufgaben

- [ ] TODO: Aufgabe 1
- [ ] TODO: Aufgabe 2

## Nicht übernommen

- TODO: Was bewusst nicht übernommen wurde, und warum (oder "nichts - die Quelle wurde vollständig erfasst")

## Verwandte Entities

{entities|bullets}

## Verwandte Concepts

{concepts|bullets}

# Source: bleibt als Präfix stehen - es spiegelt den title_prefix und damit den Titel, unter dem die Seite verlinkt und zitiert wird. Der Wert hinter **Typ:** bleibt der englische Enum-Wert. Fügt wikitool cite ein Zitat hinzu, entsteht am Seitenende der toolgeführte Fußnoten-Block; wie er heißt, entscheidet die Instanz in kb/CONVENTIONS.md (sections:).


Ergänzende Hinweise:

  • Source-Seiten sind der maßgebliche Katalog dessen, was an Rohmaterial eingelesen wurde
  • Eine Raw-Datei, ein Besitzer. Eine Raw-Datei steht in genau einem raw_files: - diese Seite ist dafür verantwortlich, sie zusammengefasst zu halten. Beliebig viele Seiten dürfen sie per [^cite-id] zitieren; ein Zitat ist Wiederverwendung, raw_files: ist eine Wartungszuständigkeit. Bei zwei Anspruchstellern ist undefiniert, welche Seite bei einer Änderung der Raw-Datei nachgezogen werden muss - dann verrotten beide still
  • Source-Seiten machen Wissen bis zum ursprünglichen Rohmaterial rückverfolgbar
  • raw_files: enthält konkrete existierende Dateipfade, nie Verzeichnisse
  • Eine raw_files:-Liste jenseits von etwa 15 Einträgen zeigt an, dass der Schnitt zu grob war - die Quelle hätte per instructions/ingest-large-tree.md in mehrere Source-Seiten geteilt werden müssen