TEv2 Glossary

Action

something that is actually done (a 'unit of work' that is executed) by a single actor (on behalf of a given party), as a single operation, in a specific context.

Actor

entity that can act (do things/execute action), e.g. people, machines, but not organization.

Assertion

a declaration/statement, made by a specific party, that something is the case.

Author

a person that creates a text that is meant to be read and understood by others - usually, a particular audience.

a file that is located somewhere within the scopedir, and that contains the body of a curated text. The header of that curated text has a field bodyFile that specifies its location within the scopedir.

Body (of a Curated Text)

the part of a curated text that contains arbitrarily structured documentation about the semantic unit that the curated text documents. Bodies live either in curated text files (behind the header), or in separate so-called body files.

Community

a party, consisting of at least two different parties (the members of the community) that seek to collaborate with each other so that each of them can achieve its individual objective more efficiently and/or effectively.

Compliance Objective

an objective, owned by a party, that aims to reach and maintain a state of affairs in which a specific set of entities that this party controls are in accordance with a specific set of requirements (e.g., laws, regulations, standards, etc.).

Concept

a semantic unit that captures the ideas/thoughts behind a classification of entities (what makes entities in that class 'the same').

Conceptualization

a mental representation or abstract idea formed by a party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the party to recognize similarities and differences between entities or events.

Control Objective

an objective, owned by a party, that aims to contribute to the realization of another (set of) objective of that party, by producing results that this party needs to realize these other objective.

Control

the combination of resources (e.g. people, tools, budgets, time) and processes that are tasked to realize a specific control objective of a particular party.

Converter Profile

a data object, of a type that is specific for a text conversion tool, that converters use to create texts by which the tool will replace the text constructs that are located by its interpreter.

Converter

a specification, in the form of a handlebars expression, for constructing a text that a particular text conversion tool uses to create its output.

Corpus

the documentation that describes the knowledge around a set of terms and concepts.

Credential

data, representing a set of assertion (claims, statements), authored and signed by, or on behalf of, a specific party.

Curate

to select, organize, and present terms, definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a community working together on a particular set of objectives.

Curated File

a file that is located in the scopedir of a specific scope, and is (therefore) curated by (one of) the curators of that scope.

Curated Text File

a file that contains either a (complete) curated text, or the header of that curated text and a reference to the file that contains its body.

Curated Text

a text that documents a concept or other semantic unit of a particular party, and specifies, e.g., the term(s) by which the party refers thereto, its definition, and any other relevant information.

Curatedir

a directory within a scopedir within which every file contains a curated text for that scope.

Curator (of a Scope)

a person responsible for curating, managing, and maintaining the terminologies, to ensure shared understanding among a community working together on a particular set of objectives.

Current Scope

the scope that is the context within which a curator is acting, or a tool is being called.

Define

to provide a criterion and a term, where the criterion can be used by people to determine whether or not something is an instance/example of a concept (or other semantic unit), and the term is used to refer to that concept, or an arbitrary instance thereof.

Definition

the combination of a term and a descriptive text, where the term refers to a concept or other semantic unit, and the descriptive text enables a set of parties to have the same understanding about that concept. Ideally, the descriptive text is a criterion that such parties can use to determine what is, and what is not, an instance (or example) of that concept.

Dictionary

an alphabetically sorted list of terms with various meanings that they may have in different contexts.

Entity

someone or something that is known to exist.

Expectation

an objective that is owned by a party for having a specific (set of) result(s) produced, where the actual production thereof is (going to be) outsourced to another party.

Form Phrase Macro

a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a form phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc.

Form Phrase (for a Term)

a word or phrase that occurs in oral or written texts and that refers to a particular semantic unit, yet is not (necessarily) the term that is used in the definition of that semantic unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.

Formatted Text

a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.

Glossary

an alphabetically sorted list of terms with the (single) meaning it has in (at least) one context.

Glossarydir

a directory within a scopedir within which the different versions of its (machine readable and human readable) glossaries are created and maintained.

Glossary Term

a human readable text that will be used as the term in a definition as presented in a HRG.

