Commit e7395c57 authored by Rieks Joosten's avatar Rieks Joosten

Corrected glossary-texts to include `^` instead of the `|` that causes errors

parent 0260e893
This diff is collapsed.
......@@ -18,6 +18,7 @@ beg = "(?<=\W%%)"
mid = "(?<=\|)"
end = "(?=%%\W)"
ss = "(?:['’]?s|\(s\))?"
yies = "(y|y['’]s|ies)"
dutyright = "(?:dut(?:y|ies)|rights?)"
dutyright = "%{dutyright}(?:-*(?:/|and|or|and/or)-*%{dutyright})?"
......@@ -82,12 +83,12 @@ replace-regex "%{mid}(action|actor|agent|assertion|author)%{ss}%{end}"
with "$1"
// [B]
replace-regex "%{mid}(business-transaction)%{ss}?%{end}"
with "$1"
-- for 'business-transaction' see 'transaction'
// [C]
// for 'claim', see 'statement'
replace-regex "%{mid}(colleague|concept|credential(-type)?|commitment-decision)%{ss}?%{end}"
replace-regex "%{mid}(colleague)(?:-agent)?%{ss}?%{end}"
with "$1"
replace-regex "%{mid}communications?-(channel|session)%{ss}?%{end}"
......@@ -102,7 +103,7 @@ with "digital-$1"
replace-regex "%{mid}(%{dutyrighttype}|%{dutyright})%{end}"
with "pattern-duties-and-rights"
replace-regex "%{mid}data-(collector|discloser)-polic(y's|ies)%{end}"
replace-regex "%{mid}data-(collector|discloser)-polic%{yies}%{end}"
with "data-$1-policy"
replace-regex "%{mid}data-(collector|discloser)%{ss}?%{end}"
with "data-$1"
......@@ -110,13 +111,13 @@ with "data-$1"
// [E]
replace-regex "%{mid}(employee|employer)%{ss}%{end}"
with "$1"
replace-regex "%{mid}(legal-)?entit(y's|ies)%{end}"
replace-regex "%{mid}(legal-)?entit%{yies}%{end}"
with "$1entity"
// [G]
replace-regex "%{mid}(glossary-file|guardian(ship)?(-relationship)?(-type)?)%{ss}%{end}"
with "$1"
replace-regex "%{mid}glossar(y's|ies)%{end}"
replace-regex "%{mid}glossar%{yies}%{end}"
with "glossary"
replace-regex "%{mid}guardianship(-relationship)?%{end}"
with "guardianship"
......@@ -124,6 +125,8 @@ replace-regex "%{mid}guardianship(-relationship)?-type%{end}"
with "guardianship-type"
replace-regex "%{mid}govern(or)?s?%{end}"
with "governance"
replace-regex "%{mid}(governed(?: by)?|governing-party)?s?%{end}"
with "governor"
// [H-I-J-K] (all holder, issuer, verifier and wallet stuff, too)
// for associated policies, see [P]
......@@ -136,15 +139,15 @@ with "$1"
// for 'legal entities', see 'entities'
// [O]
replace-regex "%{mid}(objective|organization|owned|owner|ownership)%{ss}%{end}"
replace-regex "%{mid}(?:natural-)?(objective|organization|owned|owner|ownership)%{ss}%{end}"
with "$1"
// [P]
replace-regex "%{mid}(participant|pattern-file|pattern|(peer-)(actor|agent)|policy-governor|presentation-request|presentation|principal)%{ss}%{end}"
with "$1"
replace-regex "%{mid}(|peer-)part(y's|ies)%{end}"
replace-regex "%{mid}(|peer-)part%{yies}%{end}"
with "$1party"
replace-regex "%{mid}(|issuer-|holder-|verifier-|wallet-|transaction-data-(collector|discloser)-)polic(y's|ies)%{end}"
replace-regex "%{mid}(|issuer-|holder-|verifier-|wallet-|transaction-data-(collector|discloser)-)polic%{yies}%{end}"
with "$1policy"
// [R-S]
......@@ -156,16 +159,16 @@ with "assertion"
// [T]
// for transaction data collector/discloers policies, see [P]
replace-regex "%{mid}(term-file|term|transaction-(agreement|data-(collector|discloser)|form|proposal))%{ss}%{end}"
replace-regex "%{mid}(?:business-)?(term-file|term|transaction(-agreement|-data-(collector|discloser)|-form|-proposal)?)%{ss}%{end}"
with "$1"
replace-regex "%{mid}transaction%{ss}?%{end}"
with "business-transaction"
// [V]
// for verifier stuff - see holder
replace-regex "%{mid}(verifiable-credential|verifier)%{ss}%{end}"
with "$1"
replace-regex "%{mid}vocabular(y's|ies)%{end}"
replace-regex "%{mid}(data-)?validat(e|ing|ion)(-data)%{end}"
with "validated-data"
replace-regex "%{mid}vocabular%{yies}%{end}"
with "vocabulary"
// [W]
......
......@@ -6,7 +6,7 @@ type: concept
typeid: action-type
stage: draft
hoverText: "Action Type/Class: the specification of properties and characteristics that such Actions must have in order to qualify as instance of that class, or the set of Actions that actually have these properties and characteristics."
glossaryText: "the specification of properties and characteristics that that %%actions|action%% must have in order to qualify as instance of that class, or the set of %%actions|action%% that actually have these properties and characteristics."
glossaryText: "the specification of properties and characteristics that that %%actions^action%% must have in order to qualify as instance of that class, or the set of %%actions^action%% that actually have these properties and characteristics."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: action
stage: draft
hoverText: "Action: something that is actually done/executed - by a single Actor (on behalf of a given Party), as a single operation in a specific context."
glossaryText: "something that is actually done/executed - by a single %%actor|actor%% (on behalf of a given %%party|party%%), as a single operation in a specific context."
glossaryText: "something that is actually done/executed - by a single %%actor^actor%% (on behalf of a given %%party^party%%), as a single operation in a specific context."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: actor
stage: draft
hoverText: "Actor: Entity that can act (do things), e.g. people, machines, but not Organizations."
glossaryText: "Entity that can act (do things), e.g. people, machines, but not %%organizations|organization%%."
glossaryText: "Entity that can act (do things), e.g. people, machines, but not %%organizations^organization%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: agent
stage: draft
hoverText: "Agent (of a Party): an Actor that is executing an Action on behalf of a Party (called the Principal of that Actor)."
glossaryText: "an %%actor|actor%% that is executing an %%action|action%% on behalf of a %%party|party%% (called the %%principal|principal%% of that %%actor|actor%%)."
glossaryText: "an %%actor^actor%% that is executing an %%action^action%% on behalf of a %%party^party%% (called the %%principal^principal%% of that %%actor^actor%%)."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: assertion
stage: draft
hoverText: "Assertion: a declaration/statement, made by a specific Party, that something is the case."
glossaryText: "a declaration/statement, made by a specific %%party|party%%, that something is the case."
glossaryText: "a declaration/statement, made by a specific %%party^party%%, that something is the case."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: author
stage: draft
hoverText: "Author (of data/document/file/...): a Party, on whose behalf that data/document/file/... has been created and/or updated."
glossaryText: "a %%party|party%%, on whose behalf that data/document/file/... has been created and/or updated."
glossaryText: "a %%party^party%%, on whose behalf that data/document/file/... has been created and/or updated."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: colleague
stage: draft
hoverText: "Colleagues: two or more (digital or non-digital) Agents that have the same Principal (i.e. Party on whose behalf they exeucte Actions)."
glossaryText: "two or more (digital or non-digital) %%agents|agent%% that have the same %%principal|principal%% (i.e. %%party|party%% on whose behalf they exeucte %%actions|action%%)."
glossaryText: "two or more (digital or non-digital) %%agents^agent%% that have the same %%principal^principal%% (i.e. %%party^party%% on whose behalf they exeucte %%actions^action%%)."
---
:::info Editor's note
......@@ -14,6 +14,6 @@ TNO (or others) to provide the content of this file.
:::
### Purpose
The ability to distinguish between (non) colleagues allows us to reason and communicate about the set of (digital and non-digital) %%actors|actor%% that are %%agents|agent%% for a **principal|principal%%. This is relevant in situations where different %%agents|agent%% excute %%actions|action%% in a single %%business transaction|business-transaction%% on behalf of the same %%principal|principal%%
The ability to distinguish between (non) colleagues allows us to reason and communicate about the set of (digital and non-digital) %%actors|actor%% that are %%agents|agent%% for a **principal|principal%%. This is relevant in situations where different %%agents|agent%% excute %%actions|action%% in a single %%business transaction|transaction%% on behalf of the same %%principal|principal%%
See also: %%digital colleague|digital-colleague%%.
......@@ -6,7 +6,7 @@ type: concept
typeid: commitment-decision
stage: draft
hoverText: "Commitment Decision (of a Party in a Business Transaction): the decision of that Party whether or not to commit to that Business Transaction, i.e. (promise) to fulfill the obligations that the associated Business Transaction Agreement Proposal would impose on that Party once it were signed."
glossaryText: "the decision of that %%party|party%% whether or not to commit to that %%business transaction|business-transaction%%, i.e. (promise) to fulfill the obligations that the associated %%business transaction agreement proposal|business-transaction-agreement-proposal%% would impose on that %%party|party%% once it were signed."
glossaryText: "the decision of that %%party^party%% whether or not to commit to that %%business transaction^transaction%%, i.e. (promise) to fulfill the obligations that the associated %%transaction agreement proposal^transaction-proposal%% would impose on that %%party^party%% once it were signed."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: communication-channel
stage: draft
hoverText: "Communication Channel: a (digital or non-digital) means by which two Actors can exchange messages with one another."
glossaryText: "a (digital or non-digital) means by which two %%actors|actor%% can exchange messages with one another."
glossaryText: "a (digital or non-digital) means by which two %%actors^actor%% can exchange messages with one another."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: communication-session
stage: draft
hoverText: "Communication Session: a time interval during which two Actors have an established Communication Channel that does not exist outside of that time interval."
glossaryText: "a time interval during which two %%actors|actor%% have an established %%communication channel|communication-channel%% that does not exist outside of that time interval."
glossaryText: "a time interval during which two %%actors^actor%% have an established %%communication channel^communication-channel%% that does not exist outside of that time interval."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: concept-file
stage: draft
hoverText: "Concept-file: a file whose contents defines/specifies a Concept."
glossaryText: "a file whose contents defines/specifies a %%concept|concept%%."
glossaryText: "a file whose contents defines/specifies a %%concept^concept%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: concept
stage: draft
hoverText: "Concept: the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."
glossaryText: "the ideas/thoughts behind a classification of %%entities|entity%% (what makes %%entities|entity%% in that class 'the same')."
glossaryText: "the ideas/thoughts behind a classification of %%entities^entity%% (what makes %%entities^entity%% in that class 'the same')."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: corpus
stage: draft
hoverText: "Corpus (of Terminology): the documentation that describes the Knowledge around a set of Terms and Concepts."
glossaryText: "the documentation that describes the %%knowledge|knowledge%% around a set of %%terms|term%% and %%concepts|concept%%."
glossaryText: "the documentation that describes the %%knowledge^knowledge%% around a set of %%terms^term%% and %%concepts^concept%%."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: credential-catalogue
stage: draft
hoverText: "Credential Catalogue (functional component): the capability to register and advertise the information about Credential Types that their respective Governing Parties have decided to disclose so as to enable other Parties to decide whether or not it is beneficial for them to use Credentials of such types."
glossaryText: "the capability to register and advertise the information about %%credential types|credential-type%% that their respective %%governing parties|governing-parties%% have decided to disclose so as to enable other %%parties|party%% to decide whether or not it is beneficial for them to use %%credentials|credential%% of such types."
glossaryText: "the capability to register and advertise the information about %%credential types^credential-type%% that their respective %%governing parties^governor%% have decided to disclose so as to enable other %%parties^party%% to decide whether or not it is beneficial for them to use %%credentials^credential%% of such types."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: credential-type
stage: draft
hoverText: "Credential Type: the specification of the contents, properties, constraints etc. that Credentials of this type must have/comply with."
glossaryText: "the specification of the contents, properties, constraints etc. that %%credentials|credential%% of this type must have/comply with."
glossaryText: "the specification of the contents, properties, constraints etc. that %%credentials^credential%% of this type must have/comply with."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: credential
stage: draft
hoverText: "Credential: data, representing a set of Assertions (claims, statements), authored and signed by, or on behalf of, a specific Party."
glossaryText: "data, representing a set of %%assertions|assertion%% (claims, statements), authored and signed by, or on behalf of, a specific %%party|party%%."
glossaryText: "data, representing a set of %%assertions^assertion%% (claims, statements), authored and signed by, or on behalf of, a specific %%party^party%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: data-collector-policy
stage: draft
hoverText: "Data Collector Policy: a Digital Policy that enables an operational Data Collector component to function according to the rules of its Policy Governor."
glossaryText: "a %%digital policy|digital-policy%% that enables an operational %%data collector|data-collector%% component to function according to the rules of its %%policy governor|policy-governor%%."
glossaryText: "a %%digital policy^digital-policy%% that enables an operational %%data collector^data-collector%% component to function according to the rules of its %%policy governor^policy-governor%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: data-collector
stage: draft
hoverText: "Data Collector: a functional component that is capable of collecting data from various Parties in the context of some Business Transaction, and Validating this data for the purpose of making one (or more) decision(s)."
glossaryText: "a functional component that is capable of collecting data from various %%parties|party%% in the context of some %%business transaction|business-transaction%%, and %%validating|validating%% this data for the purpose of making one (or more) decision(s)."
glossaryText: "a functional component that is capable of collecting data from various %%parties^party%% in the context of some %%business transaction^transaction%%, and %%validating^validated-data%% this data for the purpose of making one (or more) decision(s)."
---
### Short Description
......@@ -16,29 +16,29 @@ A **Data Collector** is an (architectural) function (a functional component in t
The purpose of a Data Collector is to collect sufficient and %%validated data|validated-data%% that eneables (an %%agent|agent%% of) its %%principal|principal%% to decide whether or not some request (typically for a product or a service) is to be serviced.
### Functionality
A data collector typically starts to collect data when it receives a request (e.g. to provide a product or service). The reception of such a request triggers the creation of a new %%business transaction|business-transaction%%. The task of the data collector is to collect %%validated data|validated-data%% that is sufficient for making a commitment decision (or, as [DEMO](https://en.wikipedia.org/wiki/Design_%26_Engineering_Methodology_for_Organizations) calls it: a 'promise' or 'quit' decision.)
A data collector typically starts to collect data when it receives a request (e.g. to provide a product or service). The reception of such a request triggers the creation of a new %%business transaction|transaction%%. The task of the data collector is to collect %%validated data|validated-data%% that is sufficient for making a commitment decision (or, as [DEMO](https://en.wikipedia.org/wiki/Design_%26_Engineering_Methodology_for_Organizations) calls it: a 'promise' or 'quit' decision.)
Starting the data collection for a transaction does NOT imply that the identity of the %%actors|actor%% from whom/which the request originated, is established (or authenticated). It also does NOT imply that the identity of the %%peer party|peer-party%% is established (or authenticated). The data collector simply proceeds to collect a sufficient amount of data such that the associated decision can be made, according to the rules, working-instructions and other guidance provided by its %%principal's|principal%% %%data collector policy|data-collector-policy%%. Such data may include identity data, but it also may not.
Starting the data collection for a transaction implies that the data collector informs the %%data discloser component|data-discloser%% about the %%transaction|business-transaction%% that has just started, and the kind of that transaction. This allows the %%data discloser component|data-discloser%% to process requests for data from %%peer agents|peer-agent%%[^1x]
Starting the data collection for a transaction implies that the data collector informs the %%data discloser component|data-discloser%% about the %%transaction|transaction%% that has just started, and the kind of that transaction. This allows the %%data discloser component|data-discloser%% to process requests for data from %%peer agents|peer-agent%%[^1x]
All guidance that the data collector needs to collect the necessary and %%validated data|validated-data%% to make that decision is provided by the %%data collector policy|data-collector-policy%% that has been established by the data collector's %%principal|principal%%. Such a policy includes e.g. the kinds of data (and meta-data) required to make these kinds of decisions, criteria to distinguish between %%data that is valid|validated-data%% and data that is not, any data conversions that may be needed, etc.
A data collector may multi-task, i.e. simultaneously/asynchronously collect data for multiple %%transactions|business-transaction%%. To organize this, messages that are exchanged with %%peer agents|peer-agent%% must contain an identifier that allows the data collector and its peer agents to identify the transaction to which each message belongs.
A data collector may multi-task, i.e. simultaneously/asynchronously collect data for multiple %%transactions|transaction%%. To organize this, messages that are exchanged with %%peer agents|peer-agent%% must contain an identifier that allows the data collector and its peer agents to identify the transaction to which each message belongs.
During the time in which a data collector is collecting data for a specific %%transaction|business-transaction%%, it may choose to setup, accept, and tear down %%communication sessions|communication-session%% with any %%actors|actor%%, if that is appropriate. This allows requests for data to be sent to different kinds of %%peer party|peer-party%%-%%agents|agent%%, e.g. human or %%digital|digital-agent%% agents. However, the data collector then must ensure that every of these %%agents|agent%% are all %%colleagues|colleague%%, i.e. have the %%peer party|peer-party%% as their %%principal|principal%%.
During the time in which a data collector is collecting data for a specific %%transaction|transaction%%, it may choose to setup, accept, and tear down %%communication sessions|communication-session%% with any %%actors|actor%%, if that is appropriate. This allows requests for data to be sent to different kinds of %%peer party|peer-party%%-%%agents|agent%%, e.g. human or %%digital|digital-agent%% agents. However, the data collector then must ensure that every of these %%agents|agent%% are all %%colleagues|colleague%%, i.e. have the %%peer party|peer-party%% as their %%principal|principal%%.
A data collector benefits from generic APIs or (G)UIs that allow it to simply ask for the data that it requires. Specifically for SSI, the data collector uses the %%eSSIF-Glue|essif-glue%% interface to access the %%Verifier|verifier%% functionalities.
### Criteria
A **Data Collector** is a functional component in the [eSSIF-Lab functional architecture](../functional-architecture) that
- services requests by %%digital|digital-agent%% and non-digital %%agents|agent%%, for providing a product or service, thereby starting a %%transaction|business-transaction%%;
- services requests by %%digital|digital-agent%% and non-digital %%agents|agent%%, for providing a product or service, thereby starting a %%transaction|transaction%%;
- can setup, accept and tear-down communication channels of various kinds, with %%digital|digital-colleague%% and/or non-digital %%colleagues|colleague%% of that %%requesting agent|agent%%,[^peer-agents] as appropriate for the data exchanges that are needed to conduct the transactions;
- can use any appropriate communication channel with a %%peer-agent|peer-agent%% to:
- request for data that, according to the %%Data Collector Policy|data-collector-policy%% is needed to decide whether or not to commit to the transaction;
- process the responses to such requests, in an orchestrated way, thereby complying with the rules of its %%principal's|principal%% %%Data Collector Policy|data-collector-policy%%, the result of which (in the end) is a set of %%validated data|validated-data%% that can serve the purpose of deciding whether or not to commit to the transaction;
- receive similar requests from its %%peer-party|peer-party%%, and respond to such requests in compliance with the rules of its %%principal's|principal%% %%Data Collector Policy|data-collector-policy%%;
- has a mechanism to ensure that within a %%transaction|business-transaction%%, it uses the latest (most receent) %%Data Collector Policy|data-collector-policy%% of its %%principal|principal%%.
- has a mechanism to ensure that within a %%transaction|transaction%%, it uses the latest (most receent) %%Data Collector Policy|data-collector-policy%% of its %%principal|principal%%.
### Deprecated - TVE Functionality
......
......@@ -6,7 +6,7 @@ type: concept
typeid: data-discloser-policy
stage: draft
hoverText: "Data Discloser Policy: a Digital Policy that enables an operational Data Discloser component to function according to the rules of its Policy Governor."
glossaryText: "a %%digital policy|digital-policy%% that enables an operational %%data discloser|data-discloser%% component to function according to the rules of its %%policy governor|policy-governor%%."
glossaryText: "a %%digital policy^digital-policy%% that enables an operational %%data discloser^data-discloser%% component to function according to the rules of its %%policy governor^policy-governor%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: data-discloser
stage: draft
hoverText: "Data Discloser: a functional component that is capable of disclosing data to (Agents of) other Parties, e.g. in the form of Credentials."
glossaryText: "a functional component that is capable of disclosing data to (Agents of) other %%parties|party%%, e.g. in the form of %%credentials|credential%%."
glossaryText: "a functional component that is capable of disclosing data to (Agents of) other %%parties^party%%, e.g. in the form of %%credentials^credential%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: definition
stage: draft
hoverText: "Definition: a text that helps Parties to understand the meaning of (and Concepts behind) a Term, ideally in such a way that these Parties can determine whether or not they make the same distinction."
glossaryText: "a text that helps %%parties|party%% to understand the meaning of (and %%concepts|concept%% behind) a %%term|term%%, ideally in such a way that these %%parties|party%% can determine whether or not they make the same distinction."
glossaryText: "a text that helps %%parties^party%% to understand the meaning of (and %%concepts^concept%% behind) a %%term^term%%, ideally in such a way that these %%parties^party%% can determine whether or not they make the same distinction."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: dependent
stage: draft
hoverText: "Dependent (of an Party in a Jurisdiction): the Entity for the caring for and/or protecting/guarding/defending of which a Guardianship Relationship has been established with that Entity within that Jurisdiction."
glossaryText: "the %%entity|entity%% for the caring for and/or protecting/guarding/defending of which a %%guardianship relationship|guardianship%% has been established with that %%entity|entity%% within that %%jurisdiction|jurisdiction%%."
glossaryText: "the %%entity^entity%% for the caring for and/or protecting/guarding/defending of which a %%guardianship relationship^guardianship%% has been established with that %%entity^entity%% within that %%jurisdiction^jurisdiction%%."
---
:::info Editor's Note
......
......@@ -6,7 +6,7 @@ type: dictionary
typeid: dictionary-file
stage: draft
hoverText: "Dictionary-file: a file whose contents specifies the contents of a Dictionary."
glossaryText: "a file whose contents specifies the contents of a %%dictionary|dictionary%%."
glossaryText: "a file whose contents specifies the contents of a %%dictionary^dictionary%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: dictionary
stage: draft
hoverText: "Dictionary: an alphabetically sorted list of Terms with various meanings they may have in different contexts."
glossaryText: "an alphabetically sorted list of %%terms|term%% with various meanings they may have in different contexts."
glossaryText: "an alphabetically sorted list of %%terms^term%% with various meanings they may have in different contexts."
---
### Short Description
......
......@@ -7,7 +7,7 @@ typeid: digital-actor
conceptref: ":Actor"
stage: draft
hoverText: "Digital Actor: an Actor in the digital world (e.g. a running app, or a web-server)."
glossaryText: "an %%actor|actor%% in the digital world (e.g. a running app, or a web-server)."
glossaryText: "an %%actor^actor%% in the digital world (e.g. a running app, or a web-server)."
---
### Purpose
......
......@@ -7,7 +7,7 @@ typeid: digital-agent
conceptref: ":Agent"
stage: draft
hoverText: "Digital Agent: an Agent in the digital world (e.g. a running app, or a web-server that is executing an Action for a specific Party (its Principal))."
glossaryText: "an %%agent|agent%% in the digital world (e.g. a running app, or a web-server that is executing an %%action|action%% for a specific %%party|party%% (its %%principal|principal%%))."
glossaryText: "an %%agent^agent%% in the digital world (e.g. a running app, or a web-server that is executing an %%action^action%% for a specific %%party^party%% (its %%principal^principal%%))."
---
### Purpose
......
......@@ -7,7 +7,7 @@ typeid: digital-colleague
conceptref: ":Colleague"
stage: draft
hoverText: "Digital Colleagues: two or more Digital Agents that all have the same Principal (i.e. Party on whose behalf they exeucte Actions)."
glossaryText: "two or more %%digital agents|digital-agent%% that all have the same %%principal|principal%% (i.e. %%party|party%% on whose behalf they exeucte %%actions|action%%)."
glossaryText: "two or more %%digital agents^digital-agent%% that all have the same %%principal^principal%% (i.e. %%party^party%% on whose behalf they exeucte %%actions^action%%)."
---
### Purpose
......
......@@ -6,7 +6,7 @@ type: concept
typeid: digital-communication-channel
stage: draft
hoverText: "Digital Communication Channel: a digital means by which two Digital Actors can exchange messages with one another"
glossaryText: "a digital means by which two %%digital actors|digital-actor%% can exchange messages with one another"
glossaryText: "a digital means by which two %%digital actors^digital-actor%% can exchange messages with one another"
---
:::info Editor's note
......
......@@ -7,7 +7,7 @@ typeid: digital-policy
conceptref: ":Policy"
stage: draft
hoverText: "Digital Policy (of a Party, for Action types): a machine-readable Policy that enables Digital Agents whose Principal is the Policy's Governor, to execute Actions of such types in compliance with that Policy (i.e.: according to the rules, working-instructions, preferences and other guidance specified therein)."
glossaryText: "a machine-readable %%policy|policy%% that enables %%digital agents|digital-agent%% whose %%principal|principal%% is the %%policy|policy%%'s %%governor|governance%%, to execute %%actions|action%% of such types in compliance with that %%policy|policy%% (i.e.: according to the rules, working-instructions, preferences and other guidance specified therein)."
glossaryText: "a machine-readable %%policy^policy%% that enables %%digital agents^digital-agent%% whose %%principal^principal%% is the %%policy^policy%%'s %%governor^governance%%, to execute %%actions^action%% of such types in compliance with that %%policy^policy%% (i.e.: according to the rules, working-instructions, preferences and other guidance specified therein)."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: employee
stage: draft
hoverText: "Employee (of a Party): an Actor for whom/which it is realistic that it might execute Actions on behalf of that Party (called the Employer of that Actor)."
glossaryText: "an %%actor|actor%% for whom/which it is realistic that it might execute %%actions|action%% on behalf of that %%party|party%% (called the %%employer|employer%% of that %%actor|actor%%)."
glossaryText: "an %%actor^actor%% for whom/which it is realistic that it might execute %%actions^action%% on behalf of that %%party^party%% (called the %%employer^employer%% of that %%actor^actor%%)."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: employer
stage: draft
hoverText: "Employer (of an Actor): a Party on whose behalf this Actor (called an Employee of that Party) might execute Actions."
glossaryText: "a %%party|party%% on whose behalf this %%actor|actor%% (called an %%employee|employee%% of that %%party|party%%) might execute %%actions|action%%."
glossaryText: "a %%party^party%% on whose behalf this %%actor^actor%% (called an %%employee^employee%% of that %%party^party%%) might execute %%actions^action%%."
---
:::info Editor's note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: essif-glue
stage: draft
hoverText: "eSSIF-Glue: interface layer that allows components with Transaction Data Collector and/or Transaction Data Discloser functionality to use the Wallet, Holder, Issuer and Verifier functionalities."
glossaryText: "interface layer that allows components with %%transaction data collector|transaction-data-collector%% and/or %%transaction data discloser|transaction-data-discloser%% functionality to use the %%wallet|wallet%%, %%holder|holder%%, %%issuer|issuer%% and %%verifier|verifier%% functionalities."
glossaryText: "interface layer that allows components with %%transaction data collector^transaction-data-collector%% and/or %%transaction data discloser^transaction-data-discloser%% functionality to use the %%wallet^wallet%%, %%holder^holder%%, %%issuer^issuer%% and %%verifier^verifier%% functionalities."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: glossary
typeid: glossary-file
stage: draft
hoverText: "Glossary-file: a file whose contents defines/specifies a Glossary."
glossaryText: "a file whose contents defines/specifies a %%glossary|glossary%%."
glossaryText: "a file whose contents defines/specifies a %%glossary^glossary%%."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: glossary
stage: draft
hoverText: "Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."
glossaryText: "an alphabetically sorted list of %%terms|term%% with the (single) meaning it has in (at least) one context."
glossaryText: "an alphabetically sorted list of %%terms^term%% with the (single) meaning it has in (at least) one context."
---
### Short Description
......
......@@ -12,7 +12,7 @@ glossaryText: "the act or process of governing or overseeing the control and dir
### Short Description
**Governance** is the act (executed by, or behalf of some %%party|party%%) or process (of some %%party|party%%) of governing or overseeing the control and direction of something ([Merriam-Webster](https://www.merriam-webster.com/dictionary/governance)). The governance of a %%party|party%% is embodied by the set of processes by which it decides how to make (other) decisions, how %%actors|actor%% that it %%employs|employee%% are to behave and operate, and ensure this guidance ends up in documents (which we will call %%policies|policy%%).
As %%parties|party%% interact with one another, i.e. conduct %%business transactions|business-transaction%%, they need to decide whether or not to commit to a transaction proposal. Deciding about how to make such a decision is one of the subjects of the governance process of that %%party|party%%: it is establishing the kind of argument that may be used to make this decision.
As %%parties|party%% interact with one another, i.e. conduct %%business transactions|transaction%%, they need to decide whether or not to commit to a transaction proposal. Deciding about how to make such a decision is one of the subjects of the governance process of that %%party|party%%: it is establishing the kind of argument that may be used to make this decision.
Within eSSIF-Lab, governance is pretty much limited to the governance of various %%policies|policy%%.
......
......@@ -6,7 +6,7 @@ type: concept
typeid: governor
stage: draft
hoverText: "Governor: the role that a Party assumes as it is governing or overseeing the control and direction of something."
glossaryText: "the role that a %%party|party%% assumes as it is governing or overseeing the control and direction of something."
glossaryText: "the role that a %%party^party%% assumes as it is governing or overseeing the control and direction of something."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: guardian
stage: draft
hoverText: "Guardian (of an Entity in a Jurisdiction): the Party that is tasked to care for and/or protect/guard/defend that Entity, for the purpose of which a Guardianship Relationship has been established within that Jurisdiction."
glossaryText: "the %%party|party%% that is tasked to care for and/or protect/guard/defend that %%entity|entity%%, for the purpose of which a %%guardianship relationship|guardianship%% has been established within that %%jurisdiction|jurisdiction%%."
glossaryText: "the %%party^party%% that is tasked to care for and/or protect/guard/defend that %%entity^entity%%, for the purpose of which a %%guardianship relationship^guardianship%% has been established within that %%jurisdiction^jurisdiction%%."
---
:::info Editor's Note
......
......@@ -6,7 +6,7 @@ type: concept
typeid: guardianship-type
stage: draft
hoverText: "Guardianship-type (in a Jurisdiction): a class of Guardianships (relationships) within the Jurisdiction that has defined it."
glossaryText: "a class of %%guardianships|guardianship%% (relationships) within the %%jurisdiction|jurisdiction%% that has defined it."
glossaryText: "a class of %%guardianships^guardianship%% (relationships) within the %%jurisdiction^jurisdiction%% that has defined it."
---
### Short Description
......
......@@ -6,7 +6,7 @@ type: concept
typeid: guardianship
stage: draft
hoverText: "Guardianship (of a Party over an Entity in a Jurisdiction): the rights and duties of that Party, defined and enforced in that Jurisdiction, for the purpose of caring for and/or protecting/guarding/defending that Entity."
glossaryText: "the rights and duties of that %%party|party%%, defined and enforced in that %%jurisdiction|jurisdiction%%, for the purpose of caring for and/or protecting/guarding/defending that %%entity|entity%%."
glossaryText: "the rights and duties of that %%party^party%%, defined and enforced in that %%jurisdiction^jurisdiction%%, for the purpose of caring for and/or protecting/guarding/defending that %%entity^entity%%."