-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Rieks <RieksJ@users.noreply.github.com>
- Loading branch information
Showing
58 changed files
with
2,067 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: author | ||
# TEv2 Curated Text Header | ||
term: author | ||
termType: concept | ||
isa: | ||
glossaryTerm: Author | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: author{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Author | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: body | ||
# TEv2 Curated Text Header | ||
term: body | ||
termType: concept | ||
isa: | ||
glossaryTerm: Body | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: bod{yies} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Body | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: concept-file | ||
# TEv2 Curated Text Header | ||
term: concept-file | ||
termType: concept | ||
isa: | ||
glossaryTerm: Concept File | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: concept-file{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Concept File | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,47 @@ | ||
---# TEv2 Curated Text Header | ||
term: concept | ||
termType: concept | ||
isa: knowledge-artifact | ||
glossaryTerm: | ||
glossaryText: "a [knowledge artifact](@) that captures the ideas/thoughts behind a classification of [entities](@) (what makes [entities](@) in that class 'the same')." | ||
synonymOf: | ||
grouptags: | ||
formPhrases: concept{ss} | ||
# Curation status | ||
status: proposed | ||
created: 2022-06-06 | ||
updated: 2022-06-06 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[eSSIF-Lab](https://essif-lab.github.io/framework)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
formPhrases: concept{ss}--- | ||
|
||
# Concept | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
A **Concept** is a [knowledge artifact](@) that tries to capture the idea behind a classification of entities[^1], allowing us to reason about everything in the class as if it were one thing. For example, the ideas ([mental representations](https://en.wikipedia.org/wiki/Mental_representation)) you have when processing the sentences "I can drink beer from a beer glass' and 'I can drink beer from a coffee mug' shows that the concepts that are behind 'beer glass' and 'coffee mug' differ. Note that in order to communicate about this idea, we also need a word or phrase (i.e.: a [term](@)[^2] that we can use to refer to (instances of) this idea). | ||
|
||
[^1]: WikiPedia has a concise [explanation of concepts](https://en.wikipedia.org/wiki/Concept). We use the term 'concept' as a [mental representation](https://en.wikipedia.org/wiki/Mental_representation). | ||
|
||
[^2]: For the difference between 'Concept' and 'Term', see https://simple.wikipedia.org/wiki/Concept. | ||
|
||
The [terminology pattern](pattern-terminology@) provides an overview of how this concept fits in with related concepts (as a specialization of a [knowledge artifact](@)). | ||
|
||
### Purpose | ||
Working together is easier when you and your peers share the same ideas. We need a way to test and ensure, that you and your peers _actually_ have the same understanding, for the purpose of making cooperation easier. Doing so is expected to not only reduce the number of terminological discussions, but also improve the efficiency and effectiveness of the remaining discussions. | ||
|
||
### Criteria | ||
A (description/specification of a) Concept MUST be [intensionally defined](https://en.wikipedia.org/wiki/Extensional_and_intensional_definitions), i.e. associated with a criterion that can be used to determine whether or not someone or something qualifies as (an instance of) that Concept, and that has the property that it has been shown that the vast majority of contributors and other users apply it in the same manner in different situations (i.e. they arrive at the same conclusion as to whether or not someone or something qualifies under that criterion in any given situation). | ||
|
||
### Notes | ||
There is an important [distinction between concepts and the (multitude of) terms](https://simple.wikipedia.org/wiki/Concept) (names, labels) that we need to be able to talk and reason (argue) about them. Please consider that | ||
|
||
* different terms are used in different contexts for the same concept | ||
* in different contexts, a single term may refer to different concepts | ||
* to resolve terminological disputes, which usually are about the 'correct' meaning of a term, try to establish the criteria that the different participants use for the concept behind the term. That helps participants understand each others (different) positions, and provides a better basis for resolving the conflict. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: conceptualization | ||
# TEv2 Curated Text Header | ||
term: conceptualization | ||
termType: concept | ||
isa: | ||
glossaryTerm: Conceptualization | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: conceptualization{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Conceptualization | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: constraint | ||
# TEv2 Curated Text Header | ||
term: constraint | ||
termType: concept | ||
isa: | ||
glossaryTerm: Constraint | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: constraint{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Constraint | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: context | ||
# TEv2 Curated Text Header | ||
term: context | ||
termType: concept | ||
isa: | ||
glossaryTerm: Context | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: context{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Context | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: contributor | ||
# TEv2 Curated Text Header | ||
term: contributor | ||
termType: concept | ||
isa: | ||
glossaryTerm: Contributor | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: contributor{ss} | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Contributor | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
# Docusaurus header | ||
id: controlled | ||
# TEv2 Curated Text Header | ||
term: controlled | ||
termType: concept | ||
isa: | ||
glossaryTerm: Controlled | ||
glossaryText: "glossary-text for '{original}'." | ||
hoverText: "hover-text for '{original}'." | ||
synonymOf: nan | ||
grouptags: | ||
formPhrases: nan | ||
# Curation status | ||
status: proposed | ||
created: 20230723 | ||
updated: 20230723 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs/tev2)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
--- | ||
|
||
# Controlled | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
### Summary | ||
|
||
:::info Editor's Note | ||
This file has been automatically created; it's header needs to be revised and its contents needs to be properly written. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
---# TEv2 Curated Text Header | ||
term: corpus | ||
termType: concept | ||
isa: | ||
glossaryTerm: | ||
glossaryText: "the documentation that describes the [knowledge](@) around a set of [terms](@) and [concepts](@)." | ||
synonymOf: | ||
grouptags: | ||
formPhrases: corpus, corpora, corpus-of-terminology | ||
# Curation status | ||
status: proposed | ||
created: 2022-06-06 | ||
updated: 2022-06-06 | ||
# Origins/Acknowledgements | ||
contributors: RieksJ | ||
attribution: "[eSSIF-Lab](https://essif-lab.github.io/framework)" | ||
originalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)" | ||
formPhrases: terminology-corpus, corpora, terminology-corpora--- | ||
|
||
# Corpus | ||
|
||
:::caution | ||
The entire section on Terminology Engine v 2 (TEv2) is still under construction.<br/> | ||
As TEv2 is not (yet) available, the texts that specify the tool are still 'raw', i.e. not yet processed.<br/>[readers](@) will need to see through some (currently unprocessed) notational conventions. | ||
::: | ||
|
||
## Short Description | ||
The **Corpus** or **Corpus of Terminology** is the documentation that describes the [knowledge](@) around a set of [terms](@) and [concepts](@). It is typically governed by conventions that are specified by a group of [terms communities](@), such as [TOIP's Concepts and Terminology Working Group](https://wiki.trustoverip.org/pages/viewpage.action?pageId=65700). | ||
|
||
The [terminology pattern](pattern-terminology@) relates this concept with other terminological [concepts](@). | ||
|
||
## Purpose | ||
The purpose of having a [corpus](@) is that it allows for the development of tools that support [authors](@) and groups of people to better communicate, by enabling them to refer to the [definition](@) of a [term](@) whenever that [term](@) is used. This is particularly beneficial when a specific [term](@) can be interpreted in different ways (according to different [definitions](@)). | ||
|
||
Tools that we envisage will query for [terms](@) from the [corpus](@), and use that e.g. to create a custom [glossary](@) document, a [terminology](@) appendix in a paper you write, or as a resource from which you generate pop-up balloons in a website you create. | ||
|
||
## Acknowledgements | ||
|
||
Part of the description is taken from [TOIP CTWG](https://github.com/trustoverip/ctwg/wiki//corpus) |
Oops, something went wrong.