Glossary Text

a human readable text that will be used as the definition for a particular term, as presented in a HRG.

Governance

the act or process of governing or overseeing the realization of (the results associated with) a set of objective by the owner of these objective, in order to ensure they will be fit for the purposes that this owner intends to use them for.

Grouptag

a tag that is used to group terms within a specific scope.

Handlebars Expression

a specific syntax used in the popular templating engine 'Handlebars', which enables one to specify texts (e.g., HTML templates) in which dynamic data (as provided, e.g., by moustache variables) is placed. See handlebars for further details.

Header (of a Curated Text)

the part of a curated text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line. Headers live in curated text files.

Human Readable Dictionary

a dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.

Human Readable Dictionary Tool

a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs).

HRG Entry

A specific kind of (human-readable) rendering of the combination of a term and a means that helps readers to understand the meaning of that term when it is used in a sentence.

HRG List

a list of alphabetically sorted HRG entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc.

Human Readable Glossary

a glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.

Human Readable Glossary Tool

a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as specified by TEv2. HRGTs offer features for selecting terms that are curated within the scope it is run in, or from other scopes.

Integrity Checker Tool

a software tool designed to check the integrity and conformity of various files used in the curation and management of glossaries, dictionaries, curated texts, and other data within a terminology project. The ICT verifies that the files adhere to the TEv2 file specifications, ensuring the consistency and accuracy of the terminology data.

Identification Pattern

a set of concepts and other semantic units that can be used to explain the mechanisms that parties may use to identify entities, and mechanisms for communicating with another parties such that both parties can identify an entity and know whether or not they identify the same entity.

Identifier

a character string that is being used for the identification of some entity (yet may refer to 0, 1, or more entities, depending on the context within which it is being used).

Identifier Pattern

a set of concepts and other semantic units that can be used to explain how identifiers are defined and used for identification purposes.

Identify

an act, by or on behalf of a party, that results in the selection of either - a single partial identity that the party owns, given some (observed or received) data, or - a single entity from a given set of entities that is the subject of a specified partial identity that the party owns.

Identity

the combined knowledge about that entity of all parties, i.e. the union of all partial identities of which that entity is the subject.

Identity Pattern

a set of concepts and other semantic units that can be used to explain how digital identities work, how this relates to (attributes in) credentials, and how all this can be made to work in SSI contexts.

Ingestion Profile

the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a curated text.

Ingestion (Process)

the process that is run by a terms-community, in which their members suggest, draft, and discuss definitions (terms + criteria) that are relevant for a particular scope, and converting such contributions into curated texts that accurately document the concepts and other semantic units and that adhere to the TEv2-specifications.

Interpreter Profile

the set of named capturing groups that are an interpreter is expected to populate when it is used in the context of a specific TEv2 tool (such as the TRRT or HRGT).

Interpreter

a regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates named capturing groups as specified in the interpreter profile of the particular text conversion tool for which it is designed.

Jurisdiction

the composition of a legal system (legislation, enforcement thereof, and conflict resolution), a party that governs that legal system, a scope within which that legal system is operational, and one or more objective for the purpose of which the legal system is operated. See also the Jurisdictions pattern.

Jurisdiction Pattern

a set of concepts and other semantic units that can be used to explain what a generic jurisdiction consists of, and relates it to parties and legal entities.

Knowledge Artifact

See: semantic unit. (term is deprecated)

Knowledge

the (intangible) sum of what is known by a specific party, as well as the familiarity, awareness or understanding of someone or something by that party.

Legal Entity

an entity that is known by, recognized to exist, and registered in that jurisdiction.

Management

the act or process of managing or actually realizing of (the results associated with) a set of objective by the owner of these objective.

Mental Model

a semantic unit that relates a set of concepts (ideas), relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').

Moustache Variable

a placeholder in the form of a 'moustache' tag, e.g.: {{variable_name}}, that are used by converters to produce a text by which a text construct that is located by an interpreter will be replaced. See also https://mustache.github.io/mustache.5.html

Machine Readable Dictionary

a type of dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the terms and their meanings.

