Files
chemenu/types/entity.md
T
torben 177c7e9ce8
CI / verify (push) Successful in 55s
Release / release (push) Successful in 38s
feat: Prosa ist kein Identifier - Link-Taxonomie als Enum, generierte Regionen mit Markern (4.0.0)
Files changed:
- .gitea/workflows/ci.yml
- AGENTS.md
- CHANGES.md
- VERSION
- instructions/CONTRACT.md
- instructions/link-taxonomy.md
- instructions/migrations/4.0.0-link-taxonomy.md
- instructions/setup-instance.md
- kb/CONTRACT.md
- kb/CONVENTIONS.md
- kb/CONVENTIONS.md.template
- kb/comparisons/COLLECTION.md
- kb/concepts/COLLECTION.md
- kb/entities/COLLECTION.md
- kb/sources/COLLECTION.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/blocks.py
- tools/chemenu/cli.py
- tools/chemenu/commands/cite_cmd.py
- tools/chemenu/commands/dist_cmd.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/doctor.py
- tools/chemenu/commands/links_cmd.py
- tools/chemenu/commands/migrate_cmd.py
- tools/chemenu/commands/new_page.py
- tools/chemenu/commands/page_ops.py
- tools/chemenu/commands/run_budget.py
- tools/chemenu/commands/xref.py
- tools/chemenu/conventions.py
- tools/chemenu/corpus_diff.py
- tools/chemenu/frontmatter_io.py
- tools/chemenu/kb_collections.py
- tools/chemenu/kb_state.py
- tools/chemenu/links.py
- tools/chemenu/lint_core.py
- tools/chemenu/provenance.py
- tools/chemenu/sections.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_blocks.py
- tools/chemenu/tests/test_cite_cmd.py
- tools/chemenu/tests/test_conventions.py
- tools/chemenu/tests/test_dist_cmd.py
- tools/chemenu/tests/test_doctor.py
- tools/chemenu/tests/test_migrate_cmd.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_pipeline_l0.py
- tools/chemenu/tests/test_types_cmd.py
- tools/chemenu/tests/test_xref.py
- types/concept.schema.yaml
- types/entity.md
- types/entity.schema.yaml
- types/instruction.schema.yaml
- types/type-spec.md
- work/link-taxonomy-migration/README.md
- work/link-taxonomy-migration/plan.md
2026-09-02 18:39:22 +02:00

3.8 KiB

type, name, description, schema, subtype_field, base_dir, page_ref_fields, layout
type name description schema subtype_field base_dir page_ref_fields layout
types/type-spec.md entity Basistyp für Entity-Seiten - Projekte, Systeme, Werkzeuge, Technologien oder Personen types/entity.schema.yaml entity_type entities
related
sources
project system tool technology person
dir title
projects Projekte
dir title
systems Systeme
dir title
tools Werkzeuge
dir title
technologies Technologien
dir title
people Personen

Entity

entity ist der Typ für konkrete Dinge: Projekte, Systeme, Werkzeuge, Technologien oder Personen. Entities sind die primären Bausteine des Wissensgraphen.

Wann zu verwenden

  • Darstellung eines Softwareprojekts, einer Initiative oder eines Arbeitsvorhabens
  • Dokumentation eines betriebenen Systems, Dienstes oder einer Infrastrukturkomponente
  • Beschreibung eines CLI-Werkzeugs, Hilfsprogramms oder einer Programmbibliothek
  • Festhalten von Informationen zu einer Sprache, einem Framework oder einem Protokoll
  • Dokumentation einer Person, eines Teams oder einer Organisation

Wann NICHT zu verwenden

  • Für abstrakte Konzepte, Muster oder Methodiken (dann concept)
  • Für Quelldokumente oder eingelesenes Material (dann source)
  • Für vergleichende Analysen (dann comparison)

Frontmatter

Feld Pflicht Verwendung
type Ja types/entity.md
entity_type Ja Eines von: project, system, tool, technology, person
tags Nein Navigations-Tags zur Kategorisierung
created Ja Erstellungsdatum (YYYY-MM-DD)
modified Ja Datum der letzten Änderung (YYYY-MM-DD)
related Nein Titel verwandter Seiten (Entities, Concepts, Sources)
sources Nein Titel der Source-Seiten, die die Aussagen dieser Seite stützen
confidence Nein Abgeleitete Konfidenz (0.0-1.0), neu berechnet von wikitool confidence decay
confidence_base Nein Unverfallene Konfidenz zum Zeitpunkt der letzten Bestätigung - bei einer Neubewertung dieses Feld ändern, nicht confidence
provenance Ja sourced, general oder mixed
summary Ja Einzeiler für kb/index.md

Autorenanweisungen

  • Der Titel ist der kanonische Name der Entity und folgt der etablierten Bezeichnung des Gegenstands, nicht der KB-Sprache (kb/CONTRACT.md § "Titles are identifiers", kb/CONVENTIONS.md §§ "Naming" und "Language")
  • Die Hauptbeschreibung steht weit oben
  • Auf verwandte Entities und Concepts verlinken, wo Beziehungen bestehen
  • Bei provenance: sourced oder mixed harte Fakten inline mit einer [^cite-id]-Fußnote belegen - tools/wikitool cite add --page "<Title>" --source "Source - X" erzeugt Id und Definition
  • Wikipedia-Tonfall: sachlich, neutral, keine Werbesprache

Template

# {name}

**Typ:** {entity_type|capitalize}

## Beschreibung

TODO: 1-2 Absätze dazu, was diese Entity ist und wozu sie dient.

## Kerndaten

- **Zweck:** TODO
- **Status:** aktiv, abgelöst, in Planung usw.
- **Version:** TODO (falls zutreffend)
- **Sprache/Technik:** TODO (falls zutreffend)
- **Verantwortlich:** TODO (falls zutreffend)
- **Repository:** TODO (falls zutreffend)

## Details

TODO: Ausführliche Informationen, nach sinnvollen Abschnitten gegliedert

## Historie

- [{today}] - Page created via wikitool

Der Beziehungsabschnitt steht bewusst nicht im Template: er ist eine generierte Region, die wikitool xref beim ersten Kanteneintrag zwischen Markern anlegt und aus related: neu rendert. Ein Autor schreibt dort nie hinein. Der Wert hinter **Typ:** bleibt der englische Enum-Wert - danach filtert search --field.


Ergänzende Hinweise:

  • Entity-Seiten bilden den konkreten Bestand der Wissensbasis
  • Jeder Entity-Typ (project, system, tool usw.) ist eine Ausprägung dieses Basistyps
  • Die Beziehungen zwischen Entities tragen die Vernetzung des Wissensgraphen