From b840cda93ab4fc0b3ecad9585136ab75372e287e Mon Sep 17 00:00:00 2001 From: henkvancann Date: Tue, 12 Nov 2024 16:56:33 +0000 Subject: [PATCH] amended Signed-off-by: henkvancann --- spec/05_title.md | 4 ++-- spec/terms-and-definitions-intro.md | 2 +- spec/terms-definitions/abbrev.md | 2 +- spec/terms-definitions/alias.md | 2 +- spec/terms-definitions/guide.md | 4 ++-- spec/terms-definitions/normative.md | 4 +--- spec/terms-definitions/term.md | 4 ++-- specs.json | 6 +++--- 8 files changed, 13 insertions(+), 15 deletions(-) diff --git a/spec/05_title.md b/spec/05_title.md index 0cc16cd..a997250 100644 --- a/spec/05_title.md +++ b/spec/05_title.md @@ -29,6 +29,6 @@ Terminology Governance Guide It's mainly a summary of activities and decisions of CTWG in 2024; editor: Henk van Cann *Template improvements:* -~ [GitHub repo](https://github.com/trustoverip/spec-up-t) +- [GitHub repo](https://github.com/trustoverip/spec-up-t) -~ [Commit history](https://github.com/trustoverip/spec-up-t/commits/main) +- [Commit history](https://github.com/trustoverip/spec-up-t/commits/main) diff --git a/spec/terms-and-definitions-intro.md b/spec/terms-and-definitions-intro.md index 1ce5bf4..cea6e74 100644 --- a/spec/terms-and-definitions-intro.md +++ b/spec/terms-and-definitions-intro.md @@ -1,6 +1,6 @@ ## Demo terms, definitions and external definitions -A demo of terms and definitions, and references to external definitions. +A list of terms and definitions, and optionally references to external definitions.
diff --git a/spec/terms-definitions/abbrev.md b/spec/terms-definitions/abbrev.md index 145a9ce..15ec0cd 100644 --- a/spec/terms-definitions/abbrev.md +++ b/spec/terms-definitions/abbrev.md @@ -2,4 +2,4 @@ ~ a shorthand in capitals for a [[ref: term]]. It may contain special characters. It may not contain spaces. -~ Criterium for not being an abbreviation: If the word is not in uppercase, in our context the word is more likely to be an [[ref: alias]] for the term. +~ Criterion for not being an abbreviation: If the word is not in uppercase, in our context the word is more likely to be an [[ref: alias]] for the term. diff --git a/spec/terms-definitions/alias.md b/spec/terms-definitions/alias.md index 298d95d..7ff4bde 100644 --- a/spec/terms-definitions/alias.md +++ b/spec/terms-definitions/alias.md @@ -16,4 +16,4 @@ ~ *Mind you: the most applicable abbreviation should be in [[ref:abbrev]].* -~ Criterium: an alias | TBW | +~ Criterion: an alias | TBW | diff --git a/spec/terms-definitions/guide.md b/spec/terms-definitions/guide.md index 0af9a46..9b1c700 100644 --- a/spec/terms-definitions/guide.md +++ b/spec/terms-definitions/guide.md @@ -1,5 +1,5 @@ [[def: Guide, guide, guidelines]] -~ ~ What is the criterium something being a Guide versus a Specification? +~ What is the criterion something being a Guide versus a Specification? -~ A Specification has enough [[ref: normative]] statements to be directly implementatable. +~ A Specification has enough [[ref: normative]] statements to be directly implementable. diff --git a/spec/terms-definitions/normative.md b/spec/terms-definitions/normative.md index b3dd4a2..1614917 100644 --- a/spec/terms-definitions/normative.md +++ b/spec/terms-definitions/normative.md @@ -1,5 +1,3 @@ [[def: normative]] -~ ~ - -~ A theory is “normative” if it, in some sense, tells you what you should do - what action you should take.Also see [KERISSE](https://weboftrust.github.io/WOT-terms/docs/glossary-unified?level=2#normative) +~ A theory is “normative” if it, in some sense, tells you what you should do - what action you should take.Also see [KERISSE](https://weboftrust.github.io/WOT-terms/docs/glossary-unified?level=2#normative), and [[xref: toip, normative]] diff --git a/spec/terms-definitions/term.md b/spec/terms-definitions/term.md index 6f709db..3fa44b9 100644 --- a/spec/terms-definitions/term.md +++ b/spec/terms-definitions/term.md @@ -1,9 +1,9 @@ [[def: term]] -~ The ToIP notation of a terminology item, that requires a definiton, that could have an abbreviation and zero or more aliasses. A term is supposed to be uniquely defined in a certain scope, but can have many exactly the same instances in a broader community. +~ The ToIP notation of a terminology item, that requires a definition, that could have an abbreviation and zero or more aliases. A term is supposed to be uniquely defined in a certain scope, but can have many exactly the same instances in a broader community. ~ The term also serves as a key in the source management tool of ToIP terminology sources and to make a comparison among terms. -~ Criterium: only if a certain word or [[ref: phrase]] in ToIP notation and first placed in the definition tag, then it's a term in the scope of this [[ref: guide]]. Only a term can have just one [[ref:abbreviation]]. +~ Criterion: only if a certain word or [[ref: phrase]] in ToIP notation and first placed in the definition tag, then it's a term in the scope of this [[ref: guide]]. Only a term can have just one [[ref:abbreviation]]. ~ Also see [term](https://weboftrust.github.io/WOT-terms/docs/glossary-unified?level=2#term). diff --git a/specs.json b/specs.json index 8ca924a..8a97848 100644 --- a/specs.json +++ b/specs.json @@ -35,7 +35,7 @@ }, "external_specs": [ { - "test-1": "https://blockchainbird.github.io/spec-up-xref-test-1/" + "toip": "https://blockchainbird.github.io/spec-up-xref-test-1/" }, { "test-2": "https://blockchainbird.github.io/spec-up-xref-test-2/" @@ -43,8 +43,8 @@ ], "external_specs_repos": [ { - "external_spec": "test-1", - "url": "https://github.com/blockchainbird/spec-up-xref-test-1", + "external_spec": "toip", + "url": "https://github.com/trustoverip/ctwg-main-glossary/", "terms_dir": "spec/term-definitions" }, {