Skip to content

Latest commit

 

History

History
45 lines (33 loc) · 1.73 KB

File metadata and controls

45 lines (33 loc) · 1.73 KB

Supertag

Supertag gives Org documents typed semantics without transferring ownership of the documents themselves to the database.

Language

Document Fact: A fact encoded by the user's Org text or document topology, such as a title, body, heading relation, Tag Occurrence, or Document Link. Avoid: Node data, file-backed semantic data

Semantic Fact: A typed fact that Org text does not encode, such as a Tag schema, field value, or Semantic Edge. Avoid: Metadata, database copy

Projection: A disposable representation derived from Document Facts, Semantic Facts, or both. It has no independent ownership and can be rebuilt. Avoid: Cache when referring to authoritative data, source of truth

Tag Occurrence: A tag token that physically appears in an Org document. Avoid: Tag entity, Tag definition

Semantic Tag: A stable semantic identity that can own a schema, inheritance, a canonical name, and aliases. A Tag Occurrence may resolve to it without owning it. Avoid: Tag token, tag string

Document Link: A physical Org link owned by the document in which it appears. Avoid: Semantic relation, backlink

Semantic Edge: A typed relation owned by the semantic store and not represented by inserting reciprocal text into Org documents. Avoid: Org link, reference cache

Backlink: A derived answer to “which Document Links or Semantic Edges point here?” It is not a second physical link. Avoid: Reciprocal link

Reindex: Rebuild Document Projections and derived indexes from their authoritative facts without changing Semantic Facts. Avoid: Full database rebuild, semantic restore

Semantic Restore: Restore non-rebuildable Semantic Facts from a backup or synchronized copy. Avoid: Reindex, rescan