Skip to content

Commit

Permalink
generated template ctexts
Browse files Browse the repository at this point in the history
Signed-off-by: Rieks <RieksJ@users.noreply.github.com>
  • Loading branch information
RieksJ committed Jul 23, 2023
1 parent 4260363 commit 9936307
Show file tree
Hide file tree
Showing 58 changed files with 2,067 additions and 0 deletions.
35 changes: 35 additions & 0 deletions docs/tev2/terms/_author.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_body.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_concept-file.md
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.
:::
47 changes: 47 additions & 0 deletions docs/tev2/terms/_concept.md
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.
35 changes: 35 additions & 0 deletions docs/tev2/terms/_conceptualization.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_constraint.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_context.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_contributor.md
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.
:::
35 changes: 35 additions & 0 deletions docs/tev2/terms/_controlled.md
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.
:::
39 changes: 39 additions & 0 deletions docs/tev2/terms/_corpus.md
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)
Loading

0 comments on commit 9936307

Please sign in to comment.