Machine Readable Dictionary Tool

a software tool designed to create, manage, and process Machine Readable Dictionaries (MRDs).

MRG Entry

A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular semantic unit, such as the associated term(s), its definition, etc., to make it easy for IT-tools to create, e.g. documentation, glossaries, dictionaries, whitepapers, etc. that uses such terms (definitions, etc.).

MRG Import (Tool)

is a tool in the TEv2 toolbox that is run within a particular scope for the purpose of obtaining MRGs from other scopes, as specified in the scope's SAF, and putting them in the scope's glossarydir.

MRGRef

a text that is marked up (in a specific way) so that it refers to a particular terminology, as well as to a specific way for creating an associated HRG.

Machine Readable Glossary

a glossary for a particular (version of a) terminology that is formatted in YAML, according to the TEv2 MRG specifications, to enable automated processing and integration with software systems.

Machine Readable Glossary Tool

a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as specified by TEv2. MRGTs offer features for selecting terms that are curated within the scope it is run in, or from other scopes.

Named Capturing Group

a sub-pattern within a regex (called a 'capturing group') that has been given a name, allowing one to refer to that sub-pattern.

Navpath

the (name of the field in the scope-section of a SAF that contains the) path to the directory where curated texts are rendered. The (value of this field) is for the rendered versions of curated texts what curatedir is for the curated texts themselves.

Objective

something toward which a party (its owner) directs effort (an aim, goal, or end of action).

Obligation

an objective that is owned by the party for producing a specific (set of) result(s) that are to be used (consumed) by that party and/or other parties.

Onboarding

a process that is run for a specific (set of) actor on behalf of a specific party, that terminates successfully if and only if the party has (a) established the suitability of the actor for executing certain kinds of action on its behalf, (b) ensured that their mutual rights and duties are properly specified and will be appropriately enforced, and (c) provided the circumstances/contexts within which the actor is enabled to do so.

Organization

a party that is capable of setting objective and making sure these are realized by actor that it has onboarded and/or by (vetted) parties that are committed to contribute to these objective.

Owned

an entity over which another entity (its owner) has the power (duty, right) to enjoy it, dispose of it and control it; that power is limited to (the scope of) that jurisdiction, and by its rules.

Owner

the role that a party performs when it is exercising its legal, rightful or natural title to control that entity.

Partial identity

all knowledge that a specific party (= the owner of the partial identity) has about that entity (= the 'subject' of the partial identity).

Party

an entity that sets its objective, maintains its knowledge, and uses that knowledge to pursue its objective in an autonomous (sovereign) manner. Humans and organization are the typical examples.

Property (of a Concept)

a connection or association between a concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the concept may have.

Provisional MRG Entry

an MRG entry that is 'under construction'; it contains 'raw' data that documents (the semantic unit referred to by) a term, that is obtained either from (the header of) a curated text, or from an MRG entry of some existing MRG.

Provisional MRG

a set of provisional MRG entries, to which such entries can be added, removed or modified, as specified by term selection instructions, and that are ultimately further processed to result in a proper MRG.

Reader

a person that reads a text that is authored by another person (its author), and that tries to understand the meaning of this text in the way its author intended.

Regular Expression

a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text. Within TEv2, we use a JavaScript flavor (ECMAScript 2022).

Regularized Form Phrase

a regularized text that is derived from, and represents a form phrase. They typically appear in the formPhrases field of an MRG entry.

Regularized Text

a character string that starts with a lowercase character ([a-z]), and has subsequent characters that match regex [a-z]_[0-9]-, and doesn't end with a - character. In other words, every text that matches the regex ^[a-z]([a-z]_[0-9]-)*(?<=[^-])$ is a regularized text.

Relation (between Concepts)

a (significant) connection or association between two or more concepts. These connections define the way these concepts are interrelated, providing insights into how they interact and influence each other.

Renderable Ref

a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help readers to (better) understand the intention of its author.

Risk Objective

an objective, owned by a party, that aims to reach and maintain a state of affairs in which the risk associated with a specific set of its objective become, and/or remain, acceptable.

Risk

