From d7404e68f84422da82097ab073a617dca2bad491 Mon Sep 17 00:00:00 2001 From: Brian Richter Date: Tue, 7 Nov 2023 13:32:59 -0800 Subject: [PATCH] added dates and tags --- config.yaml | 2 +- curated-texts/Home.md | 17 ++++--- .../Minimum-Virtuous-Product-(MVirP).md | 19 ------- curated-texts/P2P-Decision-Context.md | 45 ---------------- curated-texts/PESTEL.md | 17 ------- curated-texts/balance-of-power.md | 39 -------------- curated-texts/collective-resiliency.md | 24 --------- .../complex-adaptive-system-(CAS).md | 23 --------- curated-texts/contingent-harm.md | 50 ------------------ curated-texts/decentralized-identifiers.md | 31 +++++++++++ .../digital-identity-ecosystem-(DIE).md | 26 ---------- curated-texts/digital-identity.md | 26 ---------- .../digital-trust-ecosystem-(DTE).md | 10 ---- curated-texts/direct-harm.md | 49 ------------------ curated-texts/edge-agency.md | 28 ---------- curated-texts/external-life-context.md | 30 ----------- curated-texts/felt-harm.md | 34 ------------- curated-texts/harms-work.md | 31 ----------- curated-texts/indirect-harm.md | 44 ---------------- curated-texts/internal-life-context.md | 30 ----------- curated-texts/internet-identity-workshop.md | 17 +++++++ curated-texts/man-made-thing.md | 36 ------------- curated-texts/meeting-october-18th.md | 10 ++++ curated-texts/natural-thing.md | 39 -------------- curated-texts/peer-to-peer-(P2P).md | 13 ----- .../self-sovereign-identity-(SSI).md | 10 ---- curated-texts/socio-technical-system-(STS).md | 46 ----------------- curated-texts/tev2.md | 37 ++++++++++++++ curated-texts/thing.md | 37 -------------- curated-texts/verifiable-credentials.md | 33 ++++++++++++ curated-texts/vulnerability-recognition.md | 51 ------------------- src/CuratedText.ts | 28 ++++++++-- src/Run.ts | 2 +- src/utils.ts | 39 +++++++------- 34 files changed, 185 insertions(+), 788 deletions(-) delete mode 100644 curated-texts/Minimum-Virtuous-Product-(MVirP).md delete mode 100644 curated-texts/P2P-Decision-Context.md delete mode 100644 curated-texts/PESTEL.md delete mode 100644 curated-texts/balance-of-power.md delete mode 100644 curated-texts/collective-resiliency.md delete mode 100644 curated-texts/complex-adaptive-system-(CAS).md delete mode 100644 curated-texts/contingent-harm.md create mode 100644 curated-texts/decentralized-identifiers.md delete mode 100644 curated-texts/digital-identity-ecosystem-(DIE).md delete mode 100644 curated-texts/digital-identity.md delete mode 100644 curated-texts/digital-trust-ecosystem-(DTE).md delete mode 100644 curated-texts/direct-harm.md delete mode 100644 curated-texts/edge-agency.md delete mode 100644 curated-texts/external-life-context.md delete mode 100644 curated-texts/felt-harm.md delete mode 100644 curated-texts/harms-work.md delete mode 100644 curated-texts/indirect-harm.md delete mode 100644 curated-texts/internal-life-context.md create mode 100644 curated-texts/internet-identity-workshop.md delete mode 100644 curated-texts/man-made-thing.md create mode 100644 curated-texts/meeting-october-18th.md delete mode 100644 curated-texts/natural-thing.md delete mode 100644 curated-texts/peer-to-peer-(P2P).md delete mode 100644 curated-texts/self-sovereign-identity-(SSI).md delete mode 100644 curated-texts/socio-technical-system-(STS).md create mode 100644 curated-texts/tev2.md delete mode 100644 curated-texts/thing.md create mode 100644 curated-texts/verifiable-credentials.md delete mode 100644 curated-texts/vulnerability-recognition.md diff --git a/config.yaml b/config.yaml index ba66eab..8af862a 100644 --- a/config.yaml +++ b/config.yaml @@ -1,5 +1,5 @@ --- -githubRepo: https://github.com/trustoverip/hxwg.wiki.git +githubRepo: https://github.com/aviarytech/tev2-test.wiki.git # TEv2 Curated Text Header term: curated-text termType: concept diff --git a/curated-texts/Home.md b/curated-texts/Home.md index 42eff19..863964d 100644 --- a/curated-texts/Home.md +++ b/curated-texts/Home.md @@ -2,13 +2,16 @@ glossaryTerm: Home term: home termType: concept +glossaryText: The home page for a TEv2 Test glossary. It works! +groupTags: + - tev2 + - home +created: 20231107 +updated: 20231107 --- -Welcome to the [Human Experience Working Group](https://wiki.trustoverip.org/x/_RIB) (HXWG) [terms wiki](https://github.com/trustoverip/hxwg/wiki/terms-wiki)! This is where the HXWG [terms community](https://github.com/trustoverip/ctwg/wiki/terms-community) manages the "bootstrap" terminology needed for its own documentation and tools. +## Definition +The home page for a TEv2 Test glossary. It works! -The [tag](https://github.com/trustoverip/ctwg/wiki/tag) that identifies this terms community and therefore also this terms wiki is: +## Tags +#tev2 #home -**#hxwg** - -For an overview and registry of terms wikis, see the [Terms Wikis](https://wiki.trustoverip.org/display/HOME/Terms+Wikis) page on Confluence. - -Individual terms are managed as separate wiki pages. See the "Pages" list at right. → diff --git a/curated-texts/Minimum-Virtuous-Product-(MVirP).md b/curated-texts/Minimum-Virtuous-Product-(MVirP).md deleted file mode 100644 index 29b6d8a..0000000 --- a/curated-texts/Minimum-Virtuous-Product-(MVirP).md +++ /dev/null @@ -1,19 +0,0 @@ ---- -glossaryTerm: Minimum Virtuous Product (MVirP) -term: minimum-virtuous-product -termType: concept -glossaryText: >- - A method of product development that tests for the effects on stakeholders and - builds in guards against potential harms. Defined by Hemant Taneja,[ The Era - of Move Fast & Break Things is Over, Harvard Business Review, 22 January - 2019](https://hbr.org/2019/01/the-era-of-move-fast-and-break-things-is-over) ---- -# Definition -A method of product development that tests for the effects on stakeholders and builds in guards against potential harms. Defined by Hemant Taneja,[ The Era of Move Fast & Break Things is Over, Harvard Business Review, 22 January 2019](https://hbr.org/2019/01/the-era-of-move-fast-and-break-things-is-over) -# Purpose -Distinguish from Minimum Viable Product -# Criterion -# Examples -# Related concepts -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/P2P-Decision-Context.md b/curated-texts/P2P-Decision-Context.md deleted file mode 100644 index 1d62c30..0000000 --- a/curated-texts/P2P-Decision-Context.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -glossaryTerm: P2P Decision Context -term: p2p-decision-context -termType: concept -glossaryText: >- - Single or chained peer-to-peer interactions or - [transactions](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) - that may be online or offline. The P2P decision context is inside the - [jurisdiction]([https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) - of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). - A single [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - contains many P2P decision contexts in spacetime. The harms experienced in - this context are [direct - harms](https://trustoverip.github.io/hxwg/glossary.html#direct-harm). - - - Sources of harm in this context are an im[balance of - power](https://trustoverip.github.io/hxwg/glossary.html#balance-of-power) - between the - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - in the - [transaction](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) - or conflicting - [objectives](https://essif-lab.github.io/framework/docs/essifLab-glossary#objective) - of the - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), - e.g. one is a bad actor, or a failure of governance or technology. ---- -# Definition -Single or chained peer-to-peer interactions or [transactions](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) that may be online or offline. The P2P decision context is inside the [jurisdiction]([https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). A single [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) contains many P2P decision contexts in spacetime. The harms experienced in this context are [direct harms](https://trustoverip.github.io/hxwg/glossary.html#direct-harm). - -Sources of harm in this context are an im[balance of power](https://trustoverip.github.io/hxwg/glossary.html#balance-of-power) between the [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the [transaction](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) or conflicting [objectives](https://essif-lab.github.io/framework/docs/essifLab-glossary#objective) of the [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), e.g. one is a bad actor, or a failure of governance or technology. -# Purpose -Distinguish from other contexts in the human harms framework. -# Criterion -# Examples -An online purchase, sending and receiving an email, playing a game, registering for a service. -# Related concepts -* [direct harm](https://trustoverip.github.io/hxwg/glossary.html#direct-harm) -* [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) -* [transaction](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/PESTEL.md b/curated-texts/PESTEL.md deleted file mode 100644 index aee807e..0000000 --- a/curated-texts/PESTEL.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -glossaryTerm: PESTEL -term: pestel -termType: concept -glossaryText: >- - Political, Economic, Sociocultural, Technological, Environmental and Legal - a - method of business analysis, see [PESTEL - Framework](https://pestleanalysis.com/pestel-framework/) ---- -# Definition -Political, Economic, Sociocultural, Technological, Environmental and Legal - a method of business analysis, see [PESTEL Framework](https://pestleanalysis.com/pestel-framework/) -# Purpose -# Criterion -# Examples -# Related concepts -# Tags - #harmstf diff --git a/curated-texts/balance-of-power.md b/curated-texts/balance-of-power.md deleted file mode 100644 index 91b9668..0000000 --- a/curated-texts/balance-of-power.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -glossaryTerm: Balance Of Power -term: balance-of-power -termType: concept -glossaryText: >- - A balance of power in a [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - is that 1) no single - [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) or - group of - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - has control, authority or influence over all other - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - or - [actors](https://essif-lab.github.io/framework/docs/essifLab-glossary#actor) - in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - and, 2) all - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - have a legitimate power base within the - [jurisdiction](https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) - of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). ---- -## Definition -A balance of power in a [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) is that 1) no single [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) or group of [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) has control, authority or influence over all other [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) or [actors](https://essif-lab.github.io/framework/docs/essifLab-glossary#actor) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) and, 2) all [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) have a legitimate power base within the [jurisdiction](https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). -## Purpose -One of four harms mitigation strategies implemented at the intersection of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) and the [P2P decision context](https://trustoverip.github.io/hxwg/glossary.html#p2p-decision-context) focused on protecting from [contingent harm](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm). -## Criterion -## Examples -A whistleblower policy is an example of a governance countermeasure to mitigate harms using a balance of power -## Related concepts -* [edge agency](https://trustoverip.github.io/hxwg/glossary.html#edge-agency) -* [vulnerability recognition](https://trustoverip.github.io/hxwg/glossary.html#vulnerability-recognition) -* [collective resiliency](https://trustoverip.github.io/hxwg/glossary.html#collective-resiliency) -## Tags - #harmstf diff --git a/curated-texts/collective-resiliency.md b/curated-texts/collective-resiliency.md deleted file mode 100644 index 79f3cb1..0000000 --- a/curated-texts/collective-resiliency.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -glossaryTerm: Collective Resiliency -term: collective-resiliency -termType: concept -glossaryText: >- - Collective resiliency is the ability of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - to detect, protect, defend and recover from [indirect - harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm). ---- -## Definition -Collective resiliency is the ability of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) to detect, protect, defend and recover from [indirect harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm). -## Purpose -One of four harms mitigation strategies implemented at the intersection of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) and the [external life context](https://trustoverip.github.io/hxwg/glossary.html#external-life-context) focused on protecting from [indirect harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm). -## Criterion -Always applies to a group of [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), i.e. the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) as a whole. -## Examples -A disaster recovery plan is an example of an operational countermeasure to mitigate harms using collective resiliency. -## Related concepts -* [edge agency](https://trustoverip.github.io/hxwg/glossary.html#edge-agency) -* [vulnerability recognition](https://trustoverip.github.io/hxwg/glossary.html#vulnerability-recognition) -* [balance of power](https://trustoverip.github.io/hxwg/glossary.html#balance-of-power) -## Tags - #harmstf diff --git a/curated-texts/complex-adaptive-system-(CAS).md b/curated-texts/complex-adaptive-system-(CAS).md deleted file mode 100644 index 673e0dc..0000000 --- a/curated-texts/complex-adaptive-system-(CAS).md +++ /dev/null @@ -1,23 +0,0 @@ ---- -glossaryTerm: Complex Adaptive System (CAS) -term: complex-adaptive-system -termType: concept -glossaryText: >- - A group of semi-autonomous agents who interact in interdependent ways to - produce system-wide patterns, such that those patterns then influence - behaviour of the agents. In human systems at all scales, you see patterns that - emerge from the interactions of agents in that system. Can be applied to - ecological, social, biological and technical systems. - - See [Human Systems Dynamics - Institute](https://www.hsdinstitute.org/resources/complex-adaptive-system.html). ---- -# Definition -A group of semi-autonomous agents who interact in interdependent ways to produce system-wide patterns, such that those patterns then influence behaviour of the agents. In human systems at all scales, you see patterns that emerge from the interactions of agents in that system. Can be applied to ecological, social, biological and technical systems. -See [Human Systems Dynamics Institute](https://www.hsdinstitute.org/resources/complex-adaptive-system.html). -# Purpose -# Criterion -# Examples -# Related concepts -# Tags - #harmstf diff --git a/curated-texts/contingent-harm.md b/curated-texts/contingent-harm.md deleted file mode 100644 index da5beee..0000000 --- a/curated-texts/contingent-harm.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -glossaryTerm: Contingent Harm -term: contingent-harm -termType: concept -glossaryText: >- - Contingent harms arise in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - and are harms that are experienced as a consequence of - [transactions](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) - or decisions made by other - [actors](https://essif-lab.github.io/framework/docs/essifLab-glossary#actor) - who are also members of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). - - Sources of contingent harm are the misalignment of - [objectives](https://essif-lab.github.io/framework/docs/essifLab-glossary#objective) - or incentives between - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem); - loss of digital access, and a failure of - [governance](https://essif-lab.github.io/framework/docs/essifLab-glossary#governance) - or technology to function as expected. - - Impacts of contingent harms are - [ecosystem](https://essif-lab.github.io/framework/docs/essifLab-glossary#ecosystem) - decay affecting all - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - in the - [ecosystem](https://essif-lab.github.io/framework/docs/essifLab-glossary#ecosystem) - and breakdown of relationships leading to loss of interoperability with other - [digital identity - ecosystems](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) ---- -# Definition -Contingent harms arise in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) and are harms that are experienced as a consequence of [transactions](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) or decisions made by other [actors](https://essif-lab.github.io/framework/docs/essifLab-glossary#actor) who are also members of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). -Sources of contingent harm are the misalignment of [objectives](https://essif-lab.github.io/framework/docs/essifLab-glossary#objective) or incentives between [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem); loss of digital access, and a failure of [governance](https://essif-lab.github.io/framework/docs/essifLab-glossary#governance) or technology to function as expected. -Impacts of contingent harms are [ecosystem](https://essif-lab.github.io/framework/docs/essifLab-glossary#ecosystem) decay affecting all [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the [ecosystem](https://essif-lab.github.io/framework/docs/essifLab-glossary#ecosystem) and breakdown of relationships leading to loss of interoperability with other [digital identity ecosystems](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) -# Purpose -Distinguish from other types of harm ([indirect](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm), [direct](https://trustoverip.github.io/hxwg/glossary.html#direct-harm), [felt](https://trustoverip.github.io/hxwg/glossary.html#felt-harm)) in the human harms framework. -# Criterion -Must be harm that comes from a [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) of which the harmed [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) is a member, and be a result of [transactions](https://essif-lab.github.io/framework/docs/essifLab-glossary#transaction) between third [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) who are also members of the same [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). -# Examples -A gambling addict who is targeted with advertising for casinos on a social media site is an example of contingent harm. The harm is a result of advertising sales between the social media site and the casinos. -# Related concepts -* [indirect harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm) -* [direct harm](https://trustoverip.github.io/hxwg/glossary.html#direct-harm) -* [felt](https://trustoverip.github.io/hxwg/glossary.html#felt-harm) -# Tags - #harmstf diff --git a/curated-texts/decentralized-identifiers.md b/curated-texts/decentralized-identifiers.md new file mode 100644 index 0000000..abfe5c2 --- /dev/null +++ b/curated-texts/decentralized-identifiers.md @@ -0,0 +1,31 @@ +--- +glossaryTerm: Decentralized Identifiers (DIDs) +term: decentralized-identifiers +termType: concept +glossaryText: >- + Decentralized Identifiers (DIDs) are a new type of identifier that enables + verifiable, self-sovereign digital identity. DIDs are fully under the control + of the DID subject, independent from any centralized registry, identity + provider, or certificate authority. They have emerged as a pivotal standard, + endorsed by the W3C, fostering interoperability and promoting a decentralized + approach to digital identity verification. This model facilitates a secure and + verifiable method of establishing digital trust, allowing individuals and + entities to have greater control and transparency over their digital + identities. +groupTags: + - did + - decentralized + - identifier + - tev2 +created: 20231107 +updated: 20231107 +--- +## Definition +Decentralized Identifiers (DIDs) are a new type of identifier that enables verifiable, self-sovereign digital identity. DIDs are fully under the control of the DID subject, independent from any centralized registry, identity provider, or certificate authority. They have emerged as a pivotal standard, endorsed by the W3C, fostering interoperability and promoting a decentralized approach to digital identity verification. This model facilitates a secure and verifiable method of establishing digital trust, allowing individuals and entities to have greater control and transparency over their digital identities. + +## Usage Examples +This [Decentralized Identifiers](https://www.w3.org/TR/did-core/) specification was published by the [Decentralized Identifier Working Group](https://www.w3.org/groups/wg/did) as a Recommendation using the [Recommendation track](https://www.w3.org/2021/Process-20211102/#recs-and-notes). + +## Tags +#did #decentralized-identifier #tev2 + diff --git a/curated-texts/digital-identity-ecosystem-(DIE).md b/curated-texts/digital-identity-ecosystem-(DIE).md deleted file mode 100644 index c1961ce..0000000 --- a/curated-texts/digital-identity-ecosystem-(DIE).md +++ /dev/null @@ -1,26 +0,0 @@ ---- -glossaryTerm: Digital Identity Ecosystem (DIE) -term: digital-identity-ecosystem -termType: concept -glossaryText: >- - A set of at least two (autonomous) - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - (the members of the ecosystem), whose individual expressions of [digital - identity](https://trustoverip.github.io/hxwg/glossary.html#digital-identity) - are recognised by other members, and whose individual work is of benefit to - the set as a whole. Also see [digital trust ecosystem - (DTE)](https://trustoverip.github.io/toip/glossary.html#digital-trust-ecosystem). ---- -# Definition -A set of at least two (autonomous) [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) (the members of the ecosystem), whose individual expressions of [digital identity](https://trustoverip.github.io/hxwg/glossary.html#digital-identity) are recognised by other members, and whose individual work is of benefit to the set as a whole. Also see [digital trust ecosystem (DTE)](https://trustoverip.github.io/toip/glossary.html#digital-trust-ecosystem). -# Purpose -Distinguish from other types of digital [ecosystem]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)ecosystem) e.g. associated with payments, advertising or connectivity. Distinguish from other contexts in the human harms framework. -# Criterion -# Examples -FIDO, Facebook and Google are examples of digital identity ecosystems for devices and people. -# Related concepts -* [digital identity](https://trustoverip.github.io/hxwg/glossary.html#digital-identity) -* [P2P decision context](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) -* [digital trust ecosystem (DTE)](https://trustoverip.github.io/toip/glossary.html#digital-trust-ecosystem) -# Tags - #harmstf #toip \ No newline at end of file diff --git a/curated-texts/digital-identity.md b/curated-texts/digital-identity.md deleted file mode 100644 index 89c3d33..0000000 --- a/curated-texts/digital-identity.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -glossaryTerm: Digital Identity -term: digital-identity -termType: concept -glossaryText: >- - [Digital - data](https://essif-lab.github.io/framework/docs/essifLab-glossary#data) that - enables a specific - [entity](https://essif-lab.github.io/framework/docs/essifLab-glossary#entity) - to be distinguished from all others in a specific context. Identity may apply - to any type of - [entity](https://essif-lab.github.io/framework/docs/terms/entity), including - individuals, organisations, and - [things](https://trustoverip.github.io/hxwg/glossary.html#thing). ---- -# Definition -[Digital data](https://essif-lab.github.io/framework/docs/essifLab-glossary#data) that enables a specific [entity](https://essif-lab.github.io/framework/docs/essifLab-glossary#entity) to be distinguished from all others in a specific context. Identity may apply to any type of [entity](https://essif-lab.github.io/framework/docs/terms/entity), including individuals, organisations, and [things](https://trustoverip.github.io/hxwg/glossary.html#thing). -# Purpose -Distinguish from other types of identity e.g. political identity, cultural identity, ethnic identity, gender identity…..etc -# Criterion -# Examples -Apple ID, Google ID, Facebook Connect, a digital vaccine passport or an account with a digital service provider used to login (authenticate) to that service are all examples of digital identities for individuals. GLEIF’s vLEI is an example of digital identity for organisations, and an Electronic Mobile Equipment Identifier is an example of digital identity for things. -# Related concepts -* [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) -# Tags - #sovrin #harmstf #essif diff --git a/curated-texts/digital-trust-ecosystem-(DTE).md b/curated-texts/digital-trust-ecosystem-(DTE).md deleted file mode 100644 index 494e58d..0000000 --- a/curated-texts/digital-trust-ecosystem-(DTE).md +++ /dev/null @@ -1,10 +0,0 @@ ---- -glossaryTerm: Digital Trust Ecosystem (DTE) -term: digital-trust-ecosystem -termType: concept -glossaryText: >- - See ToIP core terms [digital trust ecosystem - (DTE)](https://trustoverip.github.io/toip/glossary.html#digital-trust-ecosystem) ---- -# Definition -See ToIP core terms [digital trust ecosystem (DTE)](https://trustoverip.github.io/toip/glossary.html#digital-trust-ecosystem) diff --git a/curated-texts/direct-harm.md b/curated-texts/direct-harm.md deleted file mode 100644 index 2b863f9..0000000 --- a/curated-texts/direct-harm.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -glossaryTerm: Direct Harm -term: direct-harm -termType: concept -glossaryText: >- - Direct harm is the intentional or unintentional harm that is inflicted by one - [peer - actor]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)peer-actor) - on the other in the [P2P decision - context](https://trustoverip.github.io/toip/glossary.html#P2P-decision-context). - - Sources of direct harm are an im[balance of - power](https://trustoverip.github.io/toip/glossary.html#balance-of-power) - between the - [peer-parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#peer-party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)) - in the [business - transaction]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)business-transaction) - or conflicting - [objectives]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)objective) - of the - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - (e.g., one is a bad actor), or a failure of - [governance]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)governance) - or technology. - - Direct harms result in a failure of asset or value exchange, unintended loss - of assets for the harmed - [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), - intended or unintended asset gains for the other - [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in - the transaction. ---- -# Definition -Direct harm is the intentional or unintentional harm that is inflicted by one [peer actor]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)peer-actor) on the other in the [P2P decision context](https://trustoverip.github.io/toip/glossary.html#P2P-decision-context). -Sources of direct harm are an im[balance of power](https://trustoverip.github.io/toip/glossary.html#balance-of-power) between the [peer-parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#peer-party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)) in the [business transaction]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)business-transaction) or conflicting [objectives]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)objective) of the [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) (e.g., one is a bad actor), or a failure of [governance]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)governance) or technology. -Direct harms result in a failure of asset or value exchange, unintended loss of assets for the harmed [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), intended or unintended asset gains for the other [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the transaction. -# Purpose -Distinguish from other types of harm ([indirect](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm), [contingent](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm), [felt](https://trustoverip.github.io/hxwg/glossary.html#felt-harm)) in the human harms framework. -# Criterion -Direct harm is inflicted by one [peer actor]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)peer-actor) on another and impacts the [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), associated with those [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor). Otherwise it is defined as [contingent harm](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm) -# Examples -Coercion of a child to take sexually explicit pictures of themselves. Phishing, fraud. -# Related concepts -* [P2P decision context](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) -* [indirect harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm) -* [contingent harm](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm) -* [felt](https://trustoverip.github.io/hxwg/glossary.html#felt-harm) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/edge-agency.md b/curated-texts/edge-agency.md deleted file mode 100644 index 76ec017..0000000 --- a/curated-texts/edge-agency.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -glossaryTerm: Edge Agency -term: edge-agency -termType: concept -glossaryText: >- - Edge agency is the ability of all - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - at the edge of [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - (especially those who typically lack power or those who are operating outside - of their normal social structure, or who are in a minority), to autonomously - and intentionally make - [decisions]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)decision). ---- -# Definition -Edge agency is the ability of all [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) at the edge of [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) (especially those who typically lack power or those who are operating outside of their normal social structure, or who are in a minority), to autonomously and intentionally make [decisions]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)decision). -# Purpose -One of four harms mitigation strategies implemented at the intersection of the [P2P decision context](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) and the [internal life context](https://trustoverip.github.io/hxwg/glossary.html#internal-life-context) focused on protecting from [direct harm](https://trustoverip.github.io/hxwg/glossary.html#direct-harm). -# Criterion -Applies to [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) not [actors](https://essif-lab.github.io/framework/docs/essifLab-glossary#actor). -# Examples -Allowing users to purchase goods in an online store with a guest account instead of obliging them to create a customer account. An informed consent process. A cooling off period. -# Related concepts -* [collective resiliency](https://trustoverip.github.io/hxwg/glossary.html#collective-resiliency) -* [vulnerability recognition](https://trustoverip.github.io/hxwg/glossary.html#vulnerability-recognition) -* [balance of power](https://trustoverip.github.io/hxwg/glossary.html#balance-of-power) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/external-life-context.md b/curated-texts/external-life-context.md deleted file mode 100644 index 02d87ec..0000000 --- a/curated-texts/external-life-context.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -glossaryTerm: External Life Context -term: external-life-context -termType: concept -glossaryText: >- - Other: The world outside the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - including the physical and natural world, other people, organisations or - [things](https://trustoverip.github.io/hxwg/glossary.html#thing). The harms - experienced in the external life context are [indirect - harms](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm). Note - that a [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - of which a - [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) is - not a member is a part of the external life context. ---- -# Definition -Other: The world outside the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) including the physical and natural world, other people, organisations or [things](https://trustoverip.github.io/hxwg/glossary.html#thing). The harms experienced in the external life context are [indirect harms](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm). Note that a [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) of which a [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) is not a member is a part of the external life context. -# Purpose -Distinguish from other contexts in the human harms framework. The opposite of [internal life context](https://trustoverip.github.io/hxwg/glossary.html#internal-life-context). -# Criterion -The [entities]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity) in the external life context are not represented with a [digital identity](https://trustoverip.github.io/hxwg/glossary.html#digital-identity) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) that the harmed [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) belongs to. -# Examples -India’s Aadhar system is part of the external life context for most citizens of Canada. -# Related concepts -* [internal life context](https://trustoverip.github.io/hxwg/glossary.html#internal-life-context) -* [indirect harm](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/felt-harm.md b/curated-texts/felt-harm.md deleted file mode 100644 index 3c9dd76..0000000 --- a/curated-texts/felt-harm.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -glossaryTerm: Felt Harm -term: felt-harm -termType: concept -glossaryText: >- - Felt harms affect the physical and mental health and wellbeing of the harmed - [party]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) - in their [internal life - context](https://trustoverip.github.io/toip/glossary.html#internal-life-context). - - Sources of felt harm are vulnerabilities e.g. a physical or mental health - condition, dislocation and dissociation, e.g. for refugees. - - Felt harms have negative physiological, social, behavioural, emotional, - spiritual, religious or psychological impacts on the harmed - [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party). ---- -# Definition -Felt harms affect the physical and mental health and wellbeing of the harmed [party]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) in their [internal life context](https://trustoverip.github.io/toip/glossary.html#internal-life-context). -Sources of felt harm are vulnerabilities e.g. a physical or mental health condition, dislocation and dissociation, e.g. for refugees. -Felt harms have negative physiological, social, behavioural, emotional, spiritual, religious or psychological impacts on the harmed [party](https://essif-lab.github.io/framework/docs/essifLab-glossary#party). -# Purpose -Distinguish from other types of harm ([indirect](https://trustoverip.github.io/hxwg/glossary.html#indirect-harm), [contingent](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm), [direct](https://trustoverip.github.io/hxwg/glossary.html#felt-harm)) in the human harms framework. -# Criterion -Felt harms are only experienced by human beings as [parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#p](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)arty) that are human beings or organisations that are groups of human beings (a family, a team, an Indigenous People), they cannot be experienced by organisations as [entities]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity) in and of themselves or as legal [entities]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity). -# Examples -An eating disorder or suicidal ideation that is experienced by a teenage girl as a result of algorithms surfacing related content. -# Related concepts -* [internal life context](https://trustoverip.github.io/toip/glossary.html#internal-life-context) -* [indirect harm](https://trustoverip.github.io/toip/glossary.html#indirect-harm) -* [direct harm](https://trustoverip.github.io/toip/glossary.html#direct-harm) -* [contingent harm](https://trustoverip.github.io/toip/glossary.html#contingent-harm) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/harms-work.md b/curated-texts/harms-work.md deleted file mode 100644 index c9b50ff..0000000 --- a/curated-texts/harms-work.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -glossaryTerm: Harms Work -term: harms-work -termType: concept -glossaryText: >- - Efforts to characterize, detect, prevent, intervene in, remediate, and learn - from human harms rising from ToIP-related technologies. ---- -## Definition - -Efforts to characterize, detect, prevent, intervene in, remediate, and learn from human harms rising from ToIP-related technologies. - -## Purpose - -Harms-work exists to: - * Reduce negative externalities of digital identity technologies, practices, uses, and abuses. - * De-risk decentralized identity efforts - * Define the moral responsibilities of parties to an identity ecosystem. - - -## Criteria - -## Examples - -## Related Concepts - -## Use-cases - -## Notes - -## Tags diff --git a/curated-texts/indirect-harm.md b/curated-texts/indirect-harm.md deleted file mode 100644 index 97f8f21..0000000 --- a/curated-texts/indirect-harm.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -glossaryTerm: Indirect Harm -term: indirect-harm -termType: concept -glossaryText: >- - Indirect harm is the intentional or unintentional harm that is experienced by - one or more members of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - as a result of events or decisions outside the - [jurisdiction](https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) - of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem), - i.e. in the [external life - context](https://trustoverip.github.io/toip/glossary.html#external-life-context). - - Sources of harm include shocks and trends or changes, such as pandemics, - deforestation, war, an unexpected regulatory or legislative change, or climate - emergency. - - Indirect harms often have physical or infrastructural impacts on all the - members of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). - The harmed - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - have no influence or power over the circumstances or events that lead to that - harm. ---- -# Definition -Indirect harm is the intentional or unintentional harm that is experienced by one or more members of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) as a result of events or decisions outside the [jurisdiction](https://essif-lab.github.io/framework/docs/essifLab-glossary#jurisdiction) of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem), i.e. in the [external life context](https://trustoverip.github.io/toip/glossary.html#external-life-context). -Sources of harm include shocks and trends or changes, such as pandemics, deforestation, war, an unexpected regulatory or legislative change, or climate emergency. -Indirect harms often have physical or infrastructural impacts on all the members of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). The harmed [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) have no influence or power over the circumstances or events that lead to that harm. -# Purpose -Distinguish from other types of harm ([direct](https://trustoverip.github.io/hxwg/glossary.html#direct-harm), [contingent](https://trustoverip.github.io/hxwg/glossary.html#contingent-harm), [felt](https://trustoverip.github.io/hxwg/glossary.html#felt-harm)) in the human harms framework. -# Criterion -The opposite of [direct harm](https://trustoverip.github.io/toip/glossary.html#direct-harm). -# Examples -Loss of internet access due to storm damage to electricity cables, resulting in the failure of a medical device. Pandemic resulting in the shutdown of the international travel and tourism sector. -# Related concepts -* [external life context](https://trustoverip.github.io/toip/glossary.html#external-life-context) -* [direct harm](https://trustoverip.github.io/toip/glossary.html#direct-harm) -* [felt harm](https://trustoverip.github.io/toip/glossary.html#felt-harm) -* [contingent harm](https://trustoverip.github.io/toip/glossary.html#contingent-harm) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/internal-life-context.md b/curated-texts/internal-life-context.md deleted file mode 100644 index 9bcc70f..0000000 --- a/curated-texts/internal-life-context.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -glossaryTerm: Internal Life Context -term: internal-life-context -termType: concept -glossaryText: >- - Self: The world inside human beings as individuals and as social groups. The - physiological, psychological and spiritual world, of thoughts, stories, - memories and emotions across space and time which is inside the minds and - bodies of human beings who are - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). - The harms experienced in the internal life context are [felt - harms](https://trustoverip.github.io/hxwg/glossary.html#felt-harm). ---- -# Definition -Self: The world inside human beings as individuals and as social groups. The physiological, psychological and spiritual world, of thoughts, stories, memories and emotions across space and time which is inside the minds and bodies of human beings who are [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem). The harms experienced in the internal life context are [felt harms](https://trustoverip.github.io/hxwg/glossary.html#felt-harm). -# Purpose -Distinguish from other contexts in the human harms framework. The opposite of [external life context](https://trustoverip.github.io/hxwg/glossary.html#external-life-context). -# Criterion -All human beings or social groups [entities]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) have an individual internal life context within them. -# Examples -Religious beliefs, a state of mind, blood cells or physical organs. - - -# Related concepts -* [external life context](https://trustoverip.github.io/hxwg/glossary.html#external-life-context) -* [felt harm](https://trustoverip.github.io/hxwg/glossary.html#felt-harm) -# Tags - #harmstf \ No newline at end of file diff --git a/curated-texts/internet-identity-workshop.md b/curated-texts/internet-identity-workshop.md new file mode 100644 index 0000000..d2e6de4 --- /dev/null +++ b/curated-texts/internet-identity-workshop.md @@ -0,0 +1,17 @@ +--- +glossaryTerm: Internet Identity Workshop (IIW) +term: internet-identity-workshop +termType: concept +glossaryText: A workshop in Mountain View about all things Identity! +groupTags: + - tev2 + - iiw +created: 20231107 +updated: 20231107 +--- +## Definition +A workshop in Mountain View about all things Identity! + +## Tags +#tev2 #iiw + diff --git a/curated-texts/man-made-thing.md b/curated-texts/man-made-thing.md deleted file mode 100644 index 515e337..0000000 --- a/curated-texts/man-made-thing.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -glossaryTerm: Man Made Thing -term: man-made-thing -termType: concept -glossaryText: >- - From [Sovrin Foundation Glossary - V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). - A [Thing](https://trustoverip.github.io/hxwg/glossary.html#thing) generated by - human activity of some kind. Man-Made Things include both Active Things and - Passive Things. Mutually exclusive with [Natural - Thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing). Active - Things are the equivalent of non-human - [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) - in the eSSIF-Lab mental model [Parties,Actors, - Actions](https://essif-lab.pages.grnet.gr/framework/docs/terms/pattern-party-actor-action). - - Also see[ Appendix - B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) - and[ Appendix - C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) - of the Sovrin Glossary. ---- -# Definition -From [Sovrin Foundation Glossary V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). A [Thing](https://trustoverip.github.io/hxwg/glossary.html#thing) generated by human activity of some kind. Man-Made Things include both Active Things and Passive Things. Mutually exclusive with [Natural Thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing). Active Things are the equivalent of non-human [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) in the eSSIF-Lab mental model [Parties,Actors, Actions](https://essif-lab.pages.grnet.gr/framework/docs/terms/pattern-party-actor-action). -Also see[ Appendix B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) and[ Appendix C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) of the Sovrin Glossary. -# Purpose -Distinguish from [natural things](https://trustoverip.github.io/hxwg/glossary.html#natural-thing). -# Criterion - -# Examples -Manufactured or crafted goods, houses, cars, books, documents, and digital files. -# Related concepts -* [natural thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing) -* [thing](https://trustoverip.github.io/hxwg/glossary.html#thing) -# Tags - #harmstf #sovrin \ No newline at end of file diff --git a/curated-texts/meeting-october-18th.md b/curated-texts/meeting-october-18th.md new file mode 100644 index 0000000..5869c8b --- /dev/null +++ b/curated-texts/meeting-october-18th.md @@ -0,0 +1,10 @@ +--- +glossaryTerm: Meeting October 18th +term: meeting-october-18th +termType: concept +glossaryText: Rieks and Brian had a meeting on October 18th +created: 20231107 +updated: 20231107 +--- +## Definition +Rieks and Brian had a meeting on October 18th diff --git a/curated-texts/natural-thing.md b/curated-texts/natural-thing.md deleted file mode 100644 index 60bb6be..0000000 --- a/curated-texts/natural-thing.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -glossaryTerm: Natural Thing -term: natural-thing -termType: concept -glossaryText: >- - From [Sovrin Foundation Glossary - V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). - A [Thing](https://trustoverip.github.io/hxwg/glossary.html#thing) that exists - in the natural world independently of humans. Although natural things may form - part of a [man-made - thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing) - natural things are mutually exclusive with [man-made - things](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing). - Natural things can be - [parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) - but never - [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) - in the eSSIF-Lab mental model [Parties,Actors, - Actions](https://essif-lab.pages.grnet.gr/framework/docs/terms/pattern-party-actor-action). - - Also see[ Appendix - B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) - and[ Appendix - C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) - of the Sovrin Glossary. ---- -# Definition -From [Sovrin Foundation Glossary V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). A [Thing](https://trustoverip.github.io/hxwg/glossary.html#thing) that exists in the natural world independently of humans. Although natural things may form part of a [man-made thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing) natural things are mutually exclusive with [man-made things](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing). Natural things can be [parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) but never [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) in the eSSIF-Lab mental model [Parties,Actors, Actions](https://essif-lab.pages.grnet.gr/framework/docs/terms/pattern-party-actor-action). -Also see[ Appendix B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) and[ Appendix C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) of the Sovrin Glossary. -# Purpose -Distinguish from [man-made things](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing). -# Criterion -# Examples -Animals, pets, plants, forests, mountains, rivers, planet earth. -# Related concepts -* [man-made thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing) -* [thing](https://trustoverip.github.io/hxwg/glossary.html#thing) -# Tags - #harmstf #sovrin \ No newline at end of file diff --git a/curated-texts/peer-to-peer-(P2P).md b/curated-texts/peer-to-peer-(P2P).md deleted file mode 100644 index a89d2a0..0000000 --- a/curated-texts/peer-to-peer-(P2P).md +++ /dev/null @@ -1,13 +0,0 @@ ---- -glossaryTerm: Peer To Peer (P2P) -term: peer-to-peer -termType: concept -glossaryText: >- - Peer to Peer originally used to describe computer networks where each - participant acts as both a client and server. Can also refer to any 1:1 - relationship between human beings, - [organizations]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)organization) - or [things](https://trustoverip.github.io/hxwg/glossary.html#thing). ---- -# Definition -Peer to Peer originally used to describe computer networks where each participant acts as both a client and server. Can also refer to any 1:1 relationship between human beings, [organizations]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)organization) or [things](https://trustoverip.github.io/hxwg/glossary.html#thing). \ No newline at end of file diff --git a/curated-texts/self-sovereign-identity-(SSI).md b/curated-texts/self-sovereign-identity-(SSI).md deleted file mode 100644 index c8c74a0..0000000 --- a/curated-texts/self-sovereign-identity-(SSI).md +++ /dev/null @@ -1,10 +0,0 @@ ---- -glossaryTerm: Self Sovereign Identity (SSI) -term: self-sovereign-identity -termType: concept -glossaryText: >- - See Trust over IP [self-sovereign - identity](https://trustoverip.github.io/toip/glossary.html#self-sovereign-identity) ---- -# Definition -See Trust over IP [self-sovereign identity](https://trustoverip.github.io/toip/glossary.html#self-sovereign-identity) diff --git a/curated-texts/socio-technical-system-(STS).md b/curated-texts/socio-technical-system-(STS).md deleted file mode 100644 index 3a36385..0000000 --- a/curated-texts/socio-technical-system-(STS).md +++ /dev/null @@ -1,46 +0,0 @@ ---- -glossaryTerm: Socio Technical System (STS) -term: socio-technical-system -termType: concept -glossaryText: >- - An approach to complex organizational work design that recognizes the - interaction between people and technology in workplaces. The term also refers - to coherent systems of human relations, technical objects, and cybernetic - processes that inhere to large, complex infrastructures. Social society, and - its constituent substructures, qualify as complex sociotechnical systems. See - [Wikipedia](https://en.wikipedia.org/wiki/Sociotechnical_system) - - - There are six aspects of a socio-technical system. - - Goals/Metrics - - People - - Infrastructure - - Technology - - Culture - - Processes/Procedures ---- -# Definition -An approach to complex organizational work design that recognizes the interaction between people and technology in workplaces. The term also refers to coherent systems of human relations, technical objects, and cybernetic processes that inhere to large, complex infrastructures. Social society, and its constituent substructures, qualify as complex sociotechnical systems. See [Wikipedia](https://en.wikipedia.org/wiki/Sociotechnical_system) - -There are six aspects of a socio-technical system. -Goals/Metrics -People -Infrastructure -Technology -Culture -Processes/Procedures - -# Purpose -Distinguish from a technical system or a governance system -# Criterion -# Examples -A social media network, a cinema, an airport -# Related concepts -# Tags - #harmstf diff --git a/curated-texts/tev2.md b/curated-texts/tev2.md new file mode 100644 index 0000000..2bffa61 --- /dev/null +++ b/curated-texts/tev2.md @@ -0,0 +1,37 @@ +--- +glossaryTerm: TEv2 +term: tev2 +termType: concept +glossaryText: >- + The Terminology Engine V2 (TEv2) is a project under eSSIF-Lab, encompassing a + set of specifications and tools aimed at facilitating the creation, + maintenance, and application of terminologies across various types of + publications including websites and whitepapers. It supports different formats + such as HTML and LaTeX, aligning with diverse individual scopes. Furthermore, + it provides terminological aid for authors working on documentation, + specifications, whitepapers, and similar materials. Initially, it served as a + testing ground for the CTWG Toolkit development. +groupTags: + - terminologymanagement + - specification + - toolkit + - documentation + - essif + - lab + - tev2 +created: 20231107 +updated: 20231107 +--- +## Terminology Engine V2 (TEv2) + +### Definition +The Terminology Engine V2 (TEv2) is a project under eSSIF-Lab, encompassing a set of specifications and tools aimed at facilitating the creation, maintenance, and application of terminologies across various types of publications including websites and whitepapers. It supports different formats such as HTML and LaTeX, aligning with diverse individual scopes. Furthermore, it provides terminological aid for authors working on documentation, specifications, whitepapers, and similar materials. Initially, it served as a testing ground for the CTWG Toolkit development. + +### Usage Examples +- The TEv2 provides a framework for authors to manage terminologies efficiently, ensuring consistency and clarity across different types of publications[[6](source)][[7](source)]. +- It was used as a test bed for the development of the CTWG Toolkit, showcasing its potential for broader applications within the domain of terminology management[[8](source)]. + +### Tags +#TerminologyManagement #Specification #Toolkit #Documentation #eSSIF-Lab #TEv2 #tev2 + + diff --git a/curated-texts/thing.md b/curated-texts/thing.md deleted file mode 100644 index d825b10..0000000 --- a/curated-texts/thing.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -glossaryTerm: Thing -term: thing -termType: concept -glossaryText: >- - From [Sovrin Foundation Glossary - V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). - An - [entity]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity) - that is neither a human being nor an - [organization]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)organization) - and thus cannot be a - [party]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party). - A thing may be a [natural - thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing) or a - [man-made - thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing). - - Also see[ Appendix - B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) - and[ Appendix - C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) - of the Sovrin Glossary. ---- -# Definition -From [Sovrin Foundation Glossary V3](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit). An [entity]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)entity) that is neither a human being nor an [organization]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)organization) and thus cannot be a [party]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party). A thing may be a [natural thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing) or a [man-made thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing). -Also see[ Appendix B](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.mq7pzglc1j96) and[ Appendix C](https://docs.google.com/document/d/1gfIz5TT0cNp2kxGMLFXr19x1uoZsruUe_0glHst2fZ8/edit#heading=h.uiq9py7xnmxd) of the Sovrin Glossary. -# Purpose -Distinguish from human beings and [organizations]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)organization) -# Criterion -# Examples -Drones, software programmes, algorithms, mountains, rivers, forests, animals, a table, a pipe. -# Related concepts -* [man-made thing](https://trustoverip.github.io/hxwg/glossary.html#man-made-thing) -* [natural thing](https://trustoverip.github.io/hxwg/glossary.html#natural-thing) -# Tags - #harmstf #sovrin \ No newline at end of file diff --git a/curated-texts/verifiable-credentials.md b/curated-texts/verifiable-credentials.md new file mode 100644 index 0000000..b2c67e5 --- /dev/null +++ b/curated-texts/verifiable-credentials.md @@ -0,0 +1,33 @@ +--- +glossaryTerm: Verifiable Credentials (VCs) +term: verifiable-credentials +termType: concept +glossaryText: >- + Verifiable Credentials (VCs) are an open standard for digital credentials, + created to represent information found in physical credentials, such as a + passport or license, as well as information that has no physical equivalent + like ownership of a bank account[[23](source)]. They are defined by the World + Wide Web Consortium (W3C) as a standard data model and representation format + for expressing cryptographically-verifiable digital credentials[[24](source)]. + A VC uses cryptographic proofs to bind an issuer statement about a subject to + the subject's identifier, and the resulting document can contain claims + relative to the subject. In some instances, proofs of different kinds can be + bundled together within a VC[[25](source)]. +groupTags: + - digitalcredentials + - cryptographicverification + - w3c + - digitalidentity + - blockchain +created: 20231107 +updated: 20231107 +--- +## Definition +Verifiable Credentials (VCs) are an open standard for digital credentials, created to represent information found in physical credentials, such as a passport or license, as well as information that has no physical equivalent like ownership of a bank account[[23](source)]. They are defined by the World Wide Web Consortium (W3C) as a standard data model and representation format for expressing cryptographically-verifiable digital credentials[[24](source)]. A VC uses cryptographic proofs to bind an issuer statement about a subject to the subject's identifier, and the resulting document can contain claims relative to the subject. In some instances, proofs of different kinds can be bundled together within a VC[[25](source)]. + +## Usage Examples +- VCs can be used as a digital version of titles, diplomas, or certificates, issued by authoritative issuers[[27](source)]. +- Verifiable presentations, created from VCs, are packages of evidence built by holders to meet a verifier’s requirements, allowing verifiers to ascertain which issuers have attested something by checking digital signatures against a verifiable data registry, typically a blockchain[[26](source)]. + +## Tags +#DigitalCredentials #CryptographicVerification #W3C #DigitalIdentity #Blockchain \ No newline at end of file diff --git a/curated-texts/vulnerability-recognition.md b/curated-texts/vulnerability-recognition.md deleted file mode 100644 index 92157b1..0000000 --- a/curated-texts/vulnerability-recognition.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -glossaryTerm: Vulnerability Recognition -term: vulnerability-recognition -termType: concept -glossaryText: >- - Vulnerability recognition is one of four harms mitigation strategies in the - human harms framework. It is - - 1) the capability of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - to recognise that there are [P2P decision - contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) - where some - [parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) - or - [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) - could be vulnerable (e.g. they are a child, they are a person living with - dementia, they are a refugee) in the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - and in some or all [P2P decision - contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context). - - 2) the operational practice of the [digital identity - ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) - to carry out differentiated risk assessments to determine the likelihood of - those [P2P decision - contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) - occurring, and the impact on those - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), - - and 3) the ability to recognise the characteristics of - [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) - who may be vulnerable in those [P2P decision - contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context). ---- -# Definition -Vulnerability recognition is one of four harms mitigation strategies in the human harms framework. It is -1) the capability of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) to recognise that there are [P2P decision contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) where some [parties]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)party) or [actors]([https://essif-lab.github.io/framework/docs/essifLab-glossary#](https://essif-lab.github.io/framework/docs/essifLab-glossary#party)actor) could be vulnerable (e.g. they are a child, they are a person living with dementia, they are a refugee) in the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) and in some or all [P2P decision contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context). -2) the operational practice of the [digital identity ecosystem](https://trustoverip.github.io/hxwg/glossary.html#digital-identity-ecosystem) to carry out differentiated risk assessments to determine the likelihood of those [P2P decision contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context) occurring, and the impact on those [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party), -and 3) the ability to recognise the characteristics of [parties](https://essif-lab.github.io/framework/docs/essifLab-glossary#party) who may be vulnerable in those [P2P decision contexts](https://trustoverip.github.io/hxwg/glossary.html#P2P-decision-context). -# Purpose -One of four harms mitigation strategies implemented at the intersection of the [external life context](https://trustoverip.github.io/hxwg/glossary.html#external-life-context) and the [internal life context](https://trustoverip.github.io/hxwg/glossary.html#internal-life-context) focused on protecting from [felt harm](https://trustoverip.github.io/hxwg/glossary.html#felt-harm). -# Criterion -# Examples -Enabling [guardianship](https://essif-lab.github.io/framework/docs/essifLab-glossary#guardianship) Carrying out age verification and creating age-gated digital experiences are examples of harms countermeasures using vulnerability recognition. -# Related concepts -* [edge agency](https://trustoverip.github.io/hxwg/glossary.html#edge-agency) -* [collective resiliency](https://trustoverip.github.io/hxwg/glossary.html#collective-resiliency) -* [balance of power](https://trustoverip.github.io/hxwg/glossary.html#balance-of-power) -# Tags - #harmstf \ No newline at end of file diff --git a/src/CuratedText.ts b/src/CuratedText.ts index 57dc67b..5c958ba 100644 --- a/src/CuratedText.ts +++ b/src/CuratedText.ts @@ -1,4 +1,4 @@ -import * as yaml from 'js-yaml'; +import * as yaml from "js-yaml"; interface CuratedTextOptions { term: string; @@ -24,16 +24,36 @@ export class CuratedTextParser { constructor(markdownText: string, options: CuratedTextOptions) { this.markdownText = markdownText; this.options = options; - + // Extract "Definition" section and set as glossaryText - const definitionMatch = this.markdownText.match(/#{1,2} Definition\n([\s\S]*?)(?=\n#{1,2}|$)/); + const definitionMatch = this.markdownText.match( + /#{1,2} Definition\n([\s\S]*?)(?=\n#{1,2}|$)/ + ); if (definitionMatch && definitionMatch[1]) { this.options.glossaryText = definitionMatch[1].trim(); } + + // Extract "Tags" section and set as groupTags + const groupTags = this.markdownText.match( + /#{1,2} Tags\n([\s\S]*?)(?=\n#{1,2}|$)/ + ); + if (groupTags && groupTags[1]) { + this.options.groupTags = groupTags[1].match(/\w+/g) ?? []; + this.options.groupTags = Array.from( + new Set(this.options.groupTags.map((s) => s.toLowerCase())) + ); + } + + const date = new Date(); + const year = date.getFullYear().toString(); + const month = (date.getMonth() + 1).toString().padStart(2, "0"); + const day = date.getDate().toString().padStart(2, "0"); + this.options.created = `${year}-${month}-${day}`; + this.options.updated = `${year}-${month}-${day}`; } toYAML(): string { const frontmatter = yaml.dump(this.options); return `---\n${frontmatter}---\n${this.markdownText}`; } -} \ No newline at end of file +} diff --git a/src/Run.ts b/src/Run.ts index 9129e46..dd6e4f3 100755 --- a/src/Run.ts +++ b/src/Run.ts @@ -132,12 +132,12 @@ const main = async (): Promise => { fs.mkdirSync("curated-texts", { recursive: true }); } files.forEach((file) => { - const newFile = file.replace("wiki", "curated-texts"); const curatedText = new CuratedTextParser(getFileContents(file), { glossaryTerm: filenameToTitle(file), term: filenameToTerm(file), termType: "concept", }); + const newFile = `curated-texts/${filenameToTerm(file)}.md`; curatedText.toYAML(); console.log(file, "->", newFile); saveToFile(newFile, curatedText.toYAML()); diff --git a/src/utils.ts b/src/utils.ts index e5f1e8e..4d8110e 100644 --- a/src/utils.ts +++ b/src/utils.ts @@ -1,20 +1,21 @@ -import * as fs from 'fs'; -import * as path from 'path'; - +import * as fs from "fs"; +import * as path from "path"; // Remove any null values from the object export const removeNullValues = (obj: Record): void => { - Object.keys(obj).forEach(key => { + Object.keys(obj).forEach((key) => { if (obj[key] === null) { delete obj[key]; - } else if (typeof obj[key] === 'object') { + } else if (typeof obj[key] === "object") { removeNullValues(obj[key] as Record); } }); }; - -export const scanDir = (directoryPath: string, filesList: string[] = []): string[] => { +export const scanDir = ( + directoryPath: string, + filesList: string[] = [] +): string[] => { const files = fs.readdirSync(directoryPath); for (const file of files) { @@ -23,8 +24,8 @@ export const scanDir = (directoryPath: string, filesList: string[] = []): string if (fileStat.isFile()) { filesList.push(path.relative(process.cwd(), filePath)); - } else if (fileStat.isDirectory() && file !== '.git') { - console.log('file', file); + } else if (fileStat.isDirectory() && file !== ".git") { + console.log("file", file); scanDir(filePath, filesList); } } @@ -47,7 +48,7 @@ export const extractTokens = (text: string): MarkdownData => { const hash: MarkdownData = {} as MarkdownData; for (const line of lines) { - const colonIndex = line.indexOf(':'); + const colonIndex = line.indexOf(":"); if (colonIndex >= 0) { const key = line.slice(0, colonIndex).trim() as keyof MarkdownData; const value = line.slice(colonIndex + 1).trim(); @@ -60,25 +61,27 @@ export const extractTokens = (text: string): MarkdownData => { export function filenameToTitle(filename: string): string { // Remove the directory path and file extension - console.log(filename) - const baseFilename = filename.replace(/^.*\//, '').replace(/\.md$/, ''); + const baseFilename = filename.replace(/^.*\//, "").replace(/\.md$/, ""); // Split the filename into words using '-' as a delimiter - const words = baseFilename.split('-'); + const words = baseFilename.split("-"); // Capitalize the first letter of each word and join them with spaces const title = words - .map(word => word.charAt(0).toUpperCase() + word.slice(1)) - .join(' '); + .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) + .join(" "); return title; } export function filenameToTerm(filename: string): string { return filename - .replace(/\(.*?\)/g, "").replace(/^.*\//, '') - .replace(/\.md$/, '').replace(/-$/, "") + .replace(/\(.*?\)/g, "") + .replace(/^.*\//, "") + .replace(/\.md$/, "") + .replace(/-$/, "") .toLowerCase(); } -export const getFileContents = (filePath: string): string => fs.readFileSync(filePath, 'utf-8'); +export const getFileContents = (filePath: string): string => + fs.readFileSync(filePath, "utf-8");