torben
3c9d669729
Files changed: - CHANGES.md - README.md - VERSION - instructions/kb-profiles.md - instructions/wiki-ingest/SKILL.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/entities/COLLECTION.md - kb/entities/INDEX.md - kb/entities/codebases/BCDModule.md - kb/entities/codebases/Chemenu.md - kb/entities/codebases/andybalholm-edl.md - kb/entities/codebases/goresponsiveness.md - kb/entities/codebases/ha-core.md - kb/entities/codebases/hacs-e3dc.md - kb/entities/codebases/hacs-integration-blueprint.md - kb/entities/codebases/llm-wiki-skills.md - kb/entities/codebases/plugnburn-edl.md - kb/entities/codebases/wiki-skills-vanillaflava.md - kb/entities/codebases/wiki-skills.md - kb/entities/projects/BCDModule.md - kb/entities/projects/Chemenu.md - kb/entities/projects/andybalholm-edl.md - kb/entities/projects/goresponsiveness.md - kb/entities/projects/ha-core.md - kb/entities/projects/hacs-e3dc.md - kb/entities/projects/hacs-integration-blueprint.md - kb/entities/projects/llm-wiki-skills.md - kb/entities/projects/plugnburn-edl.md - kb/entities/projects/wiki-skills-vanillaflava.md - kb/entities/projects/wiki-skills.md - kb/index.md - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_types_cmd.py - types/entity.guidance.md - types/entity.md - types/entity.schema.yaml
1.8 KiB
1.8 KiB
type, name, description
| type | name | description |
|---|---|---|
| types/type-guidance.md | entity | When to write an entity page instead of a neighboring type, and how to write a conforming one - citation, linking and register rules that hold regardless of which entity_type values this instance chose |
Entity Guidance
entity is the type for concrete things: projects, systems, tools, technologies or people.
Entities are the primary building blocks of the knowledge graph.
When to use
- Representing a software project or codebase
- Documenting a running system, service or infrastructure component
- Describing a CLI tool, utility or software library
- Recording information about a language, a framework or a protocol
- Documenting a person, a team or an organization
When NOT to use
- For abstract concepts, patterns or methodologies (use
concept) - For source documents or ingested material (use
source) - For comparative analyses (use
comparison)
Authoring guidance
- The title is the entity's canonical name and follows the subject's established designation, not the KB language (
kb/CONTRACT.md§ "Titles are identifiers",kb/CONVENTIONS.md§§ "Naming" and "Language") - The main description goes near the top
- Link to related entities and concepts wherever relationships exist
- Under
provenance: sourcedormixed, back hard facts inline with a[^cite-id]footnote -tools/wikitool cite add --page "<Title>" --source "Source - X"mints the id and its definition - Wikipedia register: factual, neutral, no marketing language
Relevant Notes:
- Entity pages form the concrete inventory of the knowledge base
- Every entity type (codebase, system, tool and so on) is a variant of this base type
- The relationships between entities carry the knowledge graph's interconnection