the effects that uncertainty (i.e. a lack of information, understanding or knowledge of events, their consequences or likelihoods) can have on the intended realization of an objective of a party.

Scope Administration File

a YAML file that contains essential data about a particular scope (e.g., specifying where its curated texts, glossaries etc. live), the relationships this scope has with other scopes, and the specifications of the different terminologies that are curated within that scope. The SAF of a scope is located in its scopedir.

Scope

the extent of the terms, definitions and other documentation that a community (which we call the owner of the scope) needs to express, communicate and validate its knowledge as relevant to achieving a specific subset of its objectives.

Scoped Term

a term that represents (and identifies) a specific semantic unit of a particular community (or party).

Scopedir

a directory in a computer file system that contains all files that are either being curated within a particular scope, or generated to serve some purpose within that scope.

Scopetag

a tag that is used to identify scopes from within a specific scope

Semantic Unit

a basic building block of meaning or representation that exists within the 'mind' of a party (i.e., in its knowledge). Examples include ideas, or concepts, properties of concepts, relations between concepts, constraints over such concepts and relations, etc.

Semantics

a mapping between the (tangible/textual) terms and (intangible) ideas/concepts - their meaning.

Sorter

a specification, in the form of a predefined value or a handlebars expression, of the value that is to be used for sorting a list, e.g., for sorting HRG entries within a HRG list.

SSI (Self-Sovereign Identity)

sSI (Self-Sovereign Identity) is a term that has many different interpretations, and that we use to refer to concepts/ideas, architectures, processes and technologies that aim to support (autonomous) parties as they negotiate and execute electronic transaction with one another.

Synonym (of a [term](@))

a term that has the same (or sufficiently similar) meaning as another term (i.e., the term of which it is a synonym.

Tag

an alphanumeric string that is used to identify scopes (so called 'scopetags'), group terms (so called 'grouptags'), or identify a specific version of a terminology (so called 'versiontags') from within a specific scope.

Term Identifier

a text, of the form <termid>@<terminology-identifier>, that is used for identifying a semantic unit within a designated terminology. If @<terminology-identifier> is omitted, the current (or default) terminology is assumed.

TermRef

a word or phrase that is marked up (in a specific way) so that it refers to a particular concept (or other semantic unit), enabling it to be rendered in a variety of ways for the purpose of helping readers to (better) understand the intention of its author.

Term Selection Instruction

an instruction that is used to select one or more terms for the purpose of processing their documentation, e.g., to create an MRG.

Term Type

a text that identifies a particular kind of semantic unit within a particular scope. Examples include concept, relation, pattern (or mental-model).

Term

a word or phrase (i.e.: text) that is used to represent (identify) a specific semantic unit (in some scope).

Termid

a text of the form <termType>:<term> that serves as an unambiguous identifier for a specific semantic unit in some given scope.

Terminology Identifier

a text, of the form <scopetag>:<vsntag>, that identifies a terminology from within a particular scope, and can also be used to find the MRG file (in the glossarydir of that same scope) that contains entries for every term contained in that terminology. If <scopetag> and/or :<vsntag> is omitted, their values are taken be the current (or default) ones.

Terminology Process

a method for recognizing misunderstandings as such, and creating or maintaining definitions that resolve them.

Terminology

a set of terms that are used within a single scope to refer to concepts and other semantic units of a single party (e.g. a community), enabling parties to reason and communicate ideas they have about one or more specific topics.

Terminology Pattern

a mental model that describes the relations between a community, its (intangible) knowledge, and the artifacts we use to document that knowledge, such as terms, definitions, mental models, glossaries, etc.

Terms Community

a community that maintains a terminology for the purpose of avoiding misunderstandings between its members as they collaborate.

TEv2 Text Conversion Tool

a TEv2 tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.

TEv2 Toolbox

the collection of tools designed to support and facilitate the process of terminology management following the TEv2 specifications. These tools assist curators in various tasks related to the curation, creation, and maintenance of terminological assets.

TEv2 Tool

any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications.

TEv2

a set of specifications and tools that caters for the curation of terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual scopes.