template-3-concept-file.mdx 3.41 KB
Newer Older
1
2
3
4
import Term from '../src/components/Term'

---
id: concept-<ExistingScope>-<NewConcept>
Rieks Joosten's avatar
Rieks Joosten committed
5
title: Concept: <NewConcept> (Scope: <ExistingScope>)
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
---
<!--A %%concept%% tries to capture the idea behind a classification of %%entities:entity%%, allowing us to reason about everything in the class as if it were one thing. This file specifies the idea(s) that, within the scope of `<ExistingScope>` will be referred to using the %%term%% `<NewConcept>`.
Before completing this template, please change every instance of 
- `<ExistingScope>` into a text that refers to the %%scope%% within which the %%concept%% is to be defiend;
- `<NewConcept>` into the %%term%% that will be used within `<ExistingScope>` to refer to that %%concept%%.
Then, provide contents for the sections as you wish. You MUST provide contents for the sections 'Scope' and 'Criteria'-->

## Scope
<!--REQUIRED--Short text (label, abbreviation) used to refer to the %%scope%% within which the %%concept%% is defined. The default is essifLab.-->
essifLab

## One-line Summary
<!--A single sentence that describe the %%concept%% to a layperson with reasonable accuracy. This line may be used to explain `Concept` in a glossary, or as a popover text when it is referred to in other documentation.-->

## Short Description
<!--REQUIRED--in 1-3 sentences that describe the %%concept%% to a layperson with reasonable accuracy.-->

## Purpose
<!--Describe why the %%concept%% is needed. What purposes does it serve? What can you do with it that you cannot do (as well) without it? What objectives does it help realize? Why is this %%concept%% relevant within its %%scope%% of definition?-->

## Criteria
<!--REQUIRED--How is this %%concept%% different from related ideas? What are essential characteristics that must be true? This is where you specify the [intensional definition](https://en.wikipedia.org/wiki/Extensional_and_intensional_definitions) of the %%concept%%, i.e. the necessary and sufficient conditions for when the term should be used. This makes that the %%concept%% becomes crystal clear. In the case of nouns, this is equivalent to specifying the properties that an object needs to have in order to be counted as a referent of the term.-->

## Examples
<!--Provide a few sentences in which you give examples that obviously qualify as instances of `<NewConcept>`, and that do NOT obviously qualify. Also, provide examples that are not (so) obvious, but help users to better understand its intension.-->

## Related Concepts
<!--Link to any %%concepts:concept%% that are similar but distinct, with a note about the relationship.-->

## Domains
<!--In which general knowledge ecosystems or mental model families does this %%concept%% play a role?-->

## Tags
<!--Add hash tags here that allow us to group concepts in useful ways.-->

## Use-cases
<!--This (optional) section specifies an (optional) introductory paragraph, and a level-3 (i.e. `###`) subsection for every use case it describes. Every such use-case SHOULD
- describe the situation/context of the use-case;
- show how to apply `<NewConcept>` to/in that situation;
- shows the relevance of having `<NewConcept>` for the use-case as opposed to not having it.-->

## Notes
<!--This (optional) section is the place to put anything for which there is no other good place to put it.-->

<!--
---
## Footnotes

[//]: # This (optional) section contains any footnotes that may have been specified in the text above.

[^1]: the text for footnote [^1] goes here.

-->