From 3eccd4c187429ead72c147f39c431ebcf9e8ae91 Mon Sep 17 00:00:00 2001 From: RieksJ Date: Mon, 1 Apr 2024 09:28:36 +0000 Subject: [PATCH] deploy: 9b955393cda95b1456b1c25d0a9a26433ea883f4 --- 404.html | 4 ++-- assets/js/{021ecb5a.121f38b0.js => 021ecb5a.a7969fd5.js} | 2 +- assets/js/{03b39aaa.31c9fc99.js => 03b39aaa.e638db87.js} | 2 +- assets/js/{041f13b2.4ca14422.js => 041f13b2.1770777a.js} | 2 +- assets/js/{042aab58.881ad9e7.js => 042aab58.e8b29007.js} | 2 +- assets/js/{073edd59.7b803a37.js => 073edd59.9b239b69.js} | 2 +- assets/js/{07990011.e6ded4ee.js => 07990011.e1b1648a.js} | 2 +- assets/js/{07ce2141.5636b8f5.js => 07ce2141.3d933862.js} | 2 +- assets/js/{0bee8f31.3d540308.js => 0bee8f31.00ae7519.js} | 2 +- assets/js/0c0fc45c.0c67dc66.js | 1 + assets/js/0c0fc45c.f86ca1ed.js | 1 - assets/js/{0cdee2ba.7978344f.js => 0cdee2ba.f6fd2d51.js} | 2 +- assets/js/{0fbf73e8.02a17bf7.js => 0fbf73e8.be1f5572.js} | 2 +- assets/js/{0ff14827.6d184dcd.js => 0ff14827.a1867dff.js} | 2 +- assets/js/{1025d2dd.d3adf1b9.js => 1025d2dd.2b27ebf5.js} | 2 +- assets/js/{1437a887.fc4c8ff5.js => 1437a887.b0915ef3.js} | 2 +- assets/js/{1455ff6c.4d564629.js => 1455ff6c.98da7e6e.js} | 2 +- assets/js/{156e271d.b12d1542.js => 156e271d.ba3652dc.js} | 2 +- assets/js/{17aedecb.7db18364.js => 17aedecb.0dfac046.js} | 2 +- assets/js/{1d857b0c.223e3f35.js => 1d857b0c.b8795f51.js} | 2 +- assets/js/{1ebbe01d.ce6c1b90.js => 1ebbe01d.dcf22545.js} | 2 +- assets/js/{1fbf49b1.83e4aead.js => 1fbf49b1.dcd59120.js} | 2 +- assets/js/{21420f13.29e7a7e2.js => 21420f13.6a3eb7b4.js} | 2 +- assets/js/{23374ca6.46a14837.js => 23374ca6.5cf7ece5.js} | 2 +- assets/js/{233866fe.7b200852.js => 233866fe.e5a4c533.js} | 2 +- assets/js/{2a3b95f3.12b9fc66.js => 2a3b95f3.40fcd5b7.js} | 2 +- assets/js/{2f0ec223.276d808e.js => 2f0ec223.eeb45238.js} | 2 +- assets/js/{2ff88f8b.f001c824.js => 2ff88f8b.d9d1a512.js} | 2 +- assets/js/{32836bf1.a0968033.js => 32836bf1.7ae6cb59.js} | 2 +- assets/js/{358bfd91.1f9dfaa7.js => 358bfd91.9de08b05.js} | 2 +- assets/js/{361f2510.99d3af36.js => 361f2510.3b071128.js} | 2 +- assets/js/{3723a308.0fa7d01a.js => 3723a308.c13c371e.js} | 2 +- assets/js/{37bf8d6e.5e041a09.js => 37bf8d6e.4faa2b09.js} | 2 +- assets/js/{3a41d33b.f248a35d.js => 3a41d33b.0adcab32.js} | 2 +- assets/js/{3c160063.ede6db0e.js => 3c160063.577d1f8f.js} | 2 +- assets/js/{41daa8b4.355738cc.js => 41daa8b4.89a887d6.js} | 2 +- assets/js/{43f125f7.2ad2e8d6.js => 43f125f7.aa73321a.js} | 2 +- assets/js/{4832e89f.e66a3451.js => 4832e89f.c8f58aad.js} | 2 +- assets/js/{48eddb86.3f4a9239.js => 48eddb86.36c555d6.js} | 2 +- assets/js/{49f969b0.86f05bb3.js => 49f969b0.42567dd7.js} | 2 +- assets/js/{4a325adb.316ea1c7.js => 4a325adb.2d4273c6.js} | 2 +- assets/js/{4cd795c8.295daa9c.js => 4cd795c8.ca08eaf2.js} | 2 +- assets/js/{4e095fca.beef019a.js => 4e095fca.3b183cf0.js} | 2 +- assets/js/{4f2db7e1.bb55741d.js => 4f2db7e1.dc637d1d.js} | 2 +- assets/js/{5003321a.7987e129.js => 5003321a.1553bb54.js} | 2 +- assets/js/{5049cc12.4df7985c.js => 5049cc12.56107c43.js} | 2 +- assets/js/{5395b836.3e1baa53.js => 5395b836.052bfdc2.js} | 2 +- assets/js/{56c5a385.9e5ce3ea.js => 56c5a385.031b75d9.js} | 2 +- assets/js/{573e4296.914cc493.js => 573e4296.7a0b7671.js} | 2 +- assets/js/{59f1a610.4b2c4706.js => 59f1a610.5e901275.js} | 2 +- assets/js/{5a2bb67b.6f8bb325.js => 5a2bb67b.8e293003.js} | 2 +- assets/js/{5dc77d7a.2a67a85e.js => 5dc77d7a.22152886.js} | 2 +- assets/js/{5ea46faf.d932d671.js => 5ea46faf.d5ac5da9.js} | 2 +- assets/js/{5f28d73f.039a61f5.js => 5f28d73f.d3f95027.js} | 2 +- assets/js/{6044cad1.2a79a4e6.js => 6044cad1.2bf3b876.js} | 2 +- assets/js/{65f59a55.9502c7df.js => 65f59a55.8f6b4f1d.js} | 2 +- assets/js/{67283e50.21621b71.js => 67283e50.e3f33abc.js} | 2 +- assets/js/{67d70933.9dec27e7.js => 67d70933.dd17a66b.js} | 2 +- assets/js/{6b3de583.8d495837.js => 6b3de583.d16bf757.js} | 2 +- assets/js/{6db347e8.17cc4822.js => 6db347e8.7f0c62e1.js} | 2 +- assets/js/{6f1c0af3.a6e38350.js => 6f1c0af3.cb34cb18.js} | 2 +- assets/js/{73053340.761a9795.js => 73053340.c858742c.js} | 2 +- assets/js/{735a4e9a.a1e081f7.js => 735a4e9a.9e8df7c3.js} | 2 +- assets/js/{7567abf2.a949a786.js => 7567abf2.2253ddcf.js} | 2 +- assets/js/{75cbb1e6.6d97aa12.js => 75cbb1e6.fc69d21d.js} | 2 +- assets/js/{79495b8c.47e418f9.js => 79495b8c.9dd0d9bb.js} | 2 +- assets/js/{7a6142bc.90c5eeac.js => 7a6142bc.9b7a7d5d.js} | 2 +- assets/js/{7e8f2ce0.b83a2592.js => 7e8f2ce0.10c1ae2f.js} | 2 +- assets/js/{8341015d.b28d4577.js => 8341015d.29079251.js} | 2 +- assets/js/{83d6452b.82226286.js => 83d6452b.6ad95a66.js} | 2 +- assets/js/{859087a1.afd8be37.js => 859087a1.48ac9743.js} | 2 +- assets/js/{85bdfa30.cd3ef5ac.js => 85bdfa30.69514acf.js} | 2 +- assets/js/{8602ac2f.3fe4f150.js => 8602ac2f.d4e6c203.js} | 2 +- assets/js/{8677fb48.21e7c562.js => 8677fb48.e37eb99b.js} | 2 +- assets/js/{8c68bf8b.104b7f46.js => 8c68bf8b.067b2d64.js} | 2 +- assets/js/{8cadb544.09fa420b.js => 8cadb544.e62ba719.js} | 2 +- assets/js/{8d01272a.40311105.js => 8d01272a.fa642db6.js} | 2 +- assets/js/{8f890ba0.58e3548a.js => 8f890ba0.eef5dc80.js} | 2 +- assets/js/{8fb8d401.d8254558.js => 8fb8d401.884facd1.js} | 2 +- assets/js/{9136c9f6.5f94eab8.js => 9136c9f6.0dd240ae.js} | 2 +- assets/js/{93102254.2ca66a95.js => 93102254.889ecc8c.js} | 2 +- assets/js/{9493c8af.ece90dd8.js => 9493c8af.a0098124.js} | 2 +- assets/js/{95d39ac8.3de0adee.js => 95d39ac8.e4239475.js} | 2 +- assets/js/{9844819e.6763f5f9.js => 9844819e.8c41bac6.js} | 2 +- assets/js/{9956d717.6d9b6f88.js => 9956d717.77e2b68c.js} | 2 +- assets/js/{9976dba8.bfd993ab.js => 9976dba8.7c484a11.js} | 2 +- assets/js/{9a3eaf08.a393d250.js => 9a3eaf08.e70cda88.js} | 2 +- assets/js/{9c3f4df8.dd595aef.js => 9c3f4df8.7ed6a041.js} | 2 +- assets/js/{9ee044af.819461b1.js => 9ee044af.047748cc.js} | 2 +- assets/js/{9f5dc2b0.6e815067.js => 9f5dc2b0.241533e9.js} | 2 +- assets/js/{a11550d3.e42f0cc9.js => a11550d3.82477aaf.js} | 2 +- assets/js/{a69d64d2.faef3cd4.js => a69d64d2.dbe9a342.js} | 2 +- assets/js/{a7c030b4.41593a1d.js => a7c030b4.177a8d2e.js} | 2 +- assets/js/{a8ce4b3e.9529e98f.js => a8ce4b3e.fb045df6.js} | 2 +- assets/js/{a8ffcef1.3c5973e3.js => a8ffcef1.06e33a6d.js} | 2 +- assets/js/{a976b482.e24f7183.js => a976b482.c6394592.js} | 2 +- assets/js/{aa7dbb4e.323418ef.js => aa7dbb4e.2b349628.js} | 2 +- assets/js/{ac002e07.9095b307.js => ac002e07.63977048.js} | 2 +- assets/js/{ade4df9f.d0afef8e.js => ade4df9f.ce509191.js} | 2 +- assets/js/{ade96904.78329285.js => ade96904.97417749.js} | 2 +- assets/js/{afb8980b.05599609.js => afb8980b.0acf9128.js} | 2 +- assets/js/{b0474474.b285128e.js => b0474474.f58ec732.js} | 2 +- assets/js/{b3defa12.6e14f923.js => b3defa12.a6cbf2cf.js} | 2 +- assets/js/{b5976878.c6d24dd2.js => b5976878.27afdc01.js} | 2 +- assets/js/{b916b40f.b1c1621e.js => b916b40f.436d3922.js} | 2 +- assets/js/{b98952f9.19b7acc9.js => b98952f9.d225c518.js} | 2 +- assets/js/{b9e2db8f.697257d2.js => b9e2db8f.e63539b2.js} | 2 +- assets/js/{bb7c9df2.b348fbaf.js => bb7c9df2.40eab300.js} | 2 +- assets/js/{bcb93ad0.51b7829a.js => bcb93ad0.e194b17b.js} | 2 +- assets/js/{be5e65fb.c09311cb.js => be5e65fb.21248ee8.js} | 2 +- assets/js/{bf59d308.e6b2631e.js => bf59d308.601152b4.js} | 2 +- assets/js/{bff975ac.7348f985.js => bff975ac.70368c5c.js} | 2 +- assets/js/{c0bb789b.86b779e0.js => c0bb789b.02c07030.js} | 2 +- assets/js/{c3085379.3fb0a964.js => c3085379.ed110dbb.js} | 2 +- assets/js/{c3416a9b.090a2b41.js => c3416a9b.ebbfbdd8.js} | 2 +- assets/js/{c355543d.76aa4bb3.js => c355543d.9e9dd212.js} | 2 +- assets/js/{c4494d6d.08a9751c.js => c4494d6d.0a1899ac.js} | 2 +- assets/js/{c455830f.0d0e46eb.js => c455830f.bdb4774d.js} | 2 +- assets/js/{c4b5710d.1f0dbf9d.js => c4b5710d.4a844b58.js} | 2 +- assets/js/{c5a98701.abbaa487.js => c5a98701.a1c3e653.js} | 2 +- assets/js/{c5f202a2.d43c6527.js => c5f202a2.3c88fa9a.js} | 2 +- assets/js/{c8fbbf4e.1c6d52ec.js => c8fbbf4e.b5cd0319.js} | 2 +- assets/js/{cf9aab87.a7cf9dc2.js => cf9aab87.7ed42051.js} | 2 +- assets/js/{cfcdc3ca.76a2f0d0.js => cfcdc3ca.04a2c1e5.js} | 2 +- assets/js/{d117691e.fa7275b3.js => d117691e.d7e38ceb.js} | 2 +- assets/js/{d1ce265f.a9d8670f.js => d1ce265f.8c577c55.js} | 2 +- assets/js/{d1e6fc8b.723a4b87.js => d1e6fc8b.a9f461eb.js} | 2 +- assets/js/{d40fa606.27b0cc6a.js => d40fa606.c243b689.js} | 2 +- assets/js/{d529df3a.c45474d6.js => d529df3a.07f5de3e.js} | 2 +- assets/js/{d71eb2ae.4ab9db0c.js => d71eb2ae.d9573e14.js} | 2 +- assets/js/{d9735dd1.939398fb.js => d9735dd1.8188117b.js} | 2 +- assets/js/{d99d06d7.f961b430.js => d99d06d7.eb8356e0.js} | 2 +- assets/js/{dd763692.ce2ab017.js => dd763692.0ef98c4e.js} | 2 +- assets/js/{de8bc3ad.135e8b27.js => de8bc3ad.c1e2d24f.js} | 2 +- assets/js/{e129cf3c.6f52f945.js => e129cf3c.17130891.js} | 2 +- assets/js/{e203f18e.6e2f4ad6.js => e203f18e.1a085a15.js} | 2 +- assets/js/{e3cbe702.792fc998.js => e3cbe702.72c125f4.js} | 2 +- assets/js/{e58d15ee.c497916f.js => e58d15ee.44f04799.js} | 2 +- assets/js/{e6a4b882.2ec4bf30.js => e6a4b882.806b9903.js} | 2 +- assets/js/{e6fe19ee.153b1100.js => e6fe19ee.e987fc1a.js} | 2 +- assets/js/{e768272c.1f0510ad.js => e768272c.3affe9de.js} | 2 +- assets/js/{e963bf71.7f3a53a5.js => e963bf71.1b15f4d3.js} | 2 +- assets/js/{ed448e8d.697b54f8.js => ed448e8d.7ed5df11.js} | 2 +- assets/js/{ed4d88b7.55e0497f.js => ed4d88b7.37f8e6a5.js} | 2 +- assets/js/{efbcea9d.3423dd0d.js => efbcea9d.cfb72f4a.js} | 2 +- assets/js/{f12ace1d.32f18b64.js => f12ace1d.af42c4a3.js} | 2 +- assets/js/{f24909cd.1ba4d9b5.js => f24909cd.943b6d6d.js} | 2 +- assets/js/{f37d4412.557b5c32.js => f37d4412.32797a75.js} | 2 +- assets/js/{f512b02d.af27503f.js => f512b02d.de18ba95.js} | 2 +- assets/js/{f5824b3c.fc903ac8.js => f5824b3c.49d4dc5c.js} | 2 +- assets/js/{fb5ac514.a94ad8af.js => fb5ac514.6427de3e.js} | 2 +- assets/js/{fbb7f9e6.af7ff308.js => fbb7f9e6.1b20e4df.js} | 2 +- assets/js/{fbdbb09f.2dc98abe.js => fbdbb09f.01cfe4ce.js} | 2 +- assets/js/{fd7be43f.2534f4bf.js => fd7be43f.1342f066.js} | 2 +- assets/js/{feb0a068.f00a40a7.js => feb0a068.bea1ee0e.js} | 2 +- .../{runtime~main.d5d143c0.js => runtime~main.a40ed38d.js} | 2 +- docs/categories/faqs/index.html | 6 +++--- docs/categories/guides/index.html | 6 +++--- docs/categories/manuals-author/index.html | 6 +++--- docs/categories/manuals-contributor/index.html | 6 +++--- docs/categories/manuals-curator/index.html | 6 +++--- docs/categories/manuals/index.html | 6 +++--- docs/categories/miscellaneous/index.html | 6 +++--- docs/categories/overview/index.html | 6 +++--- docs/categories/specs-files/index.html | 6 +++--- docs/categories/specs-syntax/index.html | 6 +++--- docs/categories/specs-tools-envisaged/index.html | 6 +++--- docs/categories/specs-tools/index.html | 6 +++--- docs/categories/specs/index.html | 6 +++--- docs/faqs/fixing-links/index.html | 6 +++--- docs/guides/documenting-terms/index.html | 6 +++--- docs/guides/preparation-git/index.html | 6 +++--- docs/guides/using-terms/index.html | 6 +++--- docs/index.html | 6 +++--- docs/manuals/author/author-overview/index.html | 6 +++--- docs/manuals/contributor/contributor-overview/index.html | 6 +++--- docs/manuals/contributor/contributors-LaTeX/index.html | 6 +++--- docs/manuals/contributor/contributors-repo/index.html | 6 +++--- docs/manuals/contributor/contributors-wiki/index.html | 6 +++--- docs/manuals/curator/curator-overview/index.html | 6 +++--- docs/manuals/curator/terminology-construction/index.html | 6 +++--- docs/manuals/curator/tev2-installation/index.html | 6 +++--- docs/miscellaneous/making-hovertexts-work/index.html | 6 +++--- docs/miscellaneous/notations-and-conventions/index.html | 6 +++--- docs/miscellaneous/tool-development/index.html | 6 +++--- docs/overview/tev2-architecture/index.html | 6 +++--- docs/overview/tev2-background/index.html | 6 +++--- docs/overview/tev2-common-understanding/index.html | 6 +++--- docs/overview/tev2-purpose/index.html | 6 +++--- docs/overview/tev2-requirements/index.html | 6 +++--- docs/overview/tev2-terminology-curation/index.html | 6 +++--- docs/overview/tev2-text-conversion/index.html | 6 +++--- docs/specs/files/body-file/index.html | 6 +++--- docs/specs/files/configuration-file/index.html | 6 +++--- docs/specs/files/curated-text-file/index.html | 6 +++--- docs/specs/files/mrd/index.html | 6 +++--- docs/specs/files/mrg/index.html | 6 +++--- docs/specs/files/saf/index.html | 6 +++--- docs/specs/syntax/handlebars-helper-functions/index.html | 6 +++--- docs/specs/syntax/mrg-refs/index.html | 6 +++--- docs/specs/syntax/term-identifiers/index.html | 6 +++--- docs/specs/syntax/term-refs/index.html | 6 +++--- docs/specs/syntax/term-selection/index.html | 6 +++--- docs/specs/syntax/terminology-identifiers/index.html | 6 +++--- docs/specs/tools-envisaged/hrdt/index.html | 6 +++--- docs/specs/tools-envisaged/ict/index.html | 6 +++--- docs/specs/tools-envisaged/mrdt/index.html | 6 +++--- docs/specs/tools-envisaged/termref-selector/index.html | 6 +++--- docs/specs/tools/hrgt/index.html | 6 +++--- docs/specs/tools/mrg-import/index.html | 6 +++--- docs/specs/tools/mrgt/index.html | 6 +++--- docs/specs/tools/trrt/index.html | 6 +++--- docs/terms/@/index.html | 6 +++--- docs/terms/author/index.html | 6 +++--- docs/terms/body-file/index.html | 6 +++--- docs/terms/body/index.html | 6 +++--- docs/terms/concept/index.html | 6 +++--- docs/terms/conceptualization/index.html | 6 +++--- docs/terms/converter-profile/index.html | 6 +++--- docs/terms/converter/index.html | 6 +++--- docs/terms/corpus/index.html | 6 +++--- docs/terms/curate/index.html | 6 +++--- docs/terms/curated-file/index.html | 6 +++--- docs/terms/curated-text-file/index.html | 6 +++--- docs/terms/curated-text/index.html | 6 +++--- docs/terms/curatedir/index.html | 6 +++--- docs/terms/curator/index.html | 6 +++--- docs/terms/current-scope/index.html | 6 +++--- docs/terms/define/index.html | 6 +++--- docs/terms/definition/index.html | 6 +++--- docs/terms/dictionary/index.html | 6 +++--- docs/terms/form-phrase-macro-map/index.html | 6 +++--- docs/terms/form-phrase-macro/index.html | 6 +++--- docs/terms/form-phrase/index.html | 6 +++--- docs/terms/formatted-text/index.html | 6 +++--- docs/terms/front-matter/index.html | 6 +++--- docs/terms/glossary/index.html | 6 +++--- docs/terms/glossarydir/index.html | 6 +++--- docs/terms/glossaryterm/index.html | 6 +++--- docs/terms/glossarytext/index.html | 6 +++--- docs/terms/grouptag/index.html | 6 +++--- docs/terms/handlebars-helper-function/index.html | 6 +++--- docs/terms/handlebars-object/index.html | 6 +++--- docs/terms/handlebars-template/index.html | 6 +++--- docs/terms/header/index.html | 6 +++--- docs/terms/hrd/index.html | 6 +++--- docs/terms/hrdt/index.html | 6 +++--- docs/terms/hrg-entry/index.html | 6 +++--- docs/terms/hrg-list/index.html | 6 +++--- docs/terms/hrg/index.html | 6 +++--- docs/terms/hrgt/index.html | 6 +++--- docs/terms/ict/index.html | 6 +++--- docs/terms/ingestion-profile/index.html | 6 +++--- docs/terms/ingestion/index.html | 6 +++--- docs/terms/interpreter-profile/index.html | 6 +++--- docs/terms/interpreter/index.html | 6 +++--- docs/terms/mental-model/index.html | 6 +++--- docs/terms/moustache-variable/index.html | 6 +++--- docs/terms/mrd/index.html | 6 +++--- docs/terms/mrdt/index.html | 6 +++--- docs/terms/mrg-entry/index.html | 6 +++--- docs/terms/mrg-import/index.html | 6 +++--- docs/terms/mrg-ref/index.html | 6 +++--- docs/terms/mrg/index.html | 6 +++--- docs/terms/mrgt/index.html | 6 +++--- docs/terms/named-capturing-group/index.html | 6 +++--- docs/terms/navpath/index.html | 6 +++--- docs/terms/patterns/definition/index.html | 6 +++--- docs/terms/patterns/terminology/index.html | 6 +++--- docs/terms/property/index.html | 6 +++--- docs/terms/provisional-mrg-entry/index.html | 6 +++--- docs/terms/provisional-mrg/index.html | 6 +++--- docs/terms/reader/index.html | 6 +++--- docs/terms/regex/index.html | 6 +++--- docs/terms/regularized-form-phrase/index.html | 6 +++--- docs/terms/regularized-text/index.html | 6 +++--- docs/terms/relation/index.html | 6 +++--- docs/terms/renderable-ref/index.html | 6 +++--- docs/terms/saf/index.html | 6 +++--- docs/terms/scope/index.html | 6 +++--- docs/terms/scoped-term/index.html | 6 +++--- docs/terms/scopedir/index.html | 6 +++--- docs/terms/scopetag/index.html | 6 +++--- docs/terms/semantic-unit/index.html | 6 +++--- docs/terms/semantics/index.html | 6 +++--- docs/terms/sorter/index.html | 6 +++--- docs/terms/synonym/index.html | 6 +++--- docs/terms/tag/index.html | 6 +++--- docs/terms/term-identifier/index.html | 6 +++--- docs/terms/term-ref/index.html | 6 +++--- docs/terms/term-selection-instruction/index.html | 6 +++--- docs/terms/term-type/index.html | 6 +++--- docs/terms/term/index.html | 6 +++--- docs/terms/termid/index.html | 6 +++--- docs/terms/terminology-identifier/index.html | 6 +++--- docs/terms/terminology-process/index.html | 6 +++--- docs/terms/terminology/index.html | 6 +++--- docs/terms/terms-community/index.html | 6 +++--- docs/terms/tev2-text-conversion-tool/index.html | 6 +++--- docs/terms/tev2-tool/index.html | 6 +++--- docs/terms/tev2-toolbox/index.html | 6 +++--- docs/terms/tev2/index.html | 6 +++--- docs/terms/trrt/index.html | 6 +++--- docs/terms/use-case/index.html | 6 +++--- docs/terms/versiontag/index.html | 6 +++--- docs/terms/vocabulary/index.html | 6 +++--- docs/terms/writer/index.html | 6 +++--- docs/tev2-glossaries-demo/index.html | 6 +++--- docs/tev2-glossary/index.html | 6 +++--- index.html | 4 ++-- 310 files changed, 617 insertions(+), 617 deletions(-) rename assets/js/{021ecb5a.121f38b0.js => 021ecb5a.a7969fd5.js} (99%) rename assets/js/{03b39aaa.31c9fc99.js => 03b39aaa.e638db87.js} (99%) rename assets/js/{041f13b2.4ca14422.js => 041f13b2.1770777a.js} (98%) rename assets/js/{042aab58.881ad9e7.js => 042aab58.e8b29007.js} (99%) rename assets/js/{073edd59.7b803a37.js => 073edd59.9b239b69.js} (99%) rename assets/js/{07990011.e6ded4ee.js => 07990011.e1b1648a.js} (99%) rename assets/js/{07ce2141.5636b8f5.js => 07ce2141.3d933862.js} (98%) rename assets/js/{0bee8f31.3d540308.js => 0bee8f31.00ae7519.js} (98%) create mode 100644 assets/js/0c0fc45c.0c67dc66.js delete mode 100644 assets/js/0c0fc45c.f86ca1ed.js rename assets/js/{0cdee2ba.7978344f.js => 0cdee2ba.f6fd2d51.js} (98%) rename assets/js/{0fbf73e8.02a17bf7.js => 0fbf73e8.be1f5572.js} (99%) rename assets/js/{0ff14827.6d184dcd.js => 0ff14827.a1867dff.js} (98%) rename assets/js/{1025d2dd.d3adf1b9.js => 1025d2dd.2b27ebf5.js} (99%) rename assets/js/{1437a887.fc4c8ff5.js => 1437a887.b0915ef3.js} (99%) rename assets/js/{1455ff6c.4d564629.js => 1455ff6c.98da7e6e.js} (98%) rename assets/js/{156e271d.b12d1542.js => 156e271d.ba3652dc.js} (99%) rename assets/js/{17aedecb.7db18364.js => 17aedecb.0dfac046.js} (99%) rename assets/js/{1d857b0c.223e3f35.js => 1d857b0c.b8795f51.js} (98%) rename assets/js/{1ebbe01d.ce6c1b90.js => 1ebbe01d.dcf22545.js} (99%) rename assets/js/{1fbf49b1.83e4aead.js => 1fbf49b1.dcd59120.js} (99%) rename assets/js/{21420f13.29e7a7e2.js => 21420f13.6a3eb7b4.js} (99%) rename assets/js/{23374ca6.46a14837.js => 23374ca6.5cf7ece5.js} (98%) rename assets/js/{233866fe.7b200852.js => 233866fe.e5a4c533.js} (99%) rename assets/js/{2a3b95f3.12b9fc66.js => 2a3b95f3.40fcd5b7.js} (99%) rename assets/js/{2f0ec223.276d808e.js => 2f0ec223.eeb45238.js} (99%) rename assets/js/{2ff88f8b.f001c824.js => 2ff88f8b.d9d1a512.js} (99%) rename assets/js/{32836bf1.a0968033.js => 32836bf1.7ae6cb59.js} (99%) rename assets/js/{358bfd91.1f9dfaa7.js => 358bfd91.9de08b05.js} (99%) rename assets/js/{361f2510.99d3af36.js => 361f2510.3b071128.js} (98%) rename assets/js/{3723a308.0fa7d01a.js => 3723a308.c13c371e.js} (99%) rename assets/js/{37bf8d6e.5e041a09.js => 37bf8d6e.4faa2b09.js} (99%) rename assets/js/{3a41d33b.f248a35d.js => 3a41d33b.0adcab32.js} (98%) rename assets/js/{3c160063.ede6db0e.js => 3c160063.577d1f8f.js} (99%) rename assets/js/{41daa8b4.355738cc.js => 41daa8b4.89a887d6.js} (98%) rename assets/js/{43f125f7.2ad2e8d6.js => 43f125f7.aa73321a.js} (99%) rename assets/js/{4832e89f.e66a3451.js => 4832e89f.c8f58aad.js} (98%) rename assets/js/{48eddb86.3f4a9239.js => 48eddb86.36c555d6.js} (99%) rename assets/js/{49f969b0.86f05bb3.js => 49f969b0.42567dd7.js} (99%) rename assets/js/{4a325adb.316ea1c7.js => 4a325adb.2d4273c6.js} (99%) rename assets/js/{4cd795c8.295daa9c.js => 4cd795c8.ca08eaf2.js} (99%) rename assets/js/{4e095fca.beef019a.js => 4e095fca.3b183cf0.js} (99%) rename assets/js/{4f2db7e1.bb55741d.js => 4f2db7e1.dc637d1d.js} (98%) rename assets/js/{5003321a.7987e129.js => 5003321a.1553bb54.js} (98%) rename assets/js/{5049cc12.4df7985c.js => 5049cc12.56107c43.js} (99%) rename assets/js/{5395b836.3e1baa53.js => 5395b836.052bfdc2.js} (99%) rename assets/js/{56c5a385.9e5ce3ea.js => 56c5a385.031b75d9.js} (99%) rename assets/js/{573e4296.914cc493.js => 573e4296.7a0b7671.js} (99%) rename assets/js/{59f1a610.4b2c4706.js => 59f1a610.5e901275.js} (99%) rename assets/js/{5a2bb67b.6f8bb325.js => 5a2bb67b.8e293003.js} (99%) rename assets/js/{5dc77d7a.2a67a85e.js => 5dc77d7a.22152886.js} (99%) rename assets/js/{5ea46faf.d932d671.js => 5ea46faf.d5ac5da9.js} (99%) rename assets/js/{5f28d73f.039a61f5.js => 5f28d73f.d3f95027.js} (99%) rename assets/js/{6044cad1.2a79a4e6.js => 6044cad1.2bf3b876.js} (98%) rename assets/js/{65f59a55.9502c7df.js => 65f59a55.8f6b4f1d.js} (99%) rename assets/js/{67283e50.21621b71.js => 67283e50.e3f33abc.js} (98%) rename assets/js/{67d70933.9dec27e7.js => 67d70933.dd17a66b.js} (98%) rename assets/js/{6b3de583.8d495837.js => 6b3de583.d16bf757.js} (99%) rename assets/js/{6db347e8.17cc4822.js => 6db347e8.7f0c62e1.js} (99%) rename assets/js/{6f1c0af3.a6e38350.js => 6f1c0af3.cb34cb18.js} (98%) rename assets/js/{73053340.761a9795.js => 73053340.c858742c.js} (99%) rename assets/js/{735a4e9a.a1e081f7.js => 735a4e9a.9e8df7c3.js} (98%) rename assets/js/{7567abf2.a949a786.js => 7567abf2.2253ddcf.js} (99%) rename assets/js/{75cbb1e6.6d97aa12.js => 75cbb1e6.fc69d21d.js} (99%) rename assets/js/{79495b8c.47e418f9.js => 79495b8c.9dd0d9bb.js} (99%) rename assets/js/{7a6142bc.90c5eeac.js => 7a6142bc.9b7a7d5d.js} (99%) rename assets/js/{7e8f2ce0.b83a2592.js => 7e8f2ce0.10c1ae2f.js} (99%) rename assets/js/{8341015d.b28d4577.js => 8341015d.29079251.js} (99%) rename assets/js/{83d6452b.82226286.js => 83d6452b.6ad95a66.js} (98%) rename assets/js/{859087a1.afd8be37.js => 859087a1.48ac9743.js} (99%) rename assets/js/{85bdfa30.cd3ef5ac.js => 85bdfa30.69514acf.js} (99%) rename assets/js/{8602ac2f.3fe4f150.js => 8602ac2f.d4e6c203.js} (99%) rename assets/js/{8677fb48.21e7c562.js => 8677fb48.e37eb99b.js} (99%) rename assets/js/{8c68bf8b.104b7f46.js => 8c68bf8b.067b2d64.js} (99%) rename assets/js/{8cadb544.09fa420b.js => 8cadb544.e62ba719.js} (98%) rename assets/js/{8d01272a.40311105.js => 8d01272a.fa642db6.js} (98%) rename assets/js/{8f890ba0.58e3548a.js => 8f890ba0.eef5dc80.js} (99%) rename assets/js/{8fb8d401.d8254558.js => 8fb8d401.884facd1.js} (98%) rename assets/js/{9136c9f6.5f94eab8.js => 9136c9f6.0dd240ae.js} (99%) rename assets/js/{93102254.2ca66a95.js => 93102254.889ecc8c.js} (98%) rename assets/js/{9493c8af.ece90dd8.js => 9493c8af.a0098124.js} (99%) rename assets/js/{95d39ac8.3de0adee.js => 95d39ac8.e4239475.js} (98%) rename assets/js/{9844819e.6763f5f9.js => 9844819e.8c41bac6.js} (99%) rename assets/js/{9956d717.6d9b6f88.js => 9956d717.77e2b68c.js} (99%) rename assets/js/{9976dba8.bfd993ab.js => 9976dba8.7c484a11.js} (99%) rename assets/js/{9a3eaf08.a393d250.js => 9a3eaf08.e70cda88.js} (99%) rename assets/js/{9c3f4df8.dd595aef.js => 9c3f4df8.7ed6a041.js} (99%) rename assets/js/{9ee044af.819461b1.js => 9ee044af.047748cc.js} (99%) rename assets/js/{9f5dc2b0.6e815067.js => 9f5dc2b0.241533e9.js} (98%) rename assets/js/{a11550d3.e42f0cc9.js => a11550d3.82477aaf.js} (99%) rename assets/js/{a69d64d2.faef3cd4.js => a69d64d2.dbe9a342.js} (99%) rename assets/js/{a7c030b4.41593a1d.js => a7c030b4.177a8d2e.js} (99%) rename assets/js/{a8ce4b3e.9529e98f.js => a8ce4b3e.fb045df6.js} (99%) rename assets/js/{a8ffcef1.3c5973e3.js => a8ffcef1.06e33a6d.js} (98%) rename assets/js/{a976b482.e24f7183.js => a976b482.c6394592.js} (99%) rename assets/js/{aa7dbb4e.323418ef.js => aa7dbb4e.2b349628.js} (99%) rename assets/js/{ac002e07.9095b307.js => ac002e07.63977048.js} (97%) rename assets/js/{ade4df9f.d0afef8e.js => ade4df9f.ce509191.js} (99%) rename assets/js/{ade96904.78329285.js => ade96904.97417749.js} (99%) rename assets/js/{afb8980b.05599609.js => afb8980b.0acf9128.js} (99%) rename assets/js/{b0474474.b285128e.js => b0474474.f58ec732.js} (99%) rename assets/js/{b3defa12.6e14f923.js => b3defa12.a6cbf2cf.js} (99%) rename assets/js/{b5976878.c6d24dd2.js => b5976878.27afdc01.js} (99%) rename assets/js/{b916b40f.b1c1621e.js => b916b40f.436d3922.js} (99%) rename assets/js/{b98952f9.19b7acc9.js => b98952f9.d225c518.js} (99%) rename assets/js/{b9e2db8f.697257d2.js => b9e2db8f.e63539b2.js} (99%) rename assets/js/{bb7c9df2.b348fbaf.js => bb7c9df2.40eab300.js} (99%) rename assets/js/{bcb93ad0.51b7829a.js => bcb93ad0.e194b17b.js} (99%) rename assets/js/{be5e65fb.c09311cb.js => be5e65fb.21248ee8.js} (99%) rename assets/js/{bf59d308.e6b2631e.js => bf59d308.601152b4.js} (99%) rename assets/js/{bff975ac.7348f985.js => bff975ac.70368c5c.js} (98%) rename assets/js/{c0bb789b.86b779e0.js => c0bb789b.02c07030.js} (99%) rename assets/js/{c3085379.3fb0a964.js => c3085379.ed110dbb.js} (99%) rename assets/js/{c3416a9b.090a2b41.js => c3416a9b.ebbfbdd8.js} (99%) rename assets/js/{c355543d.76aa4bb3.js => c355543d.9e9dd212.js} (99%) rename assets/js/{c4494d6d.08a9751c.js => c4494d6d.0a1899ac.js} (98%) rename assets/js/{c455830f.0d0e46eb.js => c455830f.bdb4774d.js} (99%) rename assets/js/{c4b5710d.1f0dbf9d.js => c4b5710d.4a844b58.js} (99%) rename assets/js/{c5a98701.abbaa487.js => c5a98701.a1c3e653.js} (99%) rename assets/js/{c5f202a2.d43c6527.js => c5f202a2.3c88fa9a.js} (99%) rename assets/js/{c8fbbf4e.1c6d52ec.js => c8fbbf4e.b5cd0319.js} (98%) rename assets/js/{cf9aab87.a7cf9dc2.js => cf9aab87.7ed42051.js} (99%) rename assets/js/{cfcdc3ca.76a2f0d0.js => cfcdc3ca.04a2c1e5.js} (99%) rename assets/js/{d117691e.fa7275b3.js => d117691e.d7e38ceb.js} (99%) rename assets/js/{d1ce265f.a9d8670f.js => d1ce265f.8c577c55.js} (99%) rename assets/js/{d1e6fc8b.723a4b87.js => d1e6fc8b.a9f461eb.js} (99%) rename assets/js/{d40fa606.27b0cc6a.js => d40fa606.c243b689.js} (99%) rename assets/js/{d529df3a.c45474d6.js => d529df3a.07f5de3e.js} (98%) rename assets/js/{d71eb2ae.4ab9db0c.js => d71eb2ae.d9573e14.js} (99%) rename assets/js/{d9735dd1.939398fb.js => d9735dd1.8188117b.js} (99%) rename assets/js/{d99d06d7.f961b430.js => d99d06d7.eb8356e0.js} (99%) rename assets/js/{dd763692.ce2ab017.js => dd763692.0ef98c4e.js} (99%) rename assets/js/{de8bc3ad.135e8b27.js => de8bc3ad.c1e2d24f.js} (99%) rename assets/js/{e129cf3c.6f52f945.js => e129cf3c.17130891.js} (98%) rename assets/js/{e203f18e.6e2f4ad6.js => e203f18e.1a085a15.js} (99%) rename assets/js/{e3cbe702.792fc998.js => e3cbe702.72c125f4.js} (99%) rename assets/js/{e58d15ee.c497916f.js => e58d15ee.44f04799.js} (98%) rename assets/js/{e6a4b882.2ec4bf30.js => e6a4b882.806b9903.js} (98%) rename assets/js/{e6fe19ee.153b1100.js => e6fe19ee.e987fc1a.js} (99%) rename assets/js/{e768272c.1f0510ad.js => e768272c.3affe9de.js} (98%) rename assets/js/{e963bf71.7f3a53a5.js => e963bf71.1b15f4d3.js} (98%) rename assets/js/{ed448e8d.697b54f8.js => ed448e8d.7ed5df11.js} (99%) rename assets/js/{ed4d88b7.55e0497f.js => ed4d88b7.37f8e6a5.js} (99%) rename assets/js/{efbcea9d.3423dd0d.js => efbcea9d.cfb72f4a.js} (99%) rename assets/js/{f12ace1d.32f18b64.js => f12ace1d.af42c4a3.js} (99%) rename assets/js/{f24909cd.1ba4d9b5.js => f24909cd.943b6d6d.js} (99%) rename assets/js/{f37d4412.557b5c32.js => f37d4412.32797a75.js} (99%) rename assets/js/{f512b02d.af27503f.js => f512b02d.de18ba95.js} (98%) rename assets/js/{f5824b3c.fc903ac8.js => f5824b3c.49d4dc5c.js} (99%) rename assets/js/{fb5ac514.a94ad8af.js => fb5ac514.6427de3e.js} (99%) rename assets/js/{fbb7f9e6.af7ff308.js => fbb7f9e6.1b20e4df.js} (99%) rename assets/js/{fbdbb09f.2dc98abe.js => fbdbb09f.01cfe4ce.js} (99%) rename assets/js/{fd7be43f.2534f4bf.js => fd7be43f.1342f066.js} (99%) rename assets/js/{feb0a068.f00a40a7.js => feb0a068.bea1ee0e.js} (99%) rename assets/js/{runtime~main.d5d143c0.js => runtime~main.a40ed38d.js} (60%) diff --git a/404.html b/404.html index b61a63155..1e4aae8b8 100644 --- a/404.html +++ b/404.html @@ -4,7 +4,7 @@ Page Not Found | TNO Terminology Design - + @@ -17,7 +17,7 @@ .  Copyright © 2022-2024 by TNO.

- + \ No newline at end of file diff --git a/assets/js/021ecb5a.121f38b0.js b/assets/js/021ecb5a.a7969fd5.js similarity index 99% rename from assets/js/021ecb5a.121f38b0.js rename to assets/js/021ecb5a.a7969fd5.js index 86a8c9be0..97567757c 100644 --- a/assets/js/021ecb5a.121f38b0.js +++ b/assets/js/021ecb5a.a7969fd5.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5505],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=i.createContext({}),l=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=l(a),p=n,f=h["".concat(c,".").concat(p)]||h[p]||m[p]||r;return a?i.createElement(f,o(o({ref:t},d),{},{components:a})):i.createElement(f,o({ref:t},d))}));function p(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var l=2;l{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>N});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),c=a(1980),l=a(7392),d=a(12);function m(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??m(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function p(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function f(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!p({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[c,l]=f({queryString:a,groupId:i}),[m,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),g=(()=>{const e=c??m;return p({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{g&&s(g)}),[g]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!p({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),l(e),u(e)}),[l,u,r]),tabValues:r}}var g=a(2389);const y="tabList__CuJ",k="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:s,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:m}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=l[a].value;i!==s&&(m(t),c(i))},p=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:p,onClick:h},o,{className:(0,r.Z)("tabs__item",k,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function b(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function w(e){const t=u(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(v,(0,i.Z)({},e,t)),n.createElement(b,(0,i.Z)({},e,t)))}function N(e){const t=(0,g.Z)();return n.createElement(w,(0,i.Z)({key:String(t)},e))}},611:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var i=a(3117),n=(a(7294),a(3905));a(4996),a(4866),a(5162);const r={id:"terminology-construction",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},o="Terminology Construction",s={unversionedId:"manuals/curator/terminology-construction",id:"manuals/curator/terminology-construction",title:"Terminology Construction",description:"Curators need the ability to construct one or more (versions of) terminologies for any scope they curate. Creating a terminology consists of",source:"@site/docs/manuals/curator/42-curator-terminology-construction.md",sourceDirName:"manuals/curator",slug:"/manuals/curator/terminology-construction",permalink:"/tev2-specifications/docs/manuals/curator/terminology-construction",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/manuals/curator/42-curator-terminology-construction.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:42,frontMatter:{id:"terminology-construction",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},sidebar:"tev2SideBar",previous:{title:"Installation",permalink:"/tev2-specifications/docs/manuals/curator/tev2-installation"},next:{title:"Specifications",permalink:"/tev2-specifications/docs/categories/specs"}},c={},l=[{value:"Specifying the contents of a terminology",id:"specifying-terminology",level:2},{value:"Process for creating a terminology",id:"process-for-creating-a-terminology",level:2},{value:"Adding Terms",id:"add-terms",level:2},{value:"Add all terms from a specific source",id:"syntax-add-all-terms",level:3},{value:"Add selected terms from a specific source",id:"syntax-add-selected-terms",level:3},{value:"Removing Terms",id:"remove-terms",level:2},{value:"Rename/rewrite term fields",id:"rename-terms",level:2}],d={toc:l};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"terminology-construction"},"Terminology Construction"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," need the ability to construct one or more (versions of) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," for any ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," they ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curate"),". Creating a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of",(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"selecting the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are to be referenceable by ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". This is done by ",(0,n.kt)("a",{parentName:"li",href:"#specifying-terminology"},"editing")," the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),";"),(0,n.kt)("li",{parentName:"ol"},"generating an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", i.e., a list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", each of which documents a selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"/",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", which includes the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used to refer to them. This is done by invoking the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,n.kt)("h2",{id:"specifying-terminology"},"Specifying the contents of a terminology"),(0,n.kt)("p",null,"The specification of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," exists as an entry in the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#versions"},(0,n.kt)("inlineCode",{parentName:"a"},"versions")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," in which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),". ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," can add and remove them as they see fit."),(0,n.kt)("p",null,"A new ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," specification must at least have"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that allows the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," to be identified (within its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), "),(0,n.kt)("li",{parentName:"ul"},"a list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," that specify the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are to be included (or removed) from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as it is being constructed, and"),(0,n.kt)("li",{parentName:"ul"},"some meta-data (see the ",(0,n.kt)("a",{parentName:"li",href:"/docs/specs/files/saf#versions"},"documentation"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Example SAF, showing the specifications for 2 ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-yaml"},'scope:\n scopetag: myscope # identifier for \'current scope\'\n scopedir: https://github.com/myscope-repo/tree/master/docs # URL of the scope-directory of `myscope`\n curatedir: terms # directory where all curated files are located.\n glossarydir: glossaries # directory where all glossary files and related stuff are located.\n defaultvsn: latest # vsntag that identifies the default terminology. A link to the MRG is located at `scopedir`/`glossarydir`/mrg.`scopetag`.yaml\n...\nscopes:\n\n- scopetag: essif-lab # definition of (scope) tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/essif-lab/framework/tree/master/docs # URL of the scope-directory\n- scopetag: tev2 # definition of (scope)tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/tno-terminology-design/tev2-specifications/tree/master/docs # URL of the scope-directory\n...\nversions:\n - vsntag: terms\n termselection:\n - "*" # include all terms defined by a curated text in the current scope\n - vsntag: v1.0.3 # a versiontag that identifies this version from all other versions in the SAF\n altvsntags: [ latest ] \n termselection:\n - "*@essif-lab" # import all terms from the MRG linked to by `mrg.essif-lab.yaml`\n - "-grouptags[terminology]" # then, remove all terms tagged with the grouptag `terminology`\n - "*" # then, include all terms defined by a curated text in the current scope\n'))),(0,n.kt)("h2",{id:"process-for-creating-a-terminology"},"Process for creating a terminology"),(0,n.kt)("p",null,"The creation (or maintenance) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is equivalent with the creation (or maintenance) of the set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that document each of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," therein. Thus, the process for creating a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be described as follows:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"start with an empty set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),' - we use the term "',(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),'" to refer to this set.')),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"sequentially process the list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," as specified in the appropriate entry of the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#versions"},(0,n.kt)("inlineCode",{parentName:"a"},"versions")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", i.e. instructions which allow for"))),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#add-terms"},"adding")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"; these can either be ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," that have been created from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," whose contents are obtained from an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," other than the one that is being created.",(0,n.kt)("sup",{parentName:"p",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#remove-terms"},"removing")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),";")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#rename-terms"},"modifying attributes")," of a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", e.g. for renaming a term that originated from another ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."))),(0,n.kt)("p",null,"This process is run by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," - see ",(0,n.kt)("mark",null,"to be done")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Prerequisites"),(0,n.kt)("p",null,"In this text, we will use the terms:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"))," for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," within which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is being created and"),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},"current version")," for the version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is being created.")),(0,n.kt)("p",null,"In the syntax specification for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", we use the following symbols:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Symbol"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of a designated ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", or the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (front-matter) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". Examples: ",(0,n.kt)("inlineCode",{parentName:"td"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"status"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that is used to identify an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," or a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."))))),(0,n.kt)("h2",{id:"add-terms"},"Adding Terms"),(0,n.kt)("p",null,"Adding terms is done using instructions that "),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"identify a (set of) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that is to be added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"."),(0,n.kt)("li",{parentName:"ol"},"specify the source from which an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be created for each of these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),".")),(0,n.kt)("p",null,"By default, the source is the the set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),"."),(0,n.kt)("p",null,"However, any (existing) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," can be used as an alternative source, by adding the text ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," to the instruction that selects the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", where ",(0,n.kt)("inlineCode",{parentName:"p"},"")," is the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". Note that this ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),"."),(0,n.kt)("h3",{id:"syntax-add-all-terms"},"Add all terms from a specific source"),(0,n.kt)("p",null,"The following syntaxes are available for adding all terms from a specific source to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"*")),(0,n.kt)("br",null),"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are described by a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"\xa0"),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"* @")),(0,n.kt)("br",null),"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that have an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," as identified by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,n.kt)("inlineCode",{parentName:"li"},""),". This ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Examples:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"*","\xa0","@tev2:v1"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in version ",(0,n.kt)("inlineCode",{parentName:"td"},"v1")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),", i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg.tev2.v1.yaml"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @tev2"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),",",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg.tev2..yaml"),", where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"defaultvsn")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that is located in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," associated with the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @:v1.0.3"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in version ",(0,n.kt)("inlineCode",{parentName:"td"},"v1.0.3")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg..v1.0.3.yaml"),", where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg...yaml"),", where:",(0,n.kt)("br",null),"- ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", and",(0,n.kt)("br",null),"- ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"defaultvsn")," field in that same ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"*"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are described by a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")))),(0,n.kt)("p",null,"The difference between ",(0,n.kt)("inlineCode",{parentName:"p"},"*")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"* @")," is that the first takes ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," as source, whereas the latter takes an existing ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," as source, being the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),". This allows ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to be defined in terms of their predecessors.")),(0,n.kt)("h3",{id:"syntax-add-selected-terms"},"Add selected terms from a specific source"),(0,n.kt)("p",null,"The following syntaxes are available for adding a selection of terms from a specific source to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (front-matter) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is to be selected for inclusion in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".",(0,n.kt)("br",null),"\xa0"))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"," ",(0,n.kt)("inlineCode",{parentName:"strong"},"@")),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," (that must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),")."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that resides in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," is to be selected for inclusion in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")))),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},(0,n.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-tools/issues/15"},"Issue #15")," requests for adding the following:"),(0,n.kt)("ul",{parentName:"admonition"},(0,n.kt)("li",{parentName:"ul"},"The list ",(0,n.kt)("strong",{parentName:"li"},"[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]")," can be replaced with ",(0,n.kt)("inlineCode",{parentName:"li"},"*")," (or is it ",(0,n.kt)("strong",{parentName:"li"},"[",(0,n.kt)("inlineCode",{parentName:"strong"},"*"),"]"),"?), which would then mean that all curated texts or MRG entries are selected whose ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists and is not empty."),(0,n.kt)("li",{parentName:"ul"},"Any ",(0,n.kt)("inlineCode",{parentName:"li"},"")," may be preceded by the ",(0,n.kt)("inlineCode",{parentName:"li"},"!"),"-character or the ",(0,n.kt)("inlineCode",{parentName:"li"},"NOT")," (or ",(0,n.kt)("inlineCode",{parentName:"li"},"not"),") keyword, which would then mean that all curated texts or MRG entries are selected whose ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does NOT contain the specified ",(0,n.kt)("inlineCode",{parentName:"li"},""),". This could be used, e.g., to select terms whoses ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," fiels does not contain the value ",(0,n.kt)("inlineCode",{parentName:"li"},"deprecated"),".")),(0,n.kt)("p",{parentName:"admonition"},"This documentation should reflect what was done as the issue gets closed.")),(0,n.kt)("p",null,"These instructions will add every term from the designated source, whose specification contains a field named ",(0,n.kt)("inlineCode",{parentName:"p"},""),", and (one of) the value(s) of that field matches with at least one of the values in ",(0,n.kt)("inlineCode",{parentName:"p"},"[ , , ... ]"),"."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"term ","[actor]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of which the value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"status","[proposed,approved]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of which the value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"somefield []"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a field ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," that has no value specified.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"term ","[actor,party]","@tev2:v1"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2")," that has ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version")," ",(0,n.kt)("inlineCode",{parentName:"td"},"v1"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"grouptags","[x,y,z]","@essif-lab"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"essif-lab"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),"."))))),(0,n.kt)("h2",{id:"remove-terms"},"Removing Terms"),(0,n.kt)("p",null,"Removing terms is equivalent to removing selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),". The syntax is similar to one that is used for adding terms, but it is preceded with a ",(0,n.kt)("inlineCode",{parentName:"p"},"-"),"sign, and a source may not be specified, as it is always the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"."),(0,n.kt)("p",null,"The following syntaxes are available for removing a selection of terms from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},"-",(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", , such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is to be removed from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")))),(0,n.kt)("p",null,"This syntax removes every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that has a field named ",(0,n.kt)("inlineCode",{parentName:"p"},""),", and where (one of) the value(s) of that field matches with at least one of the values in ",(0,n.kt)("inlineCode",{parentName:"p"},"[ , , ... ]"),"."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-term ","[actor]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-status","[proposed,approved]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-grouptags","[x,y,z]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field of which one of the listed ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-somefield []"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field that has no value specified."))))),(0,n.kt)("h2",{id:"rename-terms"},"Rename/rewrite term fields"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"The ability to rename terms as they are imported may introduce some issues related to other field-names, such as ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"synonyms"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText"),"s and possibly some others. Perhaps this syntax should therefore be extended, enabling ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to simultaneously change these (and other) fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("p",null,"In analogy with ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),", we accommodate for the renaming of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," as they are 'imported' from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," other than the one that we are constructing. However, the analogy breaks down in the sense that it is not only a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that should be renamable (which is sufficient for ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),"), but also certain attributes may need to be changed."),(0,n.kt)("p",null,"The following syntaxes are available for renaming fields in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"rename")," ",(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),":",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},":"),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that is selected for the renaming process, which may optionally be preceded with ",(0,n.kt)("inlineCode",{parentName:"li"},":")," (where ",(0,n.kt)("inlineCode",{parentName:"li"},"")," would then be the value of the ",(0,n.kt)("inlineCode",{parentName:"li"},"termType")," field in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"). Note that this value is an identifier for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"formPhrases"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"li"},""),". If the text contains multiple words, it is advised to surround it with quotes.")))),(0,n.kt)("p",null,"Here is how it works. First, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG Entry")," is searched that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"p"},""),". If found, all ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pairs are processed in the sequence they are specified. Processing a ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pair consists of looking for a field named ",(0,n.kt)("inlineCode",{parentName:"p"},"")," in the selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". We now have the following situations:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then the contents of the field is overwritten by ",(0,n.kt)("inlineCode",{parentName:"li"},""),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then the contents of the field is deleted;"))),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does not exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then a new field named ",(0,n.kt)("inlineCode",{parentName:"li"},"")," with the specified ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then nothing is done.")))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Renaming examples"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'rename party [ status:accepted, glossaryText:"A natural person or a legal person" ]')),":"),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"accepted"),", and "),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural person or a legal person"'),"."))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'rename party [ term:partij, formPhrases:"partij{en}", glossaryText:"Een natuurlijk persoon of een rechtspersoon" ]'))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"partij"),";"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"approved"),"."),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural or legal person"')))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},"rename party [ glossaryText: ]"))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"removes the contents from the ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field if such a field exists.",(0,n.kt)("br",null)))))),(0,n.kt)("p",null,"where:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"symbol"),(0,n.kt)("th",{parentName:"tr",align:"left"},"description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of the tuple that will be selected for renaming.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a (non-empty) comma-separated list of ",(0,n.kt)("inlineCode",{parentName:"td"},""),"s.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a ",(0,n.kt)("inlineCode",{parentName:"td"},":")," pair.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that identifies a field in an ","[MRG entry]",", the value of which is to be changed, e.g. ",(0,n.kt)("inlineCode",{parentName:"td"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", etc.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"td"},""),".")))),(0,n.kt)("p",null,"This syntax is processed by first selecting the tuple (in the tuple set that is being constructed) that has the specified ",(0,n.kt)("inlineCode",{parentName:"p"},"")," as its ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),"-field, and then sequentially processing the ",(0,n.kt)("inlineCode",{parentName:"p"},""),"s in the ",(0,n.kt)("inlineCode",{parentName:"p"},""),", which means that the existing text of the field that is identified by the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," element of the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," is replaced by the text specified by the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," element of that ",(0,n.kt)("inlineCode",{parentName:"p"},""),"."),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"The ability to rename terms as they are imported may introduce some issues related to other field-names, such as ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"synonyms"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText"),"s and possibly some others. Perhaps this syntax should therefore be extended, enabling ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to simultaneously change these (and other) fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("div",{className:"footnotes"},(0,n.kt)("hr",{parentName:"div"}),(0,n.kt)("ol",{parentName:"div"},(0,n.kt)("li",{parentName:"ol",id:"fn-1"},"Two (or more) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," cannot have the same value in their ",(0,n.kt)("inlineCode",{parentName:"li"},"termid")," fields. Therefore, if an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is added whose value in its ",(0,n.kt)("inlineCode",{parentName:"li"},"termid")," field already exists with an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is already in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", then this latter ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry")," will be discarded, after which the new ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry")," is added.",(0,n.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5505],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=i.createContext({}),l=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=l(a),p=n,f=h["".concat(c,".").concat(p)]||h[p]||m[p]||r;return a?i.createElement(f,o(o({ref:t},d),{},{components:a})):i.createElement(f,o({ref:t},d))}));function p(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var l=2;l{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>N});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),c=a(1980),l=a(7392),d=a(12);function m(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??m(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function p(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function f(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!p({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[c,l]=f({queryString:a,groupId:i}),[m,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),g=(()=>{const e=c??m;return p({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{g&&s(g)}),[g]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!p({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),l(e),u(e)}),[l,u,r]),tabValues:r}}var g=a(2389);const y="tabList__CuJ",k="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:s,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:m}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=l[a].value;i!==s&&(m(t),c(i))},p=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:p,onClick:h},o,{className:(0,r.Z)("tabs__item",k,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function b(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function w(e){const t=u(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(v,(0,i.Z)({},e,t)),n.createElement(b,(0,i.Z)({},e,t)))}function N(e){const t=(0,g.Z)();return n.createElement(w,(0,i.Z)({key:String(t)},e))}},611:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var i=a(3117),n=(a(7294),a(3905));a(4996),a(4866),a(5162);const r={id:"terminology-construction",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},o="Terminology Construction",s={unversionedId:"manuals/curator/terminology-construction",id:"manuals/curator/terminology-construction",title:"Terminology Construction",description:"Curators need the ability to construct one or more (versions of) terminologies for any scope they curate. Creating a terminology consists of",source:"@site/docs/manuals/curator/42-curator-terminology-construction.md",sourceDirName:"manuals/curator",slug:"/manuals/curator/terminology-construction",permalink:"/tev2-specifications/docs/manuals/curator/terminology-construction",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/manuals/curator/42-curator-terminology-construction.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:42,frontMatter:{id:"terminology-construction",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},sidebar:"tev2SideBar",previous:{title:"Installation",permalink:"/tev2-specifications/docs/manuals/curator/tev2-installation"},next:{title:"Specifications",permalink:"/tev2-specifications/docs/categories/specs"}},c={},l=[{value:"Specifying the contents of a terminology",id:"specifying-terminology",level:2},{value:"Process for creating a terminology",id:"process-for-creating-a-terminology",level:2},{value:"Adding Terms",id:"add-terms",level:2},{value:"Add all terms from a specific source",id:"syntax-add-all-terms",level:3},{value:"Add selected terms from a specific source",id:"syntax-add-selected-terms",level:3},{value:"Removing Terms",id:"remove-terms",level:2},{value:"Rename/rewrite term fields",id:"rename-terms",level:2}],d={toc:l};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"terminology-construction"},"Terminology Construction"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," need the ability to construct one or more (versions of) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," for any ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," they ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curate"),". Creating a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of",(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"selecting the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are to be referenceable by ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". This is done by ",(0,n.kt)("a",{parentName:"li",href:"#specifying-terminology"},"editing")," the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),";"),(0,n.kt)("li",{parentName:"ol"},"generating an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", i.e., a list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", each of which documents a selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"/",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", which includes the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used to refer to them. This is done by invoking the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,n.kt)("h2",{id:"specifying-terminology"},"Specifying the contents of a terminology"),(0,n.kt)("p",null,"The specification of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," exists as an entry in the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#versions"},(0,n.kt)("inlineCode",{parentName:"a"},"versions")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," in which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),". ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," can add and remove them as they see fit."),(0,n.kt)("p",null,"A new ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," specification must at least have"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that allows the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," to be identified (within its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), "),(0,n.kt)("li",{parentName:"ul"},"a list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," that specify the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are to be included (or removed) from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as it is being constructed, and"),(0,n.kt)("li",{parentName:"ul"},"some meta-data (see the ",(0,n.kt)("a",{parentName:"li",href:"/docs/specs/files/saf#versions"},"documentation"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Example SAF, showing the specifications for 2 ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-yaml"},'scope:\n scopetag: myscope # identifier for \'current scope\'\n scopedir: https://github.com/myscope-repo/tree/master/docs # URL of the scope-directory of `myscope`\n curatedir: terms # directory where all curated files are located.\n glossarydir: glossaries # directory where all glossary files and related stuff are located.\n defaultvsn: latest # vsntag that identifies the default terminology. A link to the MRG is located at `scopedir`/`glossarydir`/mrg.`scopetag`.yaml\n...\nscopes:\n\n- scopetag: essif-lab # definition of (scope) tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/essif-lab/framework/tree/master/docs # URL of the scope-directory\n- scopetag: tev2 # definition of (scope)tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/tno-terminology-design/tev2-specifications/tree/master/docs # URL of the scope-directory\n...\nversions:\n - vsntag: terms\n termselection:\n - "*" # include all terms defined by a curated text in the current scope\n - vsntag: v1.0.3 # a versiontag that identifies this version from all other versions in the SAF\n altvsntags: [ latest ] \n termselection:\n - "*@essif-lab" # import all terms from the MRG linked to by `mrg.essif-lab.yaml`\n - "-grouptags[terminology]" # then, remove all terms tagged with the grouptag `terminology`\n - "*" # then, include all terms defined by a curated text in the current scope\n'))),(0,n.kt)("h2",{id:"process-for-creating-a-terminology"},"Process for creating a terminology"),(0,n.kt)("p",null,"The creation (or maintenance) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is equivalent with the creation (or maintenance) of the set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that document each of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," therein. Thus, the process for creating a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be described as follows:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"start with an empty set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),' - we use the term "',(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),'" to refer to this set.')),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"sequentially process the list of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," as specified in the appropriate entry of the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#versions"},(0,n.kt)("inlineCode",{parentName:"a"},"versions")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", i.e. instructions which allow for"))),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#add-terms"},"adding")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"; these can either be ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," that have been created from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," whose contents are obtained from an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," other than the one that is being created.",(0,n.kt)("sup",{parentName:"p",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#remove-terms"},"removing")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),";")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection#rename-terms"},"modifying attributes")," of a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", e.g. for renaming a term that originated from another ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."))),(0,n.kt)("p",null,"This process is run by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," - see ",(0,n.kt)("mark",null,"to be done")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Prerequisites"),(0,n.kt)("p",null,"In this text, we will use the terms:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"))," for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," within which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is being created and"),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},"current version")," for the version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is being created.")),(0,n.kt)("p",null,"In the syntax specification for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", we use the following symbols:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Symbol"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of a designated ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", or the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (front-matter) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". Examples: ",(0,n.kt)("inlineCode",{parentName:"td"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"status"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that is used to identify an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," or a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."))))),(0,n.kt)("h2",{id:"add-terms"},"Adding Terms"),(0,n.kt)("p",null,"Adding terms is done using instructions that "),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"identify a (set of) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that is to be added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"."),(0,n.kt)("li",{parentName:"ol"},"specify the source from which an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be created for each of these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),".")),(0,n.kt)("p",null,"By default, the source is the the set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),"."),(0,n.kt)("p",null,"However, any (existing) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," can be used as an alternative source, by adding the text ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," to the instruction that selects the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", where ",(0,n.kt)("inlineCode",{parentName:"p"},"")," is the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". Note that this ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),"."),(0,n.kt)("h3",{id:"syntax-add-all-terms"},"Add all terms from a specific source"),(0,n.kt)("p",null,"The following syntaxes are available for adding all terms from a specific source to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"*")),(0,n.kt)("br",null),"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are described by a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"\xa0"),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"* @")),(0,n.kt)("br",null),"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that have an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," as identified by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,n.kt)("inlineCode",{parentName:"li"},""),". This ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Examples:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"*","\xa0","@tev2:v1"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in version ",(0,n.kt)("inlineCode",{parentName:"td"},"v1")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),", i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg.tev2.v1.yaml"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @tev2"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),",",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg.tev2..yaml"),", where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"defaultvsn")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that is located in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," associated with the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @:v1.0.3"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in version ",(0,n.kt)("inlineCode",{parentName:"td"},"v1.0.3")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg..v1.0.3.yaml"),", where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"* @"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are in the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".",(0,n.kt)("br",null),"i.e., in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file ",(0,n.kt)("inlineCode",{parentName:"td"},"mrg...yaml"),", where:",(0,n.kt)("br",null),"- ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag")," field in the ",(0,n.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,n.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", and",(0,n.kt)("br",null),"- ",(0,n.kt)("inlineCode",{parentName:"td"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"defaultvsn")," field in that same ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"*"),(0,n.kt)("td",{parentName:"tr",align:"left"},"Add all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are described by a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")))),(0,n.kt)("p",null,"The difference between ",(0,n.kt)("inlineCode",{parentName:"p"},"*")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"* @")," is that the first takes ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," as source, whereas the latter takes an existing ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," as source, being the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains the default version of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),". This allows ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to be defined in terms of their predecessors.")),(0,n.kt)("h3",{id:"syntax-add-selected-terms"},"Add selected terms from a specific source"),(0,n.kt)("p",null,"The following syntaxes are available for adding a selection of terms from a specific source to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (front-matter) of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is to be selected for inclusion in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".",(0,n.kt)("br",null),"\xa0"))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"," ",(0,n.kt)("inlineCode",{parentName:"strong"},"@")),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," (that must have been made available in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),")."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that resides in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," is to be selected for inclusion in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")))),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},(0,n.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-tools/issues/15"},"Issue #15")," requests for adding the following:"),(0,n.kt)("ul",{parentName:"admonition"},(0,n.kt)("li",{parentName:"ul"},"The list ",(0,n.kt)("strong",{parentName:"li"},"[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]")," can be replaced with ",(0,n.kt)("inlineCode",{parentName:"li"},"*")," (or is it ",(0,n.kt)("strong",{parentName:"li"},"[",(0,n.kt)("inlineCode",{parentName:"strong"},"*"),"]"),"?), which would then mean that all curated texts or MRG entries are selected whose ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists and is not empty."),(0,n.kt)("li",{parentName:"ul"},"Any ",(0,n.kt)("inlineCode",{parentName:"li"},"")," may be preceded by the ",(0,n.kt)("inlineCode",{parentName:"li"},"!"),"-character or the ",(0,n.kt)("inlineCode",{parentName:"li"},"NOT")," (or ",(0,n.kt)("inlineCode",{parentName:"li"},"not"),") keyword, which would then mean that all curated texts or MRG entries are selected whose ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does NOT contain the specified ",(0,n.kt)("inlineCode",{parentName:"li"},""),". This could be used, e.g., to select terms whoses ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," fiels does not contain the value ",(0,n.kt)("inlineCode",{parentName:"li"},"deprecated"),".")),(0,n.kt)("p",{parentName:"admonition"},"This documentation should reflect what was done as the issue gets closed.")),(0,n.kt)("p",null,"These instructions will add every term from the designated source, whose specification contains a field named ",(0,n.kt)("inlineCode",{parentName:"p"},""),", and (one of) the value(s) of that field matches with at least one of the values in ",(0,n.kt)("inlineCode",{parentName:"p"},"[ , , ... ]"),"."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"term ","[actor]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of which the value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"status","[proposed,approved]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of which the value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"somefield []"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that has a field ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," that has no value specified.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"term ","[actor,party]","@tev2:v1"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"tev2")," that has ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version")," ",(0,n.kt)("inlineCode",{parentName:"td"},"v1"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"grouptags","[x,y,z]","@essif-lab"),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"essif-lab"),", that has a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),"."))))),(0,n.kt)("h2",{id:"remove-terms"},"Removing Terms"),(0,n.kt)("p",null,"Removing terms is equivalent to removing selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),". The syntax is similar to one that is used for adding terms, but it is preceded with a ",(0,n.kt)("inlineCode",{parentName:"p"},"-"),"sign, and a source may not be specified, as it is always the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),"."),(0,n.kt)("p",null,"The following syntaxes are available for removing a selection of terms from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},"-",(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", , such as ",(0,n.kt)("inlineCode",{parentName:"li"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},""),", ",(0,n.kt)("inlineCode",{parentName:"li"},""),", ... are texts that are used to determine whether or not an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is to be removed from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")))),(0,n.kt)("p",null,"This syntax removes every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that has a field named ",(0,n.kt)("inlineCode",{parentName:"p"},""),", and where (one of) the value(s) of that field matches with at least one of the values in ",(0,n.kt)("inlineCode",{parentName:"p"},"[ , , ... ]"),"."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-term ","[actor]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-status","[proposed,approved]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-grouptags","[x,y,z]"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field of which one of the listed ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"-somefield []"),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field that has no value specified."))))),(0,n.kt)("h2",{id:"rename-terms"},"Rename/rewrite term fields"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"The ability to rename terms as they are imported may introduce some issues related to other field-names, such as ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"synonyms"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText"),"s and possibly some others. Perhaps this syntax should therefore be extended, enabling ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to simultaneously change these (and other) fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("p",null,"In analogy with ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),", we accommodate for the renaming of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," as they are 'imported' from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," other than the one that we are constructing. However, the analogy breaks down in the sense that it is not only a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that should be renamable (which is sufficient for ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),"), but also certain attributes may need to be changed."),(0,n.kt)("p",null,"The following syntaxes are available for renaming fields in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("strong",{parentName:"li"},(0,n.kt)("inlineCode",{parentName:"strong"},"rename")," ",(0,n.kt)("inlineCode",{parentName:"strong"},"")," ","[ ",(0,n.kt)("inlineCode",{parentName:"strong"},""),":",(0,n.kt)("inlineCode",{parentName:"strong"},""),", ",(0,n.kt)("inlineCode",{parentName:"strong"},":"),", ... ]"),", where:",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is the value of the ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that is selected for the renaming process, which may optionally be preceded with ",(0,n.kt)("inlineCode",{parentName:"li"},":")," (where ",(0,n.kt)("inlineCode",{parentName:"li"},"")," would then be the value of the ",(0,n.kt)("inlineCode",{parentName:"li"},"termType")," field in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"). Note that this value is an identifier for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"li"},"formPhrases"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"status"),", etc."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"")," is a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"li"},""),". If the text contains multiple words, it is advised to surround it with quotes.")))),(0,n.kt)("p",null,"Here is how it works. First, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG Entry")," is searched that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"p"},""),". If found, all ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pairs are processed in the sequence they are specified. Processing a ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pair consists of looking for a field named ",(0,n.kt)("inlineCode",{parentName:"p"},"")," in the selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". We now have the following situations:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then the contents of the field is overwritten by ",(0,n.kt)("inlineCode",{parentName:"li"},""),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then the contents of the field is deleted;"))),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does not exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then a new field named ",(0,n.kt)("inlineCode",{parentName:"li"},"")," with the specified ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then nothing is done.")))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Renaming examples"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'rename party [ status:accepted, glossaryText:"A natural person or a legal person" ]')),":"),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"accepted"),", and "),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural person or a legal person"'),"."))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'rename party [ term:partij, formPhrases:"partij{en}", glossaryText:"Een natuurlijk persoon of een rechtspersoon" ]'))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"partij"),";"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"approved"),"."),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural or legal person"')))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},"rename party [ glossaryText: ]"))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"removes the contents from the ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field if such a field exists.",(0,n.kt)("br",null)))))),(0,n.kt)("p",null,"where:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"symbol"),(0,n.kt)("th",{parentName:"tr",align:"left"},"description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of the tuple that will be selected for renaming.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a (non-empty) comma-separated list of ",(0,n.kt)("inlineCode",{parentName:"td"},""),"s.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a ",(0,n.kt)("inlineCode",{parentName:"td"},":")," pair.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that identifies a field in an ","[MRG entry]",", the value of which is to be changed, e.g. ",(0,n.kt)("inlineCode",{parentName:"td"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", etc.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:"left"},"a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"td"},""),".")))),(0,n.kt)("p",null,"This syntax is processed by first selecting the tuple (in the tuple set that is being constructed) that has the specified ",(0,n.kt)("inlineCode",{parentName:"p"},"")," as its ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),"-field, and then sequentially processing the ",(0,n.kt)("inlineCode",{parentName:"p"},""),"s in the ",(0,n.kt)("inlineCode",{parentName:"p"},""),", which means that the existing text of the field that is identified by the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," element of the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," is replaced by the text specified by the ",(0,n.kt)("inlineCode",{parentName:"p"},"")," element of that ",(0,n.kt)("inlineCode",{parentName:"p"},""),"."),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"The ability to rename terms as they are imported may introduce some issues related to other field-names, such as ",(0,n.kt)("inlineCode",{parentName:"p"},"term"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"form-phrases"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"synonyms"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText"),"s and possibly some others. Perhaps this syntax should therefore be extended, enabling ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to simultaneously change these (and other) fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("div",{className:"footnotes"},(0,n.kt)("hr",{parentName:"div"}),(0,n.kt)("ol",{parentName:"div"},(0,n.kt)("li",{parentName:"ol",id:"fn-1"},"Two (or more) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," cannot have the same value in their ",(0,n.kt)("inlineCode",{parentName:"li"},"termid")," fields. Therefore, if an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is added whose value in its ",(0,n.kt)("inlineCode",{parentName:"li"},"termid")," field already exists with an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is already in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", then this latter ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry")," will be discarded, after which the new ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry")," is added.",(0,n.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/03b39aaa.31c9fc99.js b/assets/js/03b39aaa.e638db87.js similarity index 99% rename from assets/js/03b39aaa.31c9fc99.js rename to assets/js/03b39aaa.e638db87.js index 5bb89a997..52a0ef2dc 100644 --- a/assets/js/03b39aaa.31c9fc99.js +++ b/assets/js/03b39aaa.e638db87.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5328],{3905:(e,t,r)=>{r.d(t,{Zo:()=>c,kt:()=>d});var s=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,s)}return r}function n(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var l=s.createContext({}),p=function(e){var t=s.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},c=function(e){var t=p(e.components);return s.createElement(l.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},m=s.forwardRef((function(e,t){var r=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),m=p(r),d=o,g=m["".concat(l,".").concat(d)]||m[d]||u[d]||a;return r?s.createElement(g,n(n({ref:t},c),{},{components:r})):s.createElement(g,n({ref:t},c))}));function d(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=r.length,n=new Array(a);n[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:o,n[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>n,default:()=>u,frontMatter:()=>a,metadata:()=>i,toc:()=>p});var s=r(3117),o=(r(7294),r(3905));const a={id:"glossary",displayed_sidebar:"tev2SideBar",term:"glossary",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"an alphabetically sorted list of [terms](@) with the (single) meaning it has in (at least) one context.",grouptags:[],formPhrases:["glossar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Glossary",i={unversionedId:"terms/glossary",id:"terms/glossary",title:"Glossary",description:"Summary",source:"@site/docs/terms/glossary.md",sourceDirName:"terms",slug:"/terms/glossary",permalink:"/tev2-specifications/docs/terms/glossary",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/glossary.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"glossary",displayed_sidebar:"tev2SideBar",term:"glossary",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"an alphabetically sorted list of [terms](@) with the (single) meaning it has in (at least) one context.",grouptags:[],formPhrases:["glossar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},p=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3}],c={toc:p};function u(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,s.Z)({},c,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"glossary"},"Glossary"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"glossary")," is an alphabetically sorted list of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with explanations, usually aimed to help people understand texts around a certain (set of) topic(s) in (at least) one context. A glossary may also be created for the purpose of being included in other glossaries (as a construction aid to such glossaries), or for still other purposes."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("h3",{id:"purpose"},"Purpose"),(0,o.kt)("p",null,"A glossary may serve various purposes, the most important one of which would be to help people understand texts around a certain (set of) topic(s) in some context(s)."),(0,o.kt)("h3",{id:"criteria"},"Criteria"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"glossary")," is an alphabetical list of words or phrases with (short) explanations, that exists for the purpose of helping people to get a first understanding of the meaning of each word in the scope/context for which the glossary is created."),(0,o.kt)("h3",{id:"examples"},"Examples"),(0,o.kt)("p",null,"Examples include the ",(0,o.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/essifLab-glossary"},"eSSIF-Lab Glossary"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://sovrin.org/library/glossary/"},"Sovrin Glossary"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://www.internetsociety.org/internet/glossary-internet-terms/"},"Glossary of Internet Terms"),", and glossaries for Legal Terms, e.g. of the ",(0,o.kt)("a",{parentName:"p",href:"https://www.uscourts.gov/glossary"},"US"),", ",(0,o.kt)("a",{parentName:"p",href:"https://www.supremecourt.gov.sg/services/self-help-services/glossary-of-terms"},"Singapore"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://www.copfs.gov.uk/involved-in-a-case/glossary-of-legal-terms"},"UK"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5328],{3905:(e,t,r)=>{r.d(t,{Zo:()=>c,kt:()=>d});var s=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,s)}return r}function n(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var l=s.createContext({}),p=function(e){var t=s.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},c=function(e){var t=p(e.components);return s.createElement(l.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},m=s.forwardRef((function(e,t){var r=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),m=p(r),d=o,g=m["".concat(l,".").concat(d)]||m[d]||u[d]||a;return r?s.createElement(g,n(n({ref:t},c),{},{components:r})):s.createElement(g,n({ref:t},c))}));function d(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=r.length,n=new Array(a);n[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:o,n[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>n,default:()=>u,frontMatter:()=>a,metadata:()=>i,toc:()=>p});var s=r(3117),o=(r(7294),r(3905));const a={id:"glossary",displayed_sidebar:"tev2SideBar",term:"glossary",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"an alphabetically sorted list of [terms](@) with the (single) meaning it has in (at least) one context.",grouptags:[],formPhrases:["glossar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Glossary",i={unversionedId:"terms/glossary",id:"terms/glossary",title:"Glossary",description:"Summary",source:"@site/docs/terms/glossary.md",sourceDirName:"terms",slug:"/terms/glossary",permalink:"/tev2-specifications/docs/terms/glossary",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/glossary.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"glossary",displayed_sidebar:"tev2SideBar",term:"glossary",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"an alphabetically sorted list of [terms](@) with the (single) meaning it has in (at least) one context.",grouptags:[],formPhrases:["glossar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},p=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3}],c={toc:p};function u(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,s.Z)({},c,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"glossary"},"Glossary"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"glossary")," is an alphabetically sorted list of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with explanations, usually aimed to help people understand texts around a certain (set of) topic(s) in (at least) one context. A glossary may also be created for the purpose of being included in other glossaries (as a construction aid to such glossaries), or for still other purposes."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("h3",{id:"purpose"},"Purpose"),(0,o.kt)("p",null,"A glossary may serve various purposes, the most important one of which would be to help people understand texts around a certain (set of) topic(s) in some context(s)."),(0,o.kt)("h3",{id:"criteria"},"Criteria"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"glossary")," is an alphabetical list of words or phrases with (short) explanations, that exists for the purpose of helping people to get a first understanding of the meaning of each word in the scope/context for which the glossary is created."),(0,o.kt)("h3",{id:"examples"},"Examples"),(0,o.kt)("p",null,"Examples include the ",(0,o.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/essifLab-glossary"},"eSSIF-Lab Glossary"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://sovrin.org/library/glossary/"},"Sovrin Glossary"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://www.internetsociety.org/internet/glossary-internet-terms/"},"Glossary of Internet Terms"),", and glossaries for Legal Terms, e.g. of the ",(0,o.kt)("a",{parentName:"p",href:"https://www.uscourts.gov/glossary"},"US"),", ",(0,o.kt)("a",{parentName:"p",href:"https://www.supremecourt.gov.sg/services/self-help-services/glossary-of-terms"},"Singapore"),", the ",(0,o.kt)("a",{parentName:"p",href:"https://www.copfs.gov.uk/involved-in-a-case/glossary-of-legal-terms"},"UK"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/041f13b2.4ca14422.js b/assets/js/041f13b2.1770777a.js similarity index 98% rename from assets/js/041f13b2.4ca14422.js rename to assets/js/041f13b2.1770777a.js index 228a7fc33..10e537407 100644 --- a/assets/js/041f13b2.4ca14422.js +++ b/assets/js/041f13b2.1770777a.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[792],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>d});var i=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function c(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var a=i.createContext({}),l=function(e){var t=i.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},p=function(e){var t=l(e.components);return i.createElement(a.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},u=i.forwardRef((function(e,t){var r=e.components,n=e.mdxType,s=e.originalType,a=e.parentName,p=o(e,["components","mdxType","originalType","parentName"]),u=l(r),d=n,m=u["".concat(a,".").concat(d)]||u[d]||f[d]||s;return r?i.createElement(m,c(c({ref:t},p),{},{components:r})):i.createElement(m,c({ref:t},p))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=r.length,c=new Array(s);c[0]=u;var o={};for(var a in t)hasOwnProperty.call(t,a)&&(o[a]=t[a]);o.originalType=e,o.mdxType="string"==typeof e?e:n,c[1]=o;for(var l=2;l{r.d(t,{Z:()=>v});var i=r(7294),n=r(6010),s=r(3438),c=r(9960),o=r(3919),a=r(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:r}=e;return i.createElement(c.Z,{href:t,className:(0,n.Z)("card padding--lg",l)},r)}function d(e){let{href:t,icon:r,title:s,description:c}=e;return i.createElement(u,{href:t},i.createElement("h2",{className:(0,n.Z)("text--truncate",p),title:s},r," ",s),c&&i.createElement("p",{className:(0,n.Z)("text--truncate",f),title:c},c))}function m(e){let{item:t}=e;const r=(0,s.Wl)(t);return r?i.createElement(d,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,a.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const r=(0,o.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",n=(0,s.xz)(t.docId??void 0);return i.createElement(d,{href:t.href,icon:r,title:t.label,description:t.description??n?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return i.createElement(h,{item:t});case"category":return i.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const r=(0,s.jA)();return i.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return i.createElement(g,e);const c=(0,s.MN)(t);return i.createElement("section",{className:(0,n.Z)("row",r)},c.map(((e,t)=>i.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},i.createElement(y,{item:e})))))}},2865:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>o,default:()=>u,frontMatter:()=>c,metadata:()=>a,toc:()=>p});var i=r(3117),n=(r(7294),r(3905)),s=r(2991);const c={id:"specs-files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2."},o="Specifications - Files",a={unversionedId:"categories/specs-files",id:"categories/specs-files",title:"Specifications - Files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2.",source:"@site/docs/categories/32-specs-files.md",sourceDirName:"categories",slug:"/categories/specs-files",permalink:"/tev2-specifications/docs/categories/specs-files",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/32-specs-files.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:32,frontMatter:{id:"specs-files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2."},sidebar:"tev2SideBar",previous:{title:"Specifications",permalink:"/tev2-specifications/docs/categories/specs"},next:{title:"Curated Text Files",permalink:"/tev2-specifications/docs/specs/files/curated-text-file"}},l={},p=[],f={toc:p};function u(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,i.Z)({},f,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"specifications---files"},"Specifications - Files"),(0,n.kt)("p",null,"This section contains the specifications for the various FILES (types) that are used within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,n.kt)(s.Z,{folder:"/docs/specs/files",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[792],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>d});var i=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function c(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var a=i.createContext({}),l=function(e){var t=i.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},p=function(e){var t=l(e.components);return i.createElement(a.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},u=i.forwardRef((function(e,t){var r=e.components,n=e.mdxType,s=e.originalType,a=e.parentName,p=o(e,["components","mdxType","originalType","parentName"]),u=l(r),d=n,m=u["".concat(a,".").concat(d)]||u[d]||f[d]||s;return r?i.createElement(m,c(c({ref:t},p),{},{components:r})):i.createElement(m,c({ref:t},p))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=r.length,c=new Array(s);c[0]=u;var o={};for(var a in t)hasOwnProperty.call(t,a)&&(o[a]=t[a]);o.originalType=e,o.mdxType="string"==typeof e?e:n,c[1]=o;for(var l=2;l{r.d(t,{Z:()=>v});var i=r(7294),n=r(6010),s=r(3438),c=r(9960),o=r(3919),a=r(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:r}=e;return i.createElement(c.Z,{href:t,className:(0,n.Z)("card padding--lg",l)},r)}function d(e){let{href:t,icon:r,title:s,description:c}=e;return i.createElement(u,{href:t},i.createElement("h2",{className:(0,n.Z)("text--truncate",p),title:s},r," ",s),c&&i.createElement("p",{className:(0,n.Z)("text--truncate",f),title:c},c))}function m(e){let{item:t}=e;const r=(0,s.Wl)(t);return r?i.createElement(d,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,a.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const r=(0,o.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",n=(0,s.xz)(t.docId??void 0);return i.createElement(d,{href:t.href,icon:r,title:t.label,description:t.description??n?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return i.createElement(h,{item:t});case"category":return i.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const r=(0,s.jA)();return i.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return i.createElement(g,e);const c=(0,s.MN)(t);return i.createElement("section",{className:(0,n.Z)("row",r)},c.map(((e,t)=>i.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},i.createElement(y,{item:e})))))}},2865:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>o,default:()=>u,frontMatter:()=>c,metadata:()=>a,toc:()=>p});var i=r(3117),n=(r(7294),r(3905)),s=r(2991);const c={id:"specs-files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2."},o="Specifications - Files",a={unversionedId:"categories/specs-files",id:"categories/specs-files",title:"Specifications - Files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2.",source:"@site/docs/categories/32-specs-files.md",sourceDirName:"categories",slug:"/categories/specs-files",permalink:"/tev2-specifications/docs/categories/specs-files",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/32-specs-files.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:32,frontMatter:{id:"specs-files",description:"This section contains the specifications of the various FILES (types) that are used within TEv2."},sidebar:"tev2SideBar",previous:{title:"Specifications",permalink:"/tev2-specifications/docs/categories/specs"},next:{title:"Curated Text Files",permalink:"/tev2-specifications/docs/specs/files/curated-text-file"}},l={},p=[],f={toc:p};function u(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,i.Z)({},f,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"specifications---files"},"Specifications - Files"),(0,n.kt)("p",null,"This section contains the specifications for the various FILES (types) that are used within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,n.kt)(s.Z,{folder:"/docs/specs/files",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/042aab58.881ad9e7.js b/assets/js/042aab58.e8b29007.js similarity index 99% rename from assets/js/042aab58.881ad9e7.js rename to assets/js/042aab58.e8b29007.js index 320c45d28..75e3bdcb7 100644 --- a/assets/js/042aab58.881ad9e7.js +++ b/assets/js/042aab58.e8b29007.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6854],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>h});var s=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function a(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,s)}return i}function r(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=s.createContext({}),m=function(e){var t=s.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},p=function(e){var t=m(e.components);return s.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},d=s.forwardRef((function(e,t){var i=e.components,n=e.mdxType,a=e.originalType,c=e.parentName,p=o(e,["components","mdxType","originalType","parentName"]),d=m(i),h=n,u=d["".concat(c,".").concat(h)]||d[h]||l[h]||a;return i?s.createElement(u,r(r({ref:t},p),{},{components:i})):s.createElement(u,r({ref:t},p))}));function h(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=i.length,r=new Array(a);r[0]=d;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,r[1]=o;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>l,frontMatter:()=>a,metadata:()=>o,toc:()=>m});var s=i(3117),n=(i(7294),i(3905));const a={id:"semantics",displayed_sidebar:"tev2SideBar",term:"semantics",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"a mapping between the (tangible/textual) [terms](@) and (intangible) ideas/[concepts](@) - their meaning.",grouptags:[],formPhrases:["semantics"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Semantics",o={unversionedId:"terms/semantics",id:"terms/semantics",title:"Semantics",description:"Summary",source:"@site/docs/terms/semantics.md",sourceDirName:"terms",slug:"/terms/semantics",permalink:"/tev2-specifications/docs/terms/semantics",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/semantics.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"semantics",displayed_sidebar:"tev2SideBar",term:"semantics",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"a mapping between the (tangible/textual) [terms](@) and (intangible) ideas/[concepts](@) - their meaning.",grouptags:[],formPhrases:["semantics"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3}],p={toc:m};function l(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,s.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"semantics"},"Semantics"),(0,n.kt)("h3",{id:"summary"},"Summary"),(0,n.kt)("p",null,"We use the term ",(0,n.kt)("strong",{parentName:"p"},"semantics")," to refer to the mapping between (tangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (their meaning, the ideas behind it). Semantics are scoped, i.e. every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has its own semantic mapping. This implies that every ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has - and maintains - its own (subjective) semantics, which is its subjective mapping of a set of terms onto the concepts/ideas in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". The (erroneous) assumption that ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would (automagically) share a semantics is the cause of many misunderstandings, and hence should be identified and deleted as soon as possible."),(0,n.kt)("p",null,"In the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern"),", the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation")," ",(0,n.kt)("inlineCode",{parentName:"p"},"refers to")," from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," to ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," represents the semantics of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms"),"."),(0,n.kt)("h3",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"The ability to distinguish between (non)semantics helps us to better understand one another, because it makes one aware of the fact that semantics is subjective, and its owner can update it. This allows such an owner to (temporarily) use terms in the same meaning as another ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", specifically if they agree to use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"good definitions"),"."),(0,n.kt)("h3",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A semantics is a mapping, in a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", between (tangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (their meaning, the ideas behind it)."))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6854],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>h});var s=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function a(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,s)}return i}function r(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=s.createContext({}),m=function(e){var t=s.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},p=function(e){var t=m(e.components);return s.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},d=s.forwardRef((function(e,t){var i=e.components,n=e.mdxType,a=e.originalType,c=e.parentName,p=o(e,["components","mdxType","originalType","parentName"]),d=m(i),h=n,u=d["".concat(c,".").concat(h)]||d[h]||l[h]||a;return i?s.createElement(u,r(r({ref:t},p),{},{components:i})):s.createElement(u,r({ref:t},p))}));function h(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=i.length,r=new Array(a);r[0]=d;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,r[1]=o;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>l,frontMatter:()=>a,metadata:()=>o,toc:()=>m});var s=i(3117),n=(i(7294),i(3905));const a={id:"semantics",displayed_sidebar:"tev2SideBar",term:"semantics",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"a mapping between the (tangible/textual) [terms](@) and (intangible) ideas/[concepts](@) - their meaning.",grouptags:[],formPhrases:["semantics"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Semantics",o={unversionedId:"terms/semantics",id:"terms/semantics",title:"Semantics",description:"Summary",source:"@site/docs/terms/semantics.md",sourceDirName:"terms",slug:"/terms/semantics",permalink:"/tev2-specifications/docs/terms/semantics",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/semantics.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"semantics",displayed_sidebar:"tev2SideBar",term:"semantics",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"a mapping between the (tangible/textual) [terms](@) and (intangible) ideas/[concepts](@) - their meaning.",grouptags:[],formPhrases:["semantics"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3}],p={toc:m};function l(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,s.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"semantics"},"Semantics"),(0,n.kt)("h3",{id:"summary"},"Summary"),(0,n.kt)("p",null,"We use the term ",(0,n.kt)("strong",{parentName:"p"},"semantics")," to refer to the mapping between (tangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (their meaning, the ideas behind it). Semantics are scoped, i.e. every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has its own semantic mapping. This implies that every ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has - and maintains - its own (subjective) semantics, which is its subjective mapping of a set of terms onto the concepts/ideas in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". The (erroneous) assumption that ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would (automagically) share a semantics is the cause of many misunderstandings, and hence should be identified and deleted as soon as possible."),(0,n.kt)("p",null,"In the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern"),", the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation")," ",(0,n.kt)("inlineCode",{parentName:"p"},"refers to")," from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," to ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," represents the semantics of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms"),"."),(0,n.kt)("h3",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"The ability to distinguish between (non)semantics helps us to better understand one another, because it makes one aware of the fact that semantics is subjective, and its owner can update it. This allows such an owner to (temporarily) use terms in the same meaning as another ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", specifically if they agree to use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"good definitions"),"."),(0,n.kt)("h3",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A semantics is a mapping, in a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", between (tangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (their meaning, the ideas behind it)."))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/073edd59.7b803a37.js b/assets/js/073edd59.9b239b69.js similarity index 99% rename from assets/js/073edd59.7b803a37.js rename to assets/js/073edd59.9b239b69.js index 5b0303faf..0200d2af7 100644 --- a/assets/js/073edd59.7b803a37.js +++ b/assets/js/073edd59.9b239b69.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1480],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>f});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},m=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,m=r(e,["components","mdxType","originalType","parentName"]),d=h(i),f=s,p=d["".concat(c,".").concat(f)]||d[f]||l[f]||o;return i?a.createElement(p,n(n({ref:t},m),{},{components:i})):a.createElement(p,n({ref:t},m))}));function f(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,n=new Array(o);n[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:s,n[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>r,default:()=>d,frontMatter:()=>n,metadata:()=>c,toc:()=>m});var a=i(3117),s=(i(7294),i(3905)),o=i(4996);const n={id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"pattern",isa:null,glossaryTerm:"Terminology Pattern",glossaryText:"a [mental model](@) that describes the relations between a [community](@), its (intangible) [knowledge](@essif-lab), and the artifacts we use to document that [knowledge](@essif-lab), such as [terms](@), [definitions](@), [mental models](@), [glossaries](@), etc.",grouptags:[],formPhrases:["terminology-pattern{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Create and Maintain Terminologies",c={unversionedId:"terms/patterns/terminology",id:"terms/patterns/terminology",title:"Create and Maintain Terminologies",description:"This mental model describes the relations between a community, its (intangible) knowledge, and the artifacts we use to document that knowledge, such as terms, definitions, mental models, glossaries, etc.",source:"@site/docs/terms/patterns/pattern-terminology.md",sourceDirName:"terms/patterns",slug:"/terms/patterns/terminology",permalink:"/tev2-specifications/docs/terms/patterns/terminology",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/patterns/pattern-terminology.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"pattern",isa:null,glossaryTerm:"Terminology Pattern",glossaryText:"a [mental model](@) that describes the relations between a [community](@), its (intangible) [knowledge](@essif-lab), and the artifacts we use to document that [knowledge](@essif-lab), such as [terms](@), [definitions](@), [mental models](@), [glossaries](@), etc.",grouptags:[],formPhrases:["terminology-pattern{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar",previous:{title:"Initial Requirements",permalink:"/tev2-specifications/docs/overview/tev2-requirements"},next:{title:"Guides",permalink:"/tev2-specifications/docs/categories/guides"}},h={},m=[{value:"Introduction",id:"introduction",level:3},{value:"Formalized model",id:"formalized-model",level:3},{value:"White: Parties, Communities",id:"white",level:4},{value:"Green: Scopes - Data Artifacts for Referencing and Documenting Knowledge",id:"green",level:4},{value:"Yellow: Intangible Concepts",id:"yellow",level:4}],l={toc:m};function d(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"create-and-maintain-terminologies"},"Create and Maintain Terminologies"),(0,s.kt)("p",null,"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("p",null,"It aims to serve the following purposes:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"enabling members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", as well as other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", to document their understanding of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," (e.g., ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),") that are relevant for their purposes (i.e., for realizing their ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),")."),(0,s.kt)("li",{parentName:"ul"},"provide a solid basis for the design and development of a ",(0,s.kt)("a",{parentName:"li",href:"/docs-overview"},"set of IT tools")," that support ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," as they document their ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),".")),(0,s.kt)("h3",{id:"introduction"},"Introduction"),(0,s.kt)("p",null,"This pattern has two basic parts:"),(0,s.kt)("ol",null,(0,s.kt)("li",{parentName:"ol"},"the ",(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"management"),"-related part. This part consists of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owns")," its particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," which exist for establishing cooperation between its members, and for which it needs to establish and maintain, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"Managing, or curating")," a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of realizing the ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," that the terminology is intended to serve, i.e. to establish a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", the quality of which is meant to be such that")),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," use them in the same, single meaning, thereby preventing difficulties in their cooperation, caused by differences in the individual understandings of words or phrases, and"),(0,s.kt)("li",{parentName:"ul"},"non non-members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can obtain a precise understanding of the communications within that community.\nAlso, this ",(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"management")," may cause reference documents to be created and maintained, e.g. a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that lists the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that includes its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as well as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," from other, related ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities"),".")),(0,s.kt)("ol",{start:2},(0,s.kt)("li",{parentName:"ol"},"the terminology-related part. This is where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live. This part is what one needs to create tools/support for managing and maintaining a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". Here, we have ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," with their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," as a means to refer to either. A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," live in the same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," there must be a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),". Within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is associated with precisely one such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),". However, within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," pair may be referred to by multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", which are then synonyms or aliases of each other.")),(0,s.kt)("h3",{id:"formalized-model"},"Formalized model"),(0,s.kt)("p",null,"Here is a visual representation of this pattern, using the following ",(0,s.kt)("strong",{parentName:"p"},(0,s.kt)("a",{parentName:"strong",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions")),":"),(0,s.kt)("img",{alt:"Conceptual model of the 'pattern-terminology' pattern",src:(0,o.Z)("images/pattern-terminology-support.png")}),(0,s.kt)("p",null,"The figure shows three areas:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#white"},"white area")," has the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that deal with the organization of this."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#green"},"green area")," represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in which at most one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," lives, and that also includes ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),". The (contents of the) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is curated (developed, maintained) by a single so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),"."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#yellow"},"yellow area")," represents a ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", in which intangible artifacts such as ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," reside.")),(0,s.kt)("h4",{id:"white"},"White: Parties, Communities"),(0,s.kt)("p",null,"Members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that want or need to collaborate with each other may feel the need for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that helps to effectively prevent any misunderstandings within the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that may hamper collaboration. ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," typically express this need as a wish for creating a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),"."),(0,s.kt)("p",null,"Our ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"model")," expresses this idea by saying that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can commit to use a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", that can be represented/rendered as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"(human readable) glossary (HRG)")," (which can not only be generated in different formats (e.g. as a PDF, HTML website, etc.), but also have customized data in its entries). When a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," is committed to use a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", this means that whenever any of its members uses a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," from that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," in some communication, then the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is documented (by means of artifacts in the ",(0,s.kt)("a",{parentName:"p",href:"#green"},"green area"),"."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," is a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (whose members are called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators"),") that aims to serve/support specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," (including perhaps itself) by enabling them to:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"prevent misunderstandings amongst their members, and"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," communications in such a way that the likelihood of non-members misunderstanding such communications is minimized."),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," these ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," itself, producing results that include: - one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," that each render the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that it curates; - the specification of (any number of) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," that either - identify a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (and thereby implicitly also its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),") - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scope tags"),", or - can be associated with ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," as a means of grouping the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," define - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"group tags"),". - identify a specific version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version tags"),".")),(0,s.kt)("p",null,"We refer the reader to"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"/docs/manuals/curator/curator-overview"},"Curators Manual"),", for further details about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation"),"."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{href:"/framework/docs/terms/pattern-governance-and-management",title:"The Governance and Management pattern explains how Parties organize that their Objectives are realized, either by doing the associated work themselves, or by arranging for other Parties to do that."},"governance and management pattern")," to learn more about ways in which different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," can seek to serve each other.")),(0,s.kt)("p",null,"Note that for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," to serve itself, it may want to commit to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," such as the one we are developing here."),(0,s.kt)("h4",{id:"green"},"Green: Scopes - Data Artifacts for Referencing and Documenting Knowledge"),(0,s.kt)("p",null,"Every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is scoped, i.e. part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," consists of various other things, including ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"typed"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", various kinds of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags"),", and more (see the figure above). These components of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," exist for as long as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," exists."),(0,s.kt)("p",null,"The central ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," in this part is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", as it ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"documents")," a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", provides its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," (when appropriate), and specifies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," that represents such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," as well as its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),". It also contains various other data, e.g. the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"term type")," (which is also the type of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," that identify the groups of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," to which (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that) it (documents,) belongs, etc. Basically, ",(0,s.kt)("em",{parentName:"p"},"any")," changes to documentation or attributes related to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," are done in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("p",null,"Another important ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", i.e. a ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#entries"},"(machine readable) representation")," of the meta data of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it refers to. Note that this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," need not reside in the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that owns the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (in which case it would mainly consists of the header data of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), but can also reside in another ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," (in which case it would be a copy of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),")."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is a ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#structure"},"structure")," that consists of some meta-data followed by a set of such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," (with some meta data added). Within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," (and hence also multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),") can exist, e.g., which are distinguished between by their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version tags"),"."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," will typically a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," - the human readable equivalent of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". However, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," may be created from the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," that exist. Also, different renderings of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," may lead to the creation of different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs"),". The kinds of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," to be generated depend on the specific needs of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that will be using it."),(0,s.kt)("p",null,"Note that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," is derived from a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". We foresee that in the future, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", which document ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", can also be generated, but that would not be part of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", but rather an activity that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," could do itself."),(0,s.kt)("p",null,"Apart from the multiplicity constrained that are showed in the figure, some additional rules apply:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," should identify at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and hence be part of (at least) one of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," (and every of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),") that is specified by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", represents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("li",{parentName:"ul"},"If a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", then that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," defines the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents, and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," (and every of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),") that is specified by that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," will (implicitly) refer to that definition.")),(0,s.kt)("p",null,"When we say that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curates")," a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", this means that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that define ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that are relevant for realizing its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),";"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and designate which of them is to be considered the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("li",{parentName:"ul"},"ensures that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of:",(0,s.kt)("ul",{parentName:"li"},(0,s.kt)("li",{parentName:"ul"},"at least one term for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," that is part of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and"),(0,s.kt)("li",{parentName:"ul"},"at least one term for any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," (which is part of ",(0,s.kt)("em",{parentName:"li"},"another")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", i.e. curated by another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),") that defines a concept that is relevant for realizing one or more ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),"."))),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) the various ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," in the scope, i.e. defines a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," (if necessary) for the different versions of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and (optionally) any ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," for grouping sets of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),".")),(0,s.kt)("h4",{id:"yellow"},"Yellow: Intangible Concepts"),(0,s.kt)("p",null,"The intangible ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," (e.g., ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns")," etc.) are important because this is where the misunderstandings live. The ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," uses a subjective ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," of the world (that the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has perceived to be living in for as long as it exists) for its individual reasoning, arguing, communicating, decision making etc. Because of this, two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that collaborate (i.e.: form a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") cannot be expected to have the same conceptualizations. However, it is a common belief that if one uses a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," to refer to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", the other will then relate it to 'the same' ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," within its own knowledge, that we should not assume actually exists. For example, when one of them uses the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," 'identity', it knows which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that relates to within its own ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". However, others need to hallucinate as to what that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," might be, and typically respond by thinking that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to in their own ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," would be its intended meaning. In many cases that doesn't pose a problem, because the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," of both ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledges")," are 'sufficiently the same'. In other cases, the differences in meaning may be such that it disrupts the collaboration between the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),". And that is when it helps to have 'good ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),"', because they have the property that collaborators can assess whether or not the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in their ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," (that a well-defined ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to) are 'sufficiently the same'."),(0,s.kt)("p",null,"In order to keep the work of devising ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," to a minimum, it helps to know the ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," that the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," collaboratively seek to realize. Any ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," should define a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that is relevant for that collaboration. Other definitions are just useless work."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1480],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>f});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},m=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,m=r(e,["components","mdxType","originalType","parentName"]),d=h(i),f=s,p=d["".concat(c,".").concat(f)]||d[f]||l[f]||o;return i?a.createElement(p,n(n({ref:t},m),{},{components:i})):a.createElement(p,n({ref:t},m))}));function f(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,n=new Array(o);n[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:s,n[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>r,default:()=>d,frontMatter:()=>n,metadata:()=>c,toc:()=>m});var a=i(3117),s=(i(7294),i(3905)),o=i(4996);const n={id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"pattern",isa:null,glossaryTerm:"Terminology Pattern",glossaryText:"a [mental model](@) that describes the relations between a [community](@), its (intangible) [knowledge](@essif-lab), and the artifacts we use to document that [knowledge](@essif-lab), such as [terms](@), [definitions](@), [mental models](@), [glossaries](@), etc.",grouptags:[],formPhrases:["terminology-pattern{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Create and Maintain Terminologies",c={unversionedId:"terms/patterns/terminology",id:"terms/patterns/terminology",title:"Create and Maintain Terminologies",description:"This mental model describes the relations between a community, its (intangible) knowledge, and the artifacts we use to document that knowledge, such as terms, definitions, mental models, glossaries, etc.",source:"@site/docs/terms/patterns/pattern-terminology.md",sourceDirName:"terms/patterns",slug:"/terms/patterns/terminology",permalink:"/tev2-specifications/docs/terms/patterns/terminology",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/patterns/pattern-terminology.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"pattern",isa:null,glossaryTerm:"Terminology Pattern",glossaryText:"a [mental model](@) that describes the relations between a [community](@), its (intangible) [knowledge](@essif-lab), and the artifacts we use to document that [knowledge](@essif-lab), such as [terms](@), [definitions](@), [mental models](@), [glossaries](@), etc.",grouptags:[],formPhrases:["terminology-pattern{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar",previous:{title:"Initial Requirements",permalink:"/tev2-specifications/docs/overview/tev2-requirements"},next:{title:"Guides",permalink:"/tev2-specifications/docs/categories/guides"}},h={},m=[{value:"Introduction",id:"introduction",level:3},{value:"Formalized model",id:"formalized-model",level:3},{value:"White: Parties, Communities",id:"white",level:4},{value:"Green: Scopes - Data Artifacts for Referencing and Documenting Knowledge",id:"green",level:4},{value:"Yellow: Intangible Concepts",id:"yellow",level:4}],l={toc:m};function d(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"create-and-maintain-terminologies"},"Create and Maintain Terminologies"),(0,s.kt)("p",null,"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("p",null,"It aims to serve the following purposes:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"enabling members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", as well as other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", to document their understanding of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," (e.g., ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),") that are relevant for their purposes (i.e., for realizing their ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),")."),(0,s.kt)("li",{parentName:"ul"},"provide a solid basis for the design and development of a ",(0,s.kt)("a",{parentName:"li",href:"/docs-overview"},"set of IT tools")," that support ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," as they document their ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),".")),(0,s.kt)("h3",{id:"introduction"},"Introduction"),(0,s.kt)("p",null,"This pattern has two basic parts:"),(0,s.kt)("ol",null,(0,s.kt)("li",{parentName:"ol"},"the ",(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"management"),"-related part. This part consists of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owns")," its particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," which exist for establishing cooperation between its members, and for which it needs to establish and maintain, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"Managing, or curating")," a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of realizing the ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," that the terminology is intended to serve, i.e. to establish a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", the quality of which is meant to be such that")),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," use them in the same, single meaning, thereby preventing difficulties in their cooperation, caused by differences in the individual understandings of words or phrases, and"),(0,s.kt)("li",{parentName:"ul"},"non non-members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can obtain a precise understanding of the communications within that community.\nAlso, this ",(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"management")," may cause reference documents to be created and maintained, e.g. a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that lists the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that includes its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as well as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," from other, related ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities"),".")),(0,s.kt)("ol",{start:2},(0,s.kt)("li",{parentName:"ol"},"the terminology-related part. This is where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live. This part is what one needs to create tools/support for managing and maintaining a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". Here, we have ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," with their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," as a means to refer to either. A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," live in the same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," there must be a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),". Within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is associated with precisely one such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),". However, within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," pair may be referred to by multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", which are then synonyms or aliases of each other.")),(0,s.kt)("h3",{id:"formalized-model"},"Formalized model"),(0,s.kt)("p",null,"Here is a visual representation of this pattern, using the following ",(0,s.kt)("strong",{parentName:"p"},(0,s.kt)("a",{parentName:"strong",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions")),":"),(0,s.kt)("img",{alt:"Conceptual model of the 'pattern-terminology' pattern",src:(0,o.Z)("images/pattern-terminology-support.png")}),(0,s.kt)("p",null,"The figure shows three areas:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#white"},"white area")," has the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that deal with the organization of this."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#green"},"green area")," represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in which at most one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," lives, and that also includes ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),". The (contents of the) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is curated (developed, maintained) by a single so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),"."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"#yellow"},"yellow area")," represents a ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", in which intangible artifacts such as ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," reside.")),(0,s.kt)("h4",{id:"white"},"White: Parties, Communities"),(0,s.kt)("p",null,"Members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that want or need to collaborate with each other may feel the need for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that helps to effectively prevent any misunderstandings within the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that may hamper collaboration. ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," typically express this need as a wish for creating a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),"."),(0,s.kt)("p",null,"Our ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"model")," expresses this idea by saying that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can commit to use a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", that can be represented/rendered as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"(human readable) glossary (HRG)")," (which can not only be generated in different formats (e.g. as a PDF, HTML website, etc.), but also have customized data in its entries). When a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," is committed to use a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", this means that whenever any of its members uses a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," from that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," in some communication, then the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is documented (by means of artifacts in the ",(0,s.kt)("a",{parentName:"p",href:"#green"},"green area"),"."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," is a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (whose members are called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators"),") that aims to serve/support specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," (including perhaps itself) by enabling them to:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"prevent misunderstandings amongst their members, and"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," communications in such a way that the likelihood of non-members misunderstanding such communications is minimized."),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," these ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," itself, producing results that include: - one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," that each render the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that it curates; - the specification of (any number of) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," that either - identify a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (and thereby implicitly also its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),") - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scope tags"),", or - can be associated with ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," as a means of grouping the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," define - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"group tags"),". - identify a specific version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," - the so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version tags"),".")),(0,s.kt)("p",null,"We refer the reader to"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{parentName:"li",href:"/docs/manuals/curator/curator-overview"},"Curators Manual"),", for further details about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation"),"."),(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("a",{href:"/framework/docs/terms/pattern-governance-and-management",title:"The Governance and Management pattern explains how Parties organize that their Objectives are realized, either by doing the associated work themselves, or by arranging for other Parties to do that."},"governance and management pattern")," to learn more about ways in which different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," can seek to serve each other.")),(0,s.kt)("p",null,"Note that for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," to serve itself, it may want to commit to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," such as the one we are developing here."),(0,s.kt)("h4",{id:"green"},"Green: Scopes - Data Artifacts for Referencing and Documenting Knowledge"),(0,s.kt)("p",null,"Every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is scoped, i.e. part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," consists of various other things, including ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"typed"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", various kinds of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags"),", and more (see the figure above). These components of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," exist for as long as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," exists."),(0,s.kt)("p",null,"The central ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," in this part is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", as it ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"documents")," a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", provides its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," (when appropriate), and specifies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," that represents such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," as well as its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),". It also contains various other data, e.g. the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"term type")," (which is also the type of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," that identify the groups of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," to which (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that) it (documents,) belongs, etc. Basically, ",(0,s.kt)("em",{parentName:"p"},"any")," changes to documentation or attributes related to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," are done in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("p",null,"Another important ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", i.e. a ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#entries"},"(machine readable) representation")," of the meta data of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it refers to. Note that this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," need not reside in the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that owns the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (in which case it would mainly consists of the header data of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), but can also reside in another ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," (in which case it would be a copy of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),")."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is a ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#structure"},"structure")," that consists of some meta-data followed by a set of such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," (with some meta data added). Within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," (and hence also multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),") can exist, e.g., which are distinguished between by their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"version tags"),"."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," will typically a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," - the human readable equivalent of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". However, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," may be created from the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," that exist. Also, different renderings of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," may lead to the creation of different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs"),". The kinds of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," to be generated depend on the specific needs of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that will be using it."),(0,s.kt)("p",null,"Note that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," is derived from a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),". We foresee that in the future, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", which document ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from multiple ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", can also be generated, but that would not be part of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", but rather an activity that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," could do itself."),(0,s.kt)("p",null,"Apart from the multiplicity constrained that are showed in the figure, some additional rules apply:"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," should identify at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and hence be part of (at least) one of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," (and every of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),") that is specified by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", represents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("li",{parentName:"ul"},"If a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", then that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," defines the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents, and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," (and every of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms"),") that is specified by that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," will (implicitly) refer to that definition.")),(0,s.kt)("p",null,"When we say that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curates")," a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", this means that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that define ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that are relevant for realizing its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),";"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and designate which of them is to be considered the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("li",{parentName:"ul"},"ensures that a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of:",(0,s.kt)("ul",{parentName:"li"},(0,s.kt)("li",{parentName:"ul"},"at least one term for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," that is part of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and"),(0,s.kt)("li",{parentName:"ul"},"at least one term for any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," (which is part of ",(0,s.kt)("em",{parentName:"li"},"another")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", i.e. curated by another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),") that defines a concept that is relevant for realizing one or more ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),"."))),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{href:"/framework/docs/terms/management",title:"Management: the act or process of managing or actually realizing of (the results associated with) a set of Objectives by the Owner of these Objectives."},"manages")," (creates/maintains) the various ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," in the scope, i.e. defines a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," (if necessary) for the different versions of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and (optionally) any ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," for grouping sets of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),".")),(0,s.kt)("h4",{id:"yellow"},"Yellow: Intangible Concepts"),(0,s.kt)("p",null,"The intangible ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," (e.g., ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns")," etc.) are important because this is where the misunderstandings live. The ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," uses a subjective ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," of the world (that the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has perceived to be living in for as long as it exists) for its individual reasoning, arguing, communicating, decision making etc. Because of this, two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that collaborate (i.e.: form a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") cannot be expected to have the same conceptualizations. However, it is a common belief that if one uses a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," to refer to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", the other will then relate it to 'the same' ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," within its own knowledge, that we should not assume actually exists. For example, when one of them uses the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," 'identity', it knows which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that relates to within its own ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". However, others need to hallucinate as to what that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," might be, and typically respond by thinking that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to in their own ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," would be its intended meaning. In many cases that doesn't pose a problem, because the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," of both ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledges")," are 'sufficiently the same'. In other cases, the differences in meaning may be such that it disrupts the collaboration between the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),". And that is when it helps to have 'good ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),"', because they have the property that collaborators can assess whether or not the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in their ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," (that a well-defined ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to) are 'sufficiently the same'."),(0,s.kt)("p",null,"In order to keep the work of devising ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," to a minimum, it helps to know the ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," that the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," collaboratively seek to realize. Any ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," should define a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that is relevant for that collaboration. Other definitions are just useless work."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/07990011.e6ded4ee.js b/assets/js/07990011.e1b1648a.js similarity index 99% rename from assets/js/07990011.e6ded4ee.js rename to assets/js/07990011.e1b1648a.js index 33694c01e..defe14a42 100644 --- a/assets/js/07990011.e6ded4ee.js +++ b/assets/js/07990011.e1b1648a.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2595],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=r.createContext({}),h=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},d=function(e){var t=h(e.components);return r.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=h(a),p=o,m=u["".concat(c,".").concat(p)]||u[p]||l[p]||n;return a?r.createElement(m,s(s({ref:t},d),{},{components:a})):r.createElement(m,s({ref:t},d))}));function p(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,s=new Array(n);s[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:o,s[1]=i;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>l,frontMatter:()=>n,metadata:()=>i,toc:()=>h});var r=a(3117),o=(a(7294),a(3905));const n={id:"author",displayed_sidebar:"tev2SideBar",term:"author",termType:"concept",isa:null,glossaryTerm:"Author",glossaryText:"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.",grouptags:[],formPhrases:["author{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Author",i={unversionedId:"terms/author",id:"terms/author",title:"Author",description:"An Author is a person that creates a text that is meant to be read and understood by others - usually, a particular audience. They do so to convey a message, or to stimulate or enable them to do particular things. Whitepapers, opinion papers, specifications, standardization texts, advertisements, memo's, mails, etc. could just as well not have been written if they did not have that property.",source:"@site/docs/terms/author.md",sourceDirName:"terms",slug:"/terms/author",permalink:"/tev2-specifications/docs/terms/author",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/author.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"author",displayed_sidebar:"tev2SideBar",term:"author",termType:"concept",isa:null,glossaryTerm:"Author",glossaryText:"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.",grouptags:[],formPhrases:["author{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[],d={toc:h};function l(e){let{components:t,...a}=e;return(0,o.kt)("wrapper",(0,r.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"author"},"Author"),(0,o.kt)("p",null,"An ",(0,o.kt)("strong",{parentName:"p"},"Author")," is a person that creates a text that is meant to be read and understood by others - usually, a particular audience. They do so to convey a message, or to stimulate or enable them to do particular things. Whitepapers, opinion papers, specifications, standardization texts, advertisements, memo's, mails, etc. could just as well not have been written if they did not have that property."),(0,o.kt)("p",null,"For us, a high-quality text is a text that not only has a specific audience and serves one or more specific purposes, but also a text that doesn't require its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to 'hallucinate', i.e. make assumptions so as to understand the intention of its author. Such texts are typically well-suited for specifications, standards, educational materials etc. However, there are also situations in which this kind of quality is not necessary (e.g., in management summaries, or casual notes), or even counter-productive (e.g., in advertisements)."),(0,o.kt)("p",null,"In order to write a high-quality text, its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author(s)")," not only need the appropriate knowledge about the topic of the text; they must have (or create) a conscious understanding of that knowledge that enables them to describe what they mean to say using ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"words and phrases")," that have a sufficiently well-defined meaning. This is not trivial: often, people that have knowledge about some topic can demonstrate that they do (using the knowledge), while not being capable of expressing the knowledge itself in a fashion that enables ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to learn it.",(0,o.kt)("sup",{parentName:"p",id:"fnref-1"},(0,o.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1"))," Also, it takes discipline to (re)write texts so that in the end, all important ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are used in the way they are defined, and are used consistently and coherently."),(0,o.kt)("div",{className:"footnotes"},(0,o.kt)("hr",{parentName:"div"}),(0,o.kt)("ol",{parentName:"div"},(0,o.kt)("li",{parentName:"ol",id:"fn-1"},"For example, people that are native speakers of a language, can usually demonstrate their knowledge of the specifications of that language (its grammar), by showing that they can (1) determine whether or not a sentence in that language is grammatically correct, (2) correct the sentences that were incorrect and (3) come up with (say) 5 alternatives for correcting an incorrect sentence, and picking out 'the most beautiful', or 'the best' one. However, when asked whether they could write down the specifications such that the result is consistent, coherent, complete, cogent, congruent - and other c-words that refer to characteristics that specifications are typically expected to have, they will say 'no'. Even worse: if they are presented a booklet that is about the grammar of their mother's tongue, and are asked to determine whether or not it specifies that grammar in a consistent, coherent, complete, etc. way, they will also decline.",(0,o.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2595],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=r.createContext({}),h=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},d=function(e){var t=h(e.components);return r.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=h(a),p=o,m=u["".concat(c,".").concat(p)]||u[p]||l[p]||n;return a?r.createElement(m,s(s({ref:t},d),{},{components:a})):r.createElement(m,s({ref:t},d))}));function p(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,s=new Array(n);s[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:o,s[1]=i;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>l,frontMatter:()=>n,metadata:()=>i,toc:()=>h});var r=a(3117),o=(a(7294),a(3905));const n={id:"author",displayed_sidebar:"tev2SideBar",term:"author",termType:"concept",isa:null,glossaryTerm:"Author",glossaryText:"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.",grouptags:[],formPhrases:["author{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Author",i={unversionedId:"terms/author",id:"terms/author",title:"Author",description:"An Author is a person that creates a text that is meant to be read and understood by others - usually, a particular audience. They do so to convey a message, or to stimulate or enable them to do particular things. Whitepapers, opinion papers, specifications, standardization texts, advertisements, memo's, mails, etc. could just as well not have been written if they did not have that property.",source:"@site/docs/terms/author.md",sourceDirName:"terms",slug:"/terms/author",permalink:"/tev2-specifications/docs/terms/author",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/author.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"author",displayed_sidebar:"tev2SideBar",term:"author",termType:"concept",isa:null,glossaryTerm:"Author",glossaryText:"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.",grouptags:[],formPhrases:["author{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[],d={toc:h};function l(e){let{components:t,...a}=e;return(0,o.kt)("wrapper",(0,r.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"author"},"Author"),(0,o.kt)("p",null,"An ",(0,o.kt)("strong",{parentName:"p"},"Author")," is a person that creates a text that is meant to be read and understood by others - usually, a particular audience. They do so to convey a message, or to stimulate or enable them to do particular things. Whitepapers, opinion papers, specifications, standardization texts, advertisements, memo's, mails, etc. could just as well not have been written if they did not have that property."),(0,o.kt)("p",null,"For us, a high-quality text is a text that not only has a specific audience and serves one or more specific purposes, but also a text that doesn't require its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to 'hallucinate', i.e. make assumptions so as to understand the intention of its author. Such texts are typically well-suited for specifications, standards, educational materials etc. However, there are also situations in which this kind of quality is not necessary (e.g., in management summaries, or casual notes), or even counter-productive (e.g., in advertisements)."),(0,o.kt)("p",null,"In order to write a high-quality text, its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author(s)")," not only need the appropriate knowledge about the topic of the text; they must have (or create) a conscious understanding of that knowledge that enables them to describe what they mean to say using ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"words and phrases")," that have a sufficiently well-defined meaning. This is not trivial: often, people that have knowledge about some topic can demonstrate that they do (using the knowledge), while not being capable of expressing the knowledge itself in a fashion that enables ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to learn it.",(0,o.kt)("sup",{parentName:"p",id:"fnref-1"},(0,o.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1"))," Also, it takes discipline to (re)write texts so that in the end, all important ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are used in the way they are defined, and are used consistently and coherently."),(0,o.kt)("div",{className:"footnotes"},(0,o.kt)("hr",{parentName:"div"}),(0,o.kt)("ol",{parentName:"div"},(0,o.kt)("li",{parentName:"ol",id:"fn-1"},"For example, people that are native speakers of a language, can usually demonstrate their knowledge of the specifications of that language (its grammar), by showing that they can (1) determine whether or not a sentence in that language is grammatically correct, (2) correct the sentences that were incorrect and (3) come up with (say) 5 alternatives for correcting an incorrect sentence, and picking out 'the most beautiful', or 'the best' one. However, when asked whether they could write down the specifications such that the result is consistent, coherent, complete, cogent, congruent - and other c-words that refer to characteristics that specifications are typically expected to have, they will say 'no'. Even worse: if they are presented a booklet that is about the grammar of their mother's tongue, and are asked to determine whether or not it specifies that grammar in a consistent, coherent, complete, etc. way, they will also decline.",(0,o.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/07ce2141.5636b8f5.js b/assets/js/07ce2141.3d933862.js similarity index 98% rename from assets/js/07ce2141.5636b8f5.js rename to assets/js/07ce2141.3d933862.js index b0838cbeb..4b4d62592 100644 --- a/assets/js/07ce2141.5636b8f5.js +++ b/assets/js/07ce2141.3d933862.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3459],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>d});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function a(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=r.createContext({}),l=function(e){var t=r.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):a(a({},t),e)),n},p=function(e){var t=l(e.components);return r.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,p=c(e,["components","mdxType","originalType","parentName"]),u=l(n),d=o,f=u["".concat(s,".").concat(d)]||u[d]||m[d]||i;return n?r.createElement(f,a(a({ref:t},p),{},{components:n})):r.createElement(f,a({ref:t},p))}));function d(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=n.length,a=new Array(i);a[0]=u;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,a[1]=c;for(var l=2;l{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>a,default:()=>m,frontMatter:()=>i,metadata:()=>c,toc:()=>l});var r=n(3117),o=(n(7294),n(3905));const i={id:"making-hovertexts-work"},a="Making Hovertexts Work",c={unversionedId:"miscellaneous/making-hovertexts-work",id:"miscellaneous/making-hovertexts-work",title:"Making Hovertexts Work",description:"Example: Docusaurus custom.css file",source:"@site/docs/miscellaneous/making-hovertexts-work.md",sourceDirName:"miscellaneous",slug:"/miscellaneous/making-hovertexts-work",permalink:"/tev2-specifications/docs/miscellaneous/making-hovertexts-work",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/miscellaneous/making-hovertexts-work.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"making-hovertexts-work"},sidebar:"tev2SideBar",previous:{title:"Miscellaneous",permalink:"/tev2-specifications/docs/categories/miscellaneous"},next:{title:"Notations and Conventions",permalink:"/tev2-specifications/docs/miscellaneous/notations-and-conventions"}},s={},l=[],p={toc:l};function m(e){let{components:t,...n}=e;return(0,o.kt)("wrapper",(0,r.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"making-hovertexts-work"},"Making Hovertexts Work"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example: Docusaurus `custom.css` file"),"/** * Any CSS included here will be global. The classic template * bundles Infima by default. Infima is a CSS framework designed to * work well for content-centric websites. */",(0,o.kt)("p",null,"/",(0,o.kt)("em",{parentName:"p"}," You can override the default Infima variables here. "),"/\n:root {\n--ifm-color-primary: #ac3c7a;\n--ifm-color-primary-dark: #9b366e;\n--ifm-color-primary-darker: #923368;\n--ifm-color-primary-darkest: #782a55;\n--ifm-color-primary-light: #bd4286;\n--ifm-color-primary-lighter: #c04b8c;\n--ifm-color-primary-lightest: #c9649c;\n--ifm-code-font-size: 95%;\n}\nhtml","[data-theme='dark']"," {\nbackground: var(--ifm-color-emphasis-100);\n}"),(0,o.kt)("p",null,".docusaurus-highlight-code-line {\nbackground-color: rgb(72, 77, 91);\ndisplay: block;\nmargin: 0 calc(-1 * var(--ifm-pre-padding));\npadding: 0 var(--ifm-pre-padding);\n}"),(0,o.kt)("p",null,".hero\n.button.button--secondary.button--outline:not(.button--active):not(:hover) {\ncolor: var(--ifm-color-secondary);\n}"),(0,o.kt)("p",null,"a","[hovertext]"," {\nposition: relative;\ncursor: help;\nfont-weight: 600;\n}"),(0,o.kt)("p",null,"a","[hovertext]","::after {\ncontent: attr(hoverText);\nposition: absolute;\nwidth: max-content;\nbackground: var(--ifm-color-content);\ncolor: var(--ifm-color-content-inverse);\nfont-size: var(--ifm-code-font-size);\nfont-weight: 400;\nmax-width: 25vw;\npadding: 4px 8px;\nborder-radius: 4px;\nline-height: 1.2em;\nwhite-space: pre-wrap;\nword-break: break-word;\ntop: calc(100% + 10px);\ntransform: translateX(-50%);\ntransition: opacity 0.3s, visibility 0.3s;\npointer-events: none;\nz-index: 1;\nopacity: 0;\nvisibility: hidden;\n}"),(0,o.kt)("p",null,"a","[hovertext]",":hover::after {\nvisibility: visible;\nopacity: .95;\n}")))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3459],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>d});var r=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function a(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=r.createContext({}),l=function(e){var t=r.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):a(a({},t),e)),n},p=function(e){var t=l(e.components);return r.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var n=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,p=c(e,["components","mdxType","originalType","parentName"]),u=l(n),d=o,f=u["".concat(s,".").concat(d)]||u[d]||m[d]||i;return n?r.createElement(f,a(a({ref:t},p),{},{components:n})):r.createElement(f,a({ref:t},p))}));function d(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=n.length,a=new Array(i);a[0]=u;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,a[1]=c;for(var l=2;l{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>a,default:()=>m,frontMatter:()=>i,metadata:()=>c,toc:()=>l});var r=n(3117),o=(n(7294),n(3905));const i={id:"making-hovertexts-work"},a="Making Hovertexts Work",c={unversionedId:"miscellaneous/making-hovertexts-work",id:"miscellaneous/making-hovertexts-work",title:"Making Hovertexts Work",description:"Example: Docusaurus custom.css file",source:"@site/docs/miscellaneous/making-hovertexts-work.md",sourceDirName:"miscellaneous",slug:"/miscellaneous/making-hovertexts-work",permalink:"/tev2-specifications/docs/miscellaneous/making-hovertexts-work",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/miscellaneous/making-hovertexts-work.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"making-hovertexts-work"},sidebar:"tev2SideBar",previous:{title:"Miscellaneous",permalink:"/tev2-specifications/docs/categories/miscellaneous"},next:{title:"Notations and Conventions",permalink:"/tev2-specifications/docs/miscellaneous/notations-and-conventions"}},s={},l=[],p={toc:l};function m(e){let{components:t,...n}=e;return(0,o.kt)("wrapper",(0,r.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"making-hovertexts-work"},"Making Hovertexts Work"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example: Docusaurus `custom.css` file"),"/** * Any CSS included here will be global. The classic template * bundles Infima by default. Infima is a CSS framework designed to * work well for content-centric websites. */",(0,o.kt)("p",null,"/",(0,o.kt)("em",{parentName:"p"}," You can override the default Infima variables here. "),"/\n:root {\n--ifm-color-primary: #ac3c7a;\n--ifm-color-primary-dark: #9b366e;\n--ifm-color-primary-darker: #923368;\n--ifm-color-primary-darkest: #782a55;\n--ifm-color-primary-light: #bd4286;\n--ifm-color-primary-lighter: #c04b8c;\n--ifm-color-primary-lightest: #c9649c;\n--ifm-code-font-size: 95%;\n}\nhtml","[data-theme='dark']"," {\nbackground: var(--ifm-color-emphasis-100);\n}"),(0,o.kt)("p",null,".docusaurus-highlight-code-line {\nbackground-color: rgb(72, 77, 91);\ndisplay: block;\nmargin: 0 calc(-1 * var(--ifm-pre-padding));\npadding: 0 var(--ifm-pre-padding);\n}"),(0,o.kt)("p",null,".hero\n.button.button--secondary.button--outline:not(.button--active):not(:hover) {\ncolor: var(--ifm-color-secondary);\n}"),(0,o.kt)("p",null,"a","[hovertext]"," {\nposition: relative;\ncursor: help;\nfont-weight: 600;\n}"),(0,o.kt)("p",null,"a","[hovertext]","::after {\ncontent: attr(hoverText);\nposition: absolute;\nwidth: max-content;\nbackground: var(--ifm-color-content);\ncolor: var(--ifm-color-content-inverse);\nfont-size: var(--ifm-code-font-size);\nfont-weight: 400;\nmax-width: 25vw;\npadding: 4px 8px;\nborder-radius: 4px;\nline-height: 1.2em;\nwhite-space: pre-wrap;\nword-break: break-word;\ntop: calc(100% + 10px);\ntransform: translateX(-50%);\ntransition: opacity 0.3s, visibility 0.3s;\npointer-events: none;\nz-index: 1;\nopacity: 0;\nvisibility: hidden;\n}"),(0,o.kt)("p",null,"a","[hovertext]",":hover::after {\nvisibility: visible;\nopacity: .95;\n}")))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0bee8f31.3d540308.js b/assets/js/0bee8f31.00ae7519.js similarity index 98% rename from assets/js/0bee8f31.3d540308.js rename to assets/js/0bee8f31.00ae7519.js index 0932e1df3..9c92fc4c4 100644 --- a/assets/js/0bee8f31.3d540308.js +++ b/assets/js/0bee8f31.00ae7519.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2100],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var a=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var l=a.createContext({}),c=function(e){var t=a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},d=function(e){var t=c(e.components);return a.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var r=e.components,s=e.mdxType,n=e.originalType,l=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=c(r),f=s,m=u["".concat(l,".").concat(f)]||u[f]||p[f]||n;return r?a.createElement(m,o(o({ref:t},d),{},{components:r})):a.createElement(m,o({ref:t},d))}));function f(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=r.length,o=new Array(n);o[0]=u;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:s,o[1]=i;for(var c=2;c{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>o,default:()=>p,frontMatter:()=>n,metadata:()=>i,toc:()=>c});var a=r(3117),s=(r(7294),r(3905));const n={id:"glossarytext",displayed_sidebar:"tev2SideBar",term:"glossarytext",termType:"concept",isa:null,glossaryTerm:"Glossary Text",glossaryText:"a human readable text that will be used as the [definition](@) for a particular [term](@), as presented in a [HRG](@).",glossaryNotes:["the `glossaryText` field in a [curated text](@) can be used to specify the [glossary text](@) for a [definition](@)."],formPhrases:["glossarytext{ss}","glossary-text{ss}"]},o="Glossary Text",i={unversionedId:"terms/glossarytext",id:"terms/glossarytext",title:"Glossary Text",description:"A Glossary Text is a human readable text that will be used as the definition for a particular term, as presented in a HRG.",source:"@site/docs/terms/glossarytext.md",sourceDirName:"terms",slug:"/terms/glossarytext",permalink:"/tev2-specifications/docs/terms/glossarytext",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/glossarytext.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"glossarytext",displayed_sidebar:"tev2SideBar",term:"glossarytext",termType:"concept",isa:null,glossaryTerm:"Glossary Text",glossaryText:"a human readable text that will be used as the [definition](@) for a particular [term](@), as presented in a [HRG](@).",glossaryNotes:["the `glossaryText` field in a [curated text](@) can be used to specify the [glossary text](@) for a [definition](@)."],formPhrases:["glossarytext{ss}","glossary-text{ss}"]},sidebar:"tev2SideBar"},l={},c=[],d={toc:c};function p(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,a.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"glossary-text"},"Glossary Text"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Glossary Text")," is a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2100],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var a=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var l=a.createContext({}),c=function(e){var t=a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},d=function(e){var t=c(e.components);return a.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var r=e.components,s=e.mdxType,n=e.originalType,l=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=c(r),f=s,m=u["".concat(l,".").concat(f)]||u[f]||p[f]||n;return r?a.createElement(m,o(o({ref:t},d),{},{components:r})):a.createElement(m,o({ref:t},d))}));function f(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=r.length,o=new Array(n);o[0]=u;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:s,o[1]=i;for(var c=2;c{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>o,default:()=>p,frontMatter:()=>n,metadata:()=>i,toc:()=>c});var a=r(3117),s=(r(7294),r(3905));const n={id:"glossarytext",displayed_sidebar:"tev2SideBar",term:"glossarytext",termType:"concept",isa:null,glossaryTerm:"Glossary Text",glossaryText:"a human readable text that will be used as the [definition](@) for a particular [term](@), as presented in a [HRG](@).",glossaryNotes:["the `glossaryText` field in a [curated text](@) can be used to specify the [glossary text](@) for a [definition](@)."],formPhrases:["glossarytext{ss}","glossary-text{ss}"]},o="Glossary Text",i={unversionedId:"terms/glossarytext",id:"terms/glossarytext",title:"Glossary Text",description:"A Glossary Text is a human readable text that will be used as the definition for a particular term, as presented in a HRG.",source:"@site/docs/terms/glossarytext.md",sourceDirName:"terms",slug:"/terms/glossarytext",permalink:"/tev2-specifications/docs/terms/glossarytext",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/glossarytext.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"glossarytext",displayed_sidebar:"tev2SideBar",term:"glossarytext",termType:"concept",isa:null,glossaryTerm:"Glossary Text",glossaryText:"a human readable text that will be used as the [definition](@) for a particular [term](@), as presented in a [HRG](@).",glossaryNotes:["the `glossaryText` field in a [curated text](@) can be used to specify the [glossary text](@) for a [definition](@)."],formPhrases:["glossarytext{ss}","glossary-text{ss}"]},sidebar:"tev2SideBar"},l={},c=[],d={toc:c};function p(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,a.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"glossary-text"},"Glossary Text"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Glossary Text")," is a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0c0fc45c.0c67dc66.js b/assets/js/0c0fc45c.0c67dc66.js new file mode 100644 index 000000000..35e92cc7e --- /dev/null +++ b/assets/js/0c0fc45c.0c67dc66.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[803],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>d});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),p=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},l=function(e){var t=p(e.components);return n.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,a=e.originalType,c=e.parentName,l=i(e,["components","mdxType","originalType","parentName"]),f=p(r),d=o,m=f["".concat(c,".").concat(d)]||f[d]||u[d]||a;return r?n.createElement(m,s(s({ref:t},l),{},{components:r})):n.createElement(m,s({ref:t},l))}));function d(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=r.length,s=new Array(a);s[0]=f;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:o,s[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>u,frontMatter:()=>a,metadata:()=>i,toc:()=>p});var n=r(3117),o=(r(7294),r(3905));const a={term:"writer",glossaryTerm:"Writer",synonymOf:"author",formPhrases:["riter{ss}"]},s=void 0,i={unversionedId:"terms/writer",id:"terms/writer",title:"writer",description:"This text should not show anywhere, as it is a Synonym.",source:"@site/docs/terms/writer.md",sourceDirName:"terms",slug:"/terms/writer",permalink:"/tev2-specifications/docs/terms/writer",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/writer.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{term:"writer",glossaryTerm:"Writer",synonymOf:"author",formPhrases:["riter{ss}"]}},c={},p=[],l={toc:p};function u(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("p",null,"This text should not show anywhere, as it is a Synonym."),(0,o.kt)("p",null,"However ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"termrefs")," that use ",(0,o.kt)("inlineCode",{parentName:"p"},"writer")," should be resolved. If they are not, that should produce an error."),(0,o.kt)("p",null,"Let's see what ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Writer: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"writer")," does,\nOr, the ",(0,o.kt)("a",{parentName:"p",href:"@"},"writer's")," block..."),(0,o.kt)("p",null,"The term must have all properties of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),", except for the ",(0,o.kt)("inlineCode",{parentName:"p"},"formPhrases"),"."),(0,o.kt)("p",null,"Therefore, this term should also ",(0,o.kt)("a",{parentName:"p",href:"/docs/tev2-glossary#writer"},"appear in the glossary"),", where the ",(0,o.kt)("inlineCode",{parentName:"p"},"glossaryText")," should be that of ",(0,o.kt)("inlineCode",{parentName:"p"},"author"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0c0fc45c.f86ca1ed.js b/assets/js/0c0fc45c.f86ca1ed.js deleted file mode 100644 index cab05ca1e..000000000 --- a/assets/js/0c0fc45c.f86ca1ed.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[803],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},d=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=i(e,["components","mdxType","originalType","parentName"]),d=l(r),f=a,m=d["".concat(c,".").concat(f)]||d[f]||u[f]||o;return r?n.createElement(m,s(s({ref:t},p),{},{components:r})):n.createElement(m,s({ref:t},p))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,s=new Array(o);s[0]=d;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:a,s[1]=i;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>u,frontMatter:()=>o,metadata:()=>i,toc:()=>l});var n=r(3117),a=(r(7294),r(3905));const o={term:"writer",glossaryTerm:"Writer",synonymOf:"author",formPhrases:["writer{ss}"]},s=void 0,i={unversionedId:"terms/writer",id:"terms/writer",title:"writer",description:"This text should not show anywhere, as it is a Synonym.",source:"@site/docs/terms/writer.md",sourceDirName:"terms",slug:"/terms/writer",permalink:"/tev2-specifications/docs/terms/writer",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/writer.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{term:"writer",glossaryTerm:"Writer",synonymOf:"author",formPhrases:["writer{ss}"]}},c={},l=[],p={toc:l};function u(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"This text should not show anywhere, as it is a Synonym."),(0,a.kt)("p",null,"However ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"termrefs")," that use ",(0,a.kt)("inlineCode",{parentName:"p"},"writer")," should be resolved. If they are not, that should produce an error."),(0,a.kt)("p",null,"Let's see what ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Writer: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"writer")," does,\nOr, the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Writer: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"writer's")," block..."),(0,a.kt)("p",null,"The term must have all properties of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),", except for the ",(0,a.kt)("inlineCode",{parentName:"p"},"formPhrases"),"."),(0,a.kt)("p",null,"Therefore, this term should also ",(0,a.kt)("a",{parentName:"p",href:"/docs/tev2-glossary#writer"},"appear in the glossary"),", where the ",(0,a.kt)("inlineCode",{parentName:"p"},"glossaryText")," should be that of ",(0,a.kt)("inlineCode",{parentName:"p"},"author"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0cdee2ba.7978344f.js b/assets/js/0cdee2ba.f6fd2d51.js similarity index 98% rename from assets/js/0cdee2ba.7978344f.js rename to assets/js/0cdee2ba.f6fd2d51.js index a1430eb59..534512dec 100644 --- a/assets/js/0cdee2ba.7978344f.js +++ b/assets/js/0cdee2ba.f6fd2d51.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6135],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>u});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=n.createContext({}),m=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},p=function(e){var t=m(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},l=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),l=m(r),u=i,f=l["".concat(c,".").concat(u)]||l[u]||d[u]||o;return r?n.createElement(f,s(s({ref:t},p),{},{components:r})):n.createElement(f,s({ref:t},p))}));function u(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,s=new Array(o);s[0]=l;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var m=2;m{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>o,metadata:()=>a,toc:()=>m});var n=r(3117),i=(r(7294),r(3905));const o={id:"scoped-term",displayed_sidebar:"tev2SideBar",term:"scoped-term",termType:"concept",isa:"term",glossaryTerm:"Scoped Term",glossaryText:"a [term](@) that represents (and identifies) a specific [semantic unit](@) of a particular [community](@) (or [party](@)).",grouptags:[],formPhrases:["scoped-term{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Scoped Term",a={unversionedId:"terms/scoped-term",id:"terms/scoped-term",title:"Scoped Term",description:"Summary",source:"@site/docs/terms/scoped-term.md",sourceDirName:"terms",slug:"/terms/scoped-term",permalink:"/tev2-specifications/docs/terms/scoped-term",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scoped-term.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scoped-term",displayed_sidebar:"tev2SideBar",term:"scoped-term",termType:"concept",isa:"term",glossaryTerm:"Scoped Term",glossaryText:"a [term](@) that represents (and identifies) a specific [semantic unit](@) of a particular [community](@) (or [party](@)).",grouptags:[],formPhrases:["scoped-term{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3}],p={toc:m};function d(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"scoped-term"},"Scoped Term"),(0,i.kt)("h3",{id:"summary"},"Summary"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"scoped term")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,i.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,i.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6135],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>u});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=n.createContext({}),m=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},p=function(e){var t=m(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},l=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),l=m(r),u=i,f=l["".concat(c,".").concat(u)]||l[u]||d[u]||o;return r?n.createElement(f,s(s({ref:t},p),{},{components:r})):n.createElement(f,s({ref:t},p))}));function u(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,s=new Array(o);s[0]=l;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var m=2;m{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>o,metadata:()=>a,toc:()=>m});var n=r(3117),i=(r(7294),r(3905));const o={id:"scoped-term",displayed_sidebar:"tev2SideBar",term:"scoped-term",termType:"concept",isa:"term",glossaryTerm:"Scoped Term",glossaryText:"a [term](@) that represents (and identifies) a specific [semantic unit](@) of a particular [community](@) (or [party](@)).",grouptags:[],formPhrases:["scoped-term{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Scoped Term",a={unversionedId:"terms/scoped-term",id:"terms/scoped-term",title:"Scoped Term",description:"Summary",source:"@site/docs/terms/scoped-term.md",sourceDirName:"terms",slug:"/terms/scoped-term",permalink:"/tev2-specifications/docs/terms/scoped-term",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scoped-term.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scoped-term",displayed_sidebar:"tev2SideBar",term:"scoped-term",termType:"concept",isa:"term",glossaryTerm:"Scoped Term",glossaryText:"a [term](@) that represents (and identifies) a specific [semantic unit](@) of a particular [community](@) (or [party](@)).",grouptags:[],formPhrases:["scoped-term{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3}],p={toc:m};function d(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"scoped-term"},"Scoped Term"),(0,i.kt)("h3",{id:"summary"},"Summary"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"scoped term")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,i.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,i.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0fbf73e8.02a17bf7.js b/assets/js/0fbf73e8.be1f5572.js similarity index 99% rename from assets/js/0fbf73e8.02a17bf7.js rename to assets/js/0fbf73e8.be1f5572.js index 1c7212672..d7557b404 100644 --- a/assets/js/0fbf73e8.02a17bf7.js +++ b/assets/js/0fbf73e8.be1f5572.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9446],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>d});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},p=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),m=h(i),d=s,f=m["".concat(c,".").concat(d)]||m[d]||l[d]||o;return i?a.createElement(f,n(n({ref:t},p),{},{components:i})):a.createElement(f,n({ref:t},p))}));function d(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,n=new Array(o);n[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:s,n[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>o,metadata:()=>r,toc:()=>h});var a=i(3117),s=(i(7294),i(3905));const o={id:"tag",displayed_sidebar:"tev2SideBar",term:"tag",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"an alphanumeric string that is used to identify [scopes](@) (so called 'scopetags'), group [terms](@) (so called 'grouptags'), or identify a specific version of a [terminology](@) (so called 'versiontags') from within a specific [scope](@).",grouptags:[],formPhrases:["tag{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Tag",r={unversionedId:"terms/tag",id:"terms/tag",title:"Tag",description:"Summary",source:"@site/docs/terms/tag.md",sourceDirName:"terms",slug:"/terms/tag",permalink:"/tev2-specifications/docs/terms/tag",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/tag.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tag",displayed_sidebar:"tev2SideBar",term:"tag",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"an alphanumeric string that is used to identify [scopes](@) (so called 'scopetags'), group [terms](@) (so called 'grouptags'), or identify a specific version of a [terminology](@) (so called 'versiontags') from within a specific [scope](@).",grouptags:[],formPhrases:["tag{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Summary",id:"summary",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],p={toc:h};function l(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"tag"},"Tag"),(0,s.kt)("h3",{id:"summary"},"Summary"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Tag")," is an alphanumeric string that satisfies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),", and that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("p",null,"Scopetags identify a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (from within a given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), and hence can be used (within that given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") to disambiguate ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". For example, ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab:term")," is an identifier for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by the scopetag ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab")," is referred to by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," 'term'."),(0,s.kt)("p",null,"Grouptags may be used within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to tag various sorts or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns")," and the like. One can then say that this grouptag represents the group of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are associated with that tag. This may be used for different purposes. One example is to tag every term that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," with a pattern-specific tag."),(0,s.kt)("p",null,"Versiontags are used to identify a specific version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," within which the versiontag lives. It may have various forms, and would typically be chosen such that it comes in handy with the tools that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," has decided to use to curate that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"criteria"},"Criteria"),(0,s.kt)("p",null,"is an alphanumeric string that is used within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," and/or group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", and/or identify a version of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". The alphanumeric string satisfies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("h3",{id:"examples"},"Examples"),(0,s.kt)("p",null,"Examples of scopetags are ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"toip"),", or ",(0,s.kt)("inlineCode",{parentName:"p"},"ctwg")),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("p",null,"Discussions about which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," a tag should satisfy must be held with care. For example, one might argue that allowing the ",(0,s.kt)("inlineCode",{parentName:"p"},".")," character for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," might be beneficial. However, allowing a ",(0,s.kt)("inlineCode",{parentName:"p"},".")," character in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," may cause problems with (the alternative syntax) of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", as email address in square brackets might then qualify as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," while that is very likely not the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"'s intention."))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9446],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>d});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},p=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),m=h(i),d=s,f=m["".concat(c,".").concat(d)]||m[d]||l[d]||o;return i?a.createElement(f,n(n({ref:t},p),{},{components:i})):a.createElement(f,n({ref:t},p))}));function d(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,n=new Array(o);n[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:s,n[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>o,metadata:()=>r,toc:()=>h});var a=i(3117),s=(i(7294),i(3905));const o={id:"tag",displayed_sidebar:"tev2SideBar",term:"tag",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"an alphanumeric string that is used to identify [scopes](@) (so called 'scopetags'), group [terms](@) (so called 'grouptags'), or identify a specific version of a [terminology](@) (so called 'versiontags') from within a specific [scope](@).",grouptags:[],formPhrases:["tag{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Tag",r={unversionedId:"terms/tag",id:"terms/tag",title:"Tag",description:"Summary",source:"@site/docs/terms/tag.md",sourceDirName:"terms",slug:"/terms/tag",permalink:"/tev2-specifications/docs/terms/tag",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/tag.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tag",displayed_sidebar:"tev2SideBar",term:"tag",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"an alphanumeric string that is used to identify [scopes](@) (so called 'scopetags'), group [terms](@) (so called 'grouptags'), or identify a specific version of a [terminology](@) (so called 'versiontags') from within a specific [scope](@).",grouptags:[],formPhrases:["tag{ss}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Summary",id:"summary",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],p={toc:h};function l(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"tag"},"Tag"),(0,s.kt)("h3",{id:"summary"},"Summary"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Tag")," is an alphanumeric string that satisfies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),", and that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("p",null,"Scopetags identify a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (from within a given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), and hence can be used (within that given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") to disambiguate ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". For example, ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab:term")," is an identifier for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," that within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," identified by the scopetag ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab")," is referred to by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," 'term'."),(0,s.kt)("p",null,"Grouptags may be used within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to tag various sorts or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns")," and the like. One can then say that this grouptag represents the group of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are associated with that tag. This may be used for different purposes. One example is to tag every term that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," with a pattern-specific tag."),(0,s.kt)("p",null,"Versiontags are used to identify a specific version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," within which the versiontag lives. It may have various forms, and would typically be chosen such that it comes in handy with the tools that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," has decided to use to curate that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"criteria"},"Criteria"),(0,s.kt)("p",null,"is an alphanumeric string that is used within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," and/or group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", and/or identify a version of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". The alphanumeric string satisfies the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("h3",{id:"examples"},"Examples"),(0,s.kt)("p",null,"Examples of scopetags are ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"toip"),", or ",(0,s.kt)("inlineCode",{parentName:"p"},"ctwg")),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("p",null,"Discussions about which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," a tag should satisfy must be held with care. For example, one might argue that allowing the ",(0,s.kt)("inlineCode",{parentName:"p"},".")," character for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," might be beneficial. However, allowing a ",(0,s.kt)("inlineCode",{parentName:"p"},".")," character in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," may cause problems with (the alternative syntax) of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", as email address in square brackets might then qualify as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," while that is very likely not the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"'s intention."))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0ff14827.6d184dcd.js b/assets/js/0ff14827.a1867dff.js similarity index 98% rename from assets/js/0ff14827.6d184dcd.js rename to assets/js/0ff14827.a1867dff.js index 10813e237..f2ed64812 100644 --- a/assets/js/0ff14827.6d184dcd.js +++ b/assets/js/0ff14827.a1867dff.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4456],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>f});var s=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,s)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=s.createContext({}),l=function(e){var t=s.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},p=function(e){var t=l(e.components);return s.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},d=s.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=n(e,["components","mdxType","originalType","parentName"]),d=l(r),f=a,h=d["".concat(c,".").concat(f)]||d[f]||u[f]||o;return r?s.createElement(h,i(i({ref:t},p),{},{components:r})):s.createElement(h,i({ref:t},p))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=d;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:a,i[1]=n;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>n,toc:()=>l});var s=r(3117),a=(r(7294),r(3905));const o={id:"hrg-list",displayed_sidebar:"tev2SideBar",term:"hrg-list",termType:"concept",isa:null,glossaryTerm:"HRG List",glossaryText:"a list of alphabetically sorted [HRG entries](@) that can be further processed by tools such as the [TRRT](@), as well as rendering tools such as GitHub pages, Docusaurus, etc.",grouptags:[],formPhrases:["hrg-list{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG List",n={unversionedId:"terms/hrg-list",id:"terms/hrg-list",title:"HRG List",description:"An HRG List is a list of alphabetically sorted HRG entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc.",source:"@site/docs/terms/hrg-list.md",sourceDirName:"terms",slug:"/terms/hrg-list",permalink:"/tev2-specifications/docs/terms/hrg-list",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg-list.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg-list",displayed_sidebar:"tev2SideBar",term:"hrg-list",termType:"concept",isa:null,glossaryTerm:"HRG List",glossaryText:"a list of alphabetically sorted [HRG entries](@) that can be further processed by tools such as the [TRRT](@), as well as rendering tools such as GitHub pages, Docusaurus, etc.",grouptags:[],formPhrases:["hrg-list{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],p={toc:l};function u(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,s.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"hrg-list"},"HRG List"),(0,a.kt)("p",null,"An ",(0,a.kt)("strong",{parentName:"p"},"HRG List")," is a list of alphabetically sorted ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,a.kt)("p",null,"An HRG List is the result of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," processing a particular ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4456],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>f});var s=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);t&&(s=s.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,s)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(s=0;s=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=s.createContext({}),l=function(e){var t=s.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},p=function(e){var t=l(e.components);return s.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return s.createElement(s.Fragment,{},t)}},d=s.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=n(e,["components","mdxType","originalType","parentName"]),d=l(r),f=a,h=d["".concat(c,".").concat(f)]||d[f]||u[f]||o;return r?s.createElement(h,i(i({ref:t},p),{},{components:r})):s.createElement(h,i({ref:t},p))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=d;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:a,i[1]=n;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>n,toc:()=>l});var s=r(3117),a=(r(7294),r(3905));const o={id:"hrg-list",displayed_sidebar:"tev2SideBar",term:"hrg-list",termType:"concept",isa:null,glossaryTerm:"HRG List",glossaryText:"a list of alphabetically sorted [HRG entries](@) that can be further processed by tools such as the [TRRT](@), as well as rendering tools such as GitHub pages, Docusaurus, etc.",grouptags:[],formPhrases:["hrg-list{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG List",n={unversionedId:"terms/hrg-list",id:"terms/hrg-list",title:"HRG List",description:"An HRG List is a list of alphabetically sorted HRG entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc.",source:"@site/docs/terms/hrg-list.md",sourceDirName:"terms",slug:"/terms/hrg-list",permalink:"/tev2-specifications/docs/terms/hrg-list",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg-list.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg-list",displayed_sidebar:"tev2SideBar",term:"hrg-list",termType:"concept",isa:null,glossaryTerm:"HRG List",glossaryText:"a list of alphabetically sorted [HRG entries](@) that can be further processed by tools such as the [TRRT](@), as well as rendering tools such as GitHub pages, Docusaurus, etc.",grouptags:[],formPhrases:["hrg-list{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],p={toc:l};function u(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,s.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"hrg-list"},"HRG List"),(0,a.kt)("p",null,"An ",(0,a.kt)("strong",{parentName:"p"},"HRG List")," is a list of alphabetically sorted ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,a.kt)("p",null,"An HRG List is the result of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," processing a particular ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1025d2dd.d3adf1b9.js b/assets/js/1025d2dd.2b27ebf5.js similarity index 99% rename from assets/js/1025d2dd.d3adf1b9.js rename to assets/js/1025d2dd.2b27ebf5.js index 1439982e4..d91b6b28f 100644 --- a/assets/js/1025d2dd.d3adf1b9.js +++ b/assets/js/1025d2dd.2b27ebf5.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7842],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>h});var r=o(7294);function s(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function i(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,r)}return o}function n(e){for(var t=1;t=0||(s[o]=e[o]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(s[o]=e[o])}return s}var c=r.createContext({}),l=function(e){var t=r.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):n(n({},t),e)),o},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var o=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(o),h=s,d=u["".concat(c,".").concat(h)]||u[h]||f[h]||i;return o?r.createElement(d,n(n({ref:t},p),{},{components:o})):r.createElement(d,n({ref:t},p))}));function h(e,t){var o=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=o.length,n=new Array(i);n[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,n[1]=a;for(var l=2;l{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>i,metadata:()=>a,toc:()=>l});var r=o(3117),s=(o(7294),o(3905));const i={id:"tev2-text-conversion-tool",displayed_sidebar:"tev2SideBar",term:"tev2-text-conversion-tool",termType:"concept",isa:"tev2-tool",glossaryTerm:"TEv2 Text Conversion Tool",glossaryText:"a [TEv2 tool](@) whose purpose is to convert particular text constructs (such as [TermRefs](@) or [MRGRefs](@)) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",grouptags:[],formPhrases:["tev2-text-conversion-tool{ss}","text-conversion-tool{ss}","conversion-tool{ss}"],status:"proposed",created:20240108,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="TEv2 Text Conversion Tools",a={unversionedId:"terms/tev2-text-conversion-tool",id:"terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tools",description:"A TEv2 Text Conversion Tool is a TEv2 tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",source:"@site/docs/terms/tev2-text-conversion-tool.md",sourceDirName:"terms",slug:"/terms/tev2-text-conversion-tool",permalink:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/tev2-text-conversion-tool.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-text-conversion-tool",displayed_sidebar:"tev2SideBar",term:"tev2-text-conversion-tool",termType:"concept",isa:"tev2-tool",glossaryTerm:"TEv2 Text Conversion Tool",glossaryText:"a [TEv2 tool](@) whose purpose is to convert particular text constructs (such as [TermRefs](@) or [MRGRefs](@)) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",grouptags:[],formPhrases:["tev2-text-conversion-tool{ss}","text-conversion-tool{ss}","conversion-tool{ss}"],status:"proposed",created:20240108,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],p={toc:l};function f(e){let{components:t,...o}=e;return(0,s.kt)("wrapper",(0,r.Z)({},p,o,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"tev2-text-conversion-tools"},"TEv2 Text Conversion Tools"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"TEv2 Text Conversion Tool")," is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("p",null,"Examples of such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tools")," include the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("p",null,"All ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," follow the same ",(0,s.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"pattern for converting texts"),". This implies that each of them"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"has a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," and a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," and"),(0,s.kt)("li",{parentName:"ul"},"can be configured using a predefined or custom ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that match these profiles respectively.")))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7842],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>h});var r=o(7294);function s(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function i(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,r)}return o}function n(e){for(var t=1;t=0||(s[o]=e[o]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(s[o]=e[o])}return s}var c=r.createContext({}),l=function(e){var t=r.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):n(n({},t),e)),o},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var o=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(o),h=s,d=u["".concat(c,".").concat(h)]||u[h]||f[h]||i;return o?r.createElement(d,n(n({ref:t},p),{},{components:o})):r.createElement(d,n({ref:t},p))}));function h(e,t){var o=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=o.length,n=new Array(i);n[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,n[1]=a;for(var l=2;l{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>i,metadata:()=>a,toc:()=>l});var r=o(3117),s=(o(7294),o(3905));const i={id:"tev2-text-conversion-tool",displayed_sidebar:"tev2SideBar",term:"tev2-text-conversion-tool",termType:"concept",isa:"tev2-tool",glossaryTerm:"TEv2 Text Conversion Tool",glossaryText:"a [TEv2 tool](@) whose purpose is to convert particular text constructs (such as [TermRefs](@) or [MRGRefs](@)) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",grouptags:[],formPhrases:["tev2-text-conversion-tool{ss}","text-conversion-tool{ss}","conversion-tool{ss}"],status:"proposed",created:20240108,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="TEv2 Text Conversion Tools",a={unversionedId:"terms/tev2-text-conversion-tool",id:"terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tools",description:"A TEv2 Text Conversion Tool is a TEv2 tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",source:"@site/docs/terms/tev2-text-conversion-tool.md",sourceDirName:"terms",slug:"/terms/tev2-text-conversion-tool",permalink:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/tev2-text-conversion-tool.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-text-conversion-tool",displayed_sidebar:"tev2SideBar",term:"tev2-text-conversion-tool",termType:"concept",isa:"tev2-tool",glossaryTerm:"TEv2 Text Conversion Tool",glossaryText:"a [TEv2 tool](@) whose purpose is to convert particular text constructs (such as [TermRefs](@) or [MRGRefs](@)) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.",grouptags:[],formPhrases:["tev2-text-conversion-tool{ss}","text-conversion-tool{ss}","conversion-tool{ss}"],status:"proposed",created:20240108,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],p={toc:l};function f(e){let{components:t,...o}=e;return(0,s.kt)("wrapper",(0,r.Z)({},p,o,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"tev2-text-conversion-tools"},"TEv2 Text Conversion Tools"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"TEv2 Text Conversion Tool")," is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("p",null,"Examples of such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tools")," include the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("p",null,"All ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," follow the same ",(0,s.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"pattern for converting texts"),". This implies that each of them"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"has a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," and a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," and"),(0,s.kt)("li",{parentName:"ul"},"can be configured using a predefined or custom ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that match these profiles respectively.")))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1437a887.fc4c8ff5.js b/assets/js/1437a887.b0915ef3.js similarity index 99% rename from assets/js/1437a887.fc4c8ff5.js rename to assets/js/1437a887.b0915ef3.js index aa7332dd5..90871fc9b 100644 --- a/assets/js/1437a887.fc4c8ff5.js +++ b/assets/js/1437a887.b0915ef3.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1536],{3905:(e,t,o)=>{o.d(t,{Zo:()=>c,kt:()=>h});var i=o(7294);function a(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,i)}return o}function r(e){for(var t=1;t=0||(a[o]=e[o]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(a[o]=e[o])}return a}var l=i.createContext({}),p=function(e){var t=i.useContext(l),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},c=function(e){var t=p(e.components);return i.createElement(l.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},u=i.forwardRef((function(e,t){var o=e.components,a=e.mdxType,n=e.originalType,l=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),u=p(o),h=a,m=u["".concat(l,".").concat(h)]||u[h]||d[h]||n;return o?i.createElement(m,r(r({ref:t},c),{},{components:o})):i.createElement(m,r({ref:t},c))}));function h(e,t){var o=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=o.length,r=new Array(n);r[0]=u;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var p=2;p{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>d,frontMatter:()=>n,metadata:()=>s,toc:()=>p});var i=o(3117),a=(o(7294),o(3905));o(4996);const n={id:"tool-development",date:20221111},r="Tool Development",s={unversionedId:"miscellaneous/tool-development",id:"miscellaneous/tool-development",title:"Tool Development",description:"This page intends to provide (lots of pointers to) information that people may need in order to decide whether or not to contribute to the construction of the Terminology Engine v2 (TEv2) toolbox, and if so, determine where to help out.",source:"@site/docs/miscellaneous/tool-development.md",sourceDirName:"miscellaneous",slug:"/miscellaneous/tool-development",permalink:"/tev2-specifications/docs/miscellaneous/tool-development",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/miscellaneous/tool-development.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tool-development",date:20221111},sidebar:"tev2SideBar",previous:{title:"Notations and Conventions",permalink:"/tev2-specifications/docs/miscellaneous/notations-and-conventions"}},l={},p=[{value:"What it is about",id:"what-it-is-about",level:2},{value:"Pointers to what you need to know",id:"pointers-to-what-you-need-to-know",level:3},{value:"Tooling status as of ...",id:"tooling-status-as-of-",level:2},{value:"Under development",id:"under-development",level:3},{value:"High priority",id:"high-priority",level:3},{value:"Medium priority:",id:"medium-priority",level:3},{value:"Lower priority:",id:"lower-priority",level:3},{value:"Starting to contribute",id:"starting-to-contribute",level:2}],c={toc:p};function d(e){let{components:t,...o}=e;return(0,a.kt)("wrapper",(0,i.Z)({},c,o,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"tool-development"},"Tool Development"),(0,a.kt)("p",null,"This page intends to provide (lots of pointers to) information that people may need in order to decide whether or not to contribute to the construction of the Terminology Engine v2 (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),") toolbox, and if so, determine where to help out."),(0,a.kt)("h2",{id:"what-it-is-about"},"What it is about"),(0,a.kt)("p",null,"At the core of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," is ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"text conversion"),": every ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tool in the toolbox")," takes one or more input files, does some textual processing, and produces outputs. The basic ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion#steps"},"conversion pattern")," that individual ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," are expected to follow ensures that they can be easily extended, e.g., to operate on different input formats, or to produce alternative output formats."),(0,a.kt)("p",null,"There are various things that make the further development of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," challenging:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"the interop between individual tools: outputs of one tool must be fit for processing by another tool (which may include existing third party tools, such as static website generators), as described in the ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-architecture"},"TEv2 Architecture"),".")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"designing actual tools such that they can be easily extended (also by others) to accept different input formats, and/or produce different output formats, as described in the ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion#steps"},"text conversion steps pattern"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"designing tools such that they can be easily used in different contexts (e.g. whether or not to dockerize a tool)")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"collaborating with other people that work on the tools such that the coherence and consistent working of tools that different people develop is guaranteed. We may need to better organize this.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"making the tools automatically testable, e.g. by running test suites as part of the CI/CD street we envisage that tools would have.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"making the tools easy to integrate in CI/CD streets or other strategies that projects or working groups use to publish their documentation and whitepapers.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"for certain tools: making them easy to use in authoring processes, e.g. by enabling them to be used in real-time authoring processes (authors that type texts can immediately see, e.g. in a browser, what the effects are of what they have typed).")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Specifications may not exist, or need modification, which may impact other tools as well.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Tools should not use unnecessary resources (processing time, memory).")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"... (there are likely to be other challenges)"))),(0,a.kt)("h3",{id:"pointers-to-what-you-need-to-know"},"Pointers to what you need to know"),(0,a.kt)("admonition",{title:"Reading Materials",type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"In order to appreciate and come to grips with these challenges, it will definitely help if you read up on some more backgrounds of what we try to do. Here are some pointers:"),(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"The ",(0,a.kt)("a",{parentName:"li",href:"/docs/category/introduction-overview"},"TEv2 Overview")," (and its sub-documents) will provide you with with such backgrounds."),(0,a.kt)("li",{parentName:"ul"},"Other documented topics include:",(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/files"},"file structure spec")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/syntax"},"syntax specifications")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools"},"specifications of individual tools")," - not all specifications hare already been drafted/checked."))))),(0,a.kt)("h2",{id:"tooling-status-as-of-"},"Tooling status as of ..."),(0,a.kt)("p",null,'For the date of the tooling status, see the "',(0,a.kt)("i",null,"last updated on"),'" text at the bottom right on this page'),(0,a.kt)("h3",{id:"under-development"},"Under development"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),", which is in [this toip repo](https://github.com/trustoverip/ctwg-toolkit-mrg). The tool works, but still has some [bugs/issues](https://github.com/trustoverip/ctwg-toolkit-mrg/issues) that need to be fixed."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", which is currently actively developed by TNO in [this repo](https://github.com/tno-terminology-design/trrt).")),(0,a.kt)("h3",{id:"high-priority"},"High priority"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"ingress tools that convert wiki-files (and perhaps some other formats) into ",(0,a.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"curated texts"),";"),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),", so that we can actually generate human-readable glossaries. For this tool, specifications need to be further drafted (and agreed on).")),(0,a.kt)("h3",{id:"medium-priority"},"Medium priority:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/ict"},"ICT"),", which allows for integrity checking. The current specifications are outdated and first need to be revised.")),(0,a.kt)("h3",{id:"lower-priority"},"Lower priority:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"extensions for the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", and perhaps other tools, so that they can be used in ",(0,a.kt)("a",{parentName:"li",href:"https://dev.w3.org/2008/video/mediaann/ReSpec.js/documentation.html"},"ReSpec")," environments, such as often used for W3C standards."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/mrdt"},"MRDT")," and ",(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/hrdt"},"HRDT"))),(0,a.kt)("h2",{id:"starting-to-contribute"},"Starting to contribute"),(0,a.kt)("p",null,"If you are eager to contribute, then ping ",(0,a.kt)("inlineCode",{parentName:"p"},"rieks")," ",(0,a.kt)("inlineCode",{parentName:"p"},".")," ",(0,a.kt)("inlineCode",{parentName:"p"},"joosten")," ",(0,a.kt)("inlineCode",{parentName:"p"},"")," ",(0,a.kt)("inlineCode",{parentName:"p"},"tno")," ",(0,a.kt)("inlineCode",{parentName:"p"},".")," ",(0,a.kt)("inlineCode",{parentName:"p"},"nl"),", or attend a ",(0,a.kt)("a",{parentName:"p",href:"https://wiki.trustoverip.org/display/HOME/CTWG+Meeting+Pages"},"ToIP CTWG meeting"),", where you express your interest and/or questions, and we'll take it from there."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1536],{3905:(e,t,o)=>{o.d(t,{Zo:()=>c,kt:()=>h});var i=o(7294);function a(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,i)}return o}function r(e){for(var t=1;t=0||(a[o]=e[o]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(a[o]=e[o])}return a}var l=i.createContext({}),p=function(e){var t=i.useContext(l),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},c=function(e){var t=p(e.components);return i.createElement(l.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},u=i.forwardRef((function(e,t){var o=e.components,a=e.mdxType,n=e.originalType,l=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),u=p(o),h=a,m=u["".concat(l,".").concat(h)]||u[h]||d[h]||n;return o?i.createElement(m,r(r({ref:t},c),{},{components:o})):i.createElement(m,r({ref:t},c))}));function h(e,t){var o=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=o.length,r=new Array(n);r[0]=u;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var p=2;p{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>d,frontMatter:()=>n,metadata:()=>s,toc:()=>p});var i=o(3117),a=(o(7294),o(3905));o(4996);const n={id:"tool-development",date:20221111},r="Tool Development",s={unversionedId:"miscellaneous/tool-development",id:"miscellaneous/tool-development",title:"Tool Development",description:"This page intends to provide (lots of pointers to) information that people may need in order to decide whether or not to contribute to the construction of the Terminology Engine v2 (TEv2) toolbox, and if so, determine where to help out.",source:"@site/docs/miscellaneous/tool-development.md",sourceDirName:"miscellaneous",slug:"/miscellaneous/tool-development",permalink:"/tev2-specifications/docs/miscellaneous/tool-development",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/miscellaneous/tool-development.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tool-development",date:20221111},sidebar:"tev2SideBar",previous:{title:"Notations and Conventions",permalink:"/tev2-specifications/docs/miscellaneous/notations-and-conventions"}},l={},p=[{value:"What it is about",id:"what-it-is-about",level:2},{value:"Pointers to what you need to know",id:"pointers-to-what-you-need-to-know",level:3},{value:"Tooling status as of ...",id:"tooling-status-as-of-",level:2},{value:"Under development",id:"under-development",level:3},{value:"High priority",id:"high-priority",level:3},{value:"Medium priority:",id:"medium-priority",level:3},{value:"Lower priority:",id:"lower-priority",level:3},{value:"Starting to contribute",id:"starting-to-contribute",level:2}],c={toc:p};function d(e){let{components:t,...o}=e;return(0,a.kt)("wrapper",(0,i.Z)({},c,o,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"tool-development"},"Tool Development"),(0,a.kt)("p",null,"This page intends to provide (lots of pointers to) information that people may need in order to decide whether or not to contribute to the construction of the Terminology Engine v2 (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),") toolbox, and if so, determine where to help out."),(0,a.kt)("h2",{id:"what-it-is-about"},"What it is about"),(0,a.kt)("p",null,"At the core of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," is ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"text conversion"),": every ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tool in the toolbox")," takes one or more input files, does some textual processing, and produces outputs. The basic ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion#steps"},"conversion pattern")," that individual ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," are expected to follow ensures that they can be easily extended, e.g., to operate on different input formats, or to produce alternative output formats."),(0,a.kt)("p",null,"There are various things that make the further development of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," challenging:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"the interop between individual tools: outputs of one tool must be fit for processing by another tool (which may include existing third party tools, such as static website generators), as described in the ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-architecture"},"TEv2 Architecture"),".")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"designing actual tools such that they can be easily extended (also by others) to accept different input formats, and/or produce different output formats, as described in the ",(0,a.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion#steps"},"text conversion steps pattern"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"designing tools such that they can be easily used in different contexts (e.g. whether or not to dockerize a tool)")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"collaborating with other people that work on the tools such that the coherence and consistent working of tools that different people develop is guaranteed. We may need to better organize this.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"making the tools automatically testable, e.g. by running test suites as part of the CI/CD street we envisage that tools would have.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"making the tools easy to integrate in CI/CD streets or other strategies that projects or working groups use to publish their documentation and whitepapers.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"for certain tools: making them easy to use in authoring processes, e.g. by enabling them to be used in real-time authoring processes (authors that type texts can immediately see, e.g. in a browser, what the effects are of what they have typed).")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Specifications may not exist, or need modification, which may impact other tools as well.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Tools should not use unnecessary resources (processing time, memory).")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"... (there are likely to be other challenges)"))),(0,a.kt)("h3",{id:"pointers-to-what-you-need-to-know"},"Pointers to what you need to know"),(0,a.kt)("admonition",{title:"Reading Materials",type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"In order to appreciate and come to grips with these challenges, it will definitely help if you read up on some more backgrounds of what we try to do. Here are some pointers:"),(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"The ",(0,a.kt)("a",{parentName:"li",href:"/docs/category/introduction-overview"},"TEv2 Overview")," (and its sub-documents) will provide you with with such backgrounds."),(0,a.kt)("li",{parentName:"ul"},"Other documented topics include:",(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/files"},"file structure spec")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/syntax"},"syntax specifications")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools"},"specifications of individual tools")," - not all specifications hare already been drafted/checked."))))),(0,a.kt)("h2",{id:"tooling-status-as-of-"},"Tooling status as of ..."),(0,a.kt)("p",null,'For the date of the tooling status, see the "',(0,a.kt)("i",null,"last updated on"),'" text at the bottom right on this page'),(0,a.kt)("h3",{id:"under-development"},"Under development"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),", which is in [this toip repo](https://github.com/trustoverip/ctwg-toolkit-mrg). The tool works, but still has some [bugs/issues](https://github.com/trustoverip/ctwg-toolkit-mrg/issues) that need to be fixed."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", which is currently actively developed by TNO in [this repo](https://github.com/tno-terminology-design/trrt).")),(0,a.kt)("h3",{id:"high-priority"},"High priority"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"ingress tools that convert wiki-files (and perhaps some other formats) into ",(0,a.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"curated texts"),";"),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),", so that we can actually generate human-readable glossaries. For this tool, specifications need to be further drafted (and agreed on).")),(0,a.kt)("h3",{id:"medium-priority"},"Medium priority:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/ict"},"ICT"),", which allows for integrity checking. The current specifications are outdated and first need to be revised.")),(0,a.kt)("h3",{id:"lower-priority"},"Lower priority:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"extensions for the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", and perhaps other tools, so that they can be used in ",(0,a.kt)("a",{parentName:"li",href:"https://dev.w3.org/2008/video/mediaann/ReSpec.js/documentation.html"},"ReSpec")," environments, such as often used for W3C standards."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/mrdt"},"MRDT")," and ",(0,a.kt)("a",{parentName:"li",href:"/docs/specs/tools-envisaged/hrdt"},"HRDT"))),(0,a.kt)("h2",{id:"starting-to-contribute"},"Starting to contribute"),(0,a.kt)("p",null,"If you are eager to contribute, then ping ",(0,a.kt)("inlineCode",{parentName:"p"},"rieks")," ",(0,a.kt)("inlineCode",{parentName:"p"},".")," ",(0,a.kt)("inlineCode",{parentName:"p"},"joosten")," ",(0,a.kt)("inlineCode",{parentName:"p"},"")," ",(0,a.kt)("inlineCode",{parentName:"p"},"tno")," ",(0,a.kt)("inlineCode",{parentName:"p"},".")," ",(0,a.kt)("inlineCode",{parentName:"p"},"nl"),", or attend a ",(0,a.kt)("a",{parentName:"p",href:"https://wiki.trustoverip.org/display/HOME/CTWG+Meeting+Pages"},"ToIP CTWG meeting"),", where you express your interest and/or questions, and we'll take it from there."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1455ff6c.4d564629.js b/assets/js/1455ff6c.98da7e6e.js similarity index 98% rename from assets/js/1455ff6c.4d564629.js rename to assets/js/1455ff6c.98da7e6e.js index c9fff1be1..e653bdbaa 100644 --- a/assets/js/1455ff6c.4d564629.js +++ b/assets/js/1455ff6c.98da7e6e.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3321],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function a(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},d=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},u=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),u=l(r),f=o,m=u["".concat(c,".").concat(f)]||u[f]||p[f]||i;return r?n.createElement(m,a(a({ref:t},d),{},{components:r})):n.createElement(m,a({ref:t},d))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,a=new Array(i);a[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,a[1]=s;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>p,frontMatter:()=>i,metadata:()=>s,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const i={id:"curated-text-file",displayed_sidebar:"tev2SideBar",term:"curated-text-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Curated Text File",glossaryText:"a file that contains either a (complete) [curated text](@), or the [header](@) of that [curated text](@) and a reference to the [file](body-file@) that contains its [body](@).",grouptags:[],formPhrases:["curated-text-file{ss}","ctext-file{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a=void 0,s={unversionedId:"terms/curated-text-file",id:"terms/curated-text-file",title:"curated-text-file",description:"",source:"@site/docs/terms/curated-text-file.md",sourceDirName:"terms",slug:"/terms/curated-text-file",permalink:"/tev2-specifications/docs/terms/curated-text-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curated-text-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curated-text-file",displayed_sidebar:"tev2SideBar",term:"curated-text-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Curated Text File",glossaryText:"a file that contains either a (complete) [curated text](@), or the [header](@) of that [curated text](@) and a reference to the [file](body-file@) that contains its [body](@).",grouptags:[],formPhrases:["curated-text-file{ss}","ctext-file{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},d,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3321],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function a(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},d=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},u=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),u=l(r),f=o,m=u["".concat(c,".").concat(f)]||u[f]||p[f]||i;return r?n.createElement(m,a(a({ref:t},d),{},{components:r})):n.createElement(m,a({ref:t},d))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,a=new Array(i);a[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,a[1]=s;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>p,frontMatter:()=>i,metadata:()=>s,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const i={id:"curated-text-file",displayed_sidebar:"tev2SideBar",term:"curated-text-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Curated Text File",glossaryText:"a file that contains either a (complete) [curated text](@), or the [header](@) of that [curated text](@) and a reference to the [file](body-file@) that contains its [body](@).",grouptags:[],formPhrases:["curated-text-file{ss}","ctext-file{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a=void 0,s={unversionedId:"terms/curated-text-file",id:"terms/curated-text-file",title:"curated-text-file",description:"",source:"@site/docs/terms/curated-text-file.md",sourceDirName:"terms",slug:"/terms/curated-text-file",permalink:"/tev2-specifications/docs/terms/curated-text-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curated-text-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curated-text-file",displayed_sidebar:"tev2SideBar",term:"curated-text-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Curated Text File",glossaryText:"a file that contains either a (complete) [curated text](@), or the [header](@) of that [curated text](@) and a reference to the [file](body-file@) that contains its [body](@).",grouptags:[],formPhrases:["curated-text-file{ss}","ctext-file{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},d,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/156e271d.b12d1542.js b/assets/js/156e271d.ba3652dc.js similarity index 99% rename from assets/js/156e271d.b12d1542.js rename to assets/js/156e271d.ba3652dc.js index 43f8b0323..db071f253 100644 --- a/assets/js/156e271d.b12d1542.js +++ b/assets/js/156e271d.ba3652dc.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7082],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>f});var o=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function n(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=o.createContext({}),m=function(e){var t=o.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},h=function(e){var t=m(e.components);return o.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},d=o.forwardRef((function(e,t){var i=e.components,a=e.mdxType,s=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),d=m(i),f=a,p=d["".concat(c,".").concat(f)]||d[f]||l[f]||s;return i?o.createElement(p,n(n({ref:t},h),{},{components:i})):o.createElement(p,n({ref:t},h))}));function f(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var s=i.length,n=new Array(s);n[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,n[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var o=i(3117),a=(i(7294),i(3905));const s={id:"scope",displayed_sidebar:"tev2SideBar",term:"scope",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the extent of the [terms](@), [definitions](@) and other documentation that a [community](@) (or [party](@), which we call the [owner](@essif-lab) of the [scope](@)) needs to express, communicate and validate its [knowledge](@essif-lab) as relevant to achieving a specific subset of its [objectives](@essif-lab).",grouptags:[],formPhrases:["scope{ss}","scope-context{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Scope",r={unversionedId:"terms/scope",id:"terms/scope",title:"Scope",description:"Summary",source:"@site/docs/terms/scope.md",sourceDirName:"terms",slug:"/terms/scope",permalink:"/tev2-specifications/docs/terms/scope",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scope.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scope",displayed_sidebar:"tev2SideBar",term:"scope",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the extent of the [terms](@), [definitions](@) and other documentation that a [community](@) (or [party](@), which we call the [owner](@essif-lab) of the [scope](@)) needs to express, communicate and validate its [knowledge](@essif-lab) as relevant to achieving a specific subset of its [objectives](@essif-lab).",grouptags:[],formPhrases:["scope{ss}","scope-context{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],h={toc:m};function l(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,o.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"scope"},"Scope"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"scope")," is the extent of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,a.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,a.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,a.kt)("p",null,"Other documentation includes ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and artifacts that are generated from that, such as ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries")," and the like. It also includes ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," that can be used e.g. to refer to other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags"),"), identify different versions for artifacts (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags"),"), or create particular groups of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags"),")."),(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"Scopes"),", that is: their contents, must be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),". Since this requires particular capabilities that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," may lack, we say that this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," is done by a so-called ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community"),", whose members are individuals that do have such capabilities; they serve the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," as the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".",(0,a.kt)("p",null,"A ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," can contain multiple ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),"; it is expected that at least one such ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is committed to by the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community"),"."),(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"Scopes")," may overlap, or be nested, in a similar way as [namespaces](https://en.wikipedia.org/wiki/Namespace).",(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,a.kt)("h3",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"The purpose of having ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," is that it enables ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," (and other ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),") to come to develop and maintain ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are not only relevant for realizing specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),", but also are fit for expressing and communicating the ",(0,a.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," that is used for doing so. This is known as ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Specifically, ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," provide the members of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," (but also non-members) to establish a provable similar understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", which is prerequisite for fruitful cooperation, and realizing ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7082],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>f});var o=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function n(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=o.createContext({}),m=function(e){var t=o.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},h=function(e){var t=m(e.components);return o.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},d=o.forwardRef((function(e,t){var i=e.components,a=e.mdxType,s=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),d=m(i),f=a,p=d["".concat(c,".").concat(f)]||d[f]||l[f]||s;return i?o.createElement(p,n(n({ref:t},h),{},{components:i})):o.createElement(p,n({ref:t},h))}));function f(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var s=i.length,n=new Array(s);n[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,n[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var o=i(3117),a=(i(7294),i(3905));const s={id:"scope",displayed_sidebar:"tev2SideBar",term:"scope",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the extent of the [terms](@), [definitions](@) and other documentation that a [community](@) (or [party](@), which we call the [owner](@essif-lab) of the [scope](@)) needs to express, communicate and validate its [knowledge](@essif-lab) as relevant to achieving a specific subset of its [objectives](@essif-lab).",grouptags:[],formPhrases:["scope{ss}","scope-context{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Scope",r={unversionedId:"terms/scope",id:"terms/scope",title:"Scope",description:"Summary",source:"@site/docs/terms/scope.md",sourceDirName:"terms",slug:"/terms/scope",permalink:"/tev2-specifications/docs/terms/scope",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scope.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scope",displayed_sidebar:"tev2SideBar",term:"scope",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the extent of the [terms](@), [definitions](@) and other documentation that a [community](@) (or [party](@), which we call the [owner](@essif-lab) of the [scope](@)) needs to express, communicate and validate its [knowledge](@essif-lab) as relevant to achieving a specific subset of its [objectives](@essif-lab).",grouptags:[],formPhrases:["scope{ss}","scope-context{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],h={toc:m};function l(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,o.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"scope"},"Scope"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"scope")," is the extent of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,a.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,a.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,a.kt)("p",null,"Other documentation includes ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and artifacts that are generated from that, such as ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries")," and the like. It also includes ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tags")," that can be used e.g. to refer to other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags"),"), identify different versions for artifacts (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags"),"), or create particular groups of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags"),")."),(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"Scopes"),", that is: their contents, must be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),". Since this requires particular capabilities that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," may lack, we say that this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," is done by a so-called ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community"),", whose members are individuals that do have such capabilities; they serve the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," as the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".",(0,a.kt)("p",null,"A ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," can contain multiple ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),"; it is expected that at least one such ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is committed to by the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community"),"."),(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"Scopes")," may overlap, or be nested, in a similar way as [namespaces](https://en.wikipedia.org/wiki/Namespace).",(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,a.kt)("h3",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"The purpose of having ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," is that it enables ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," (and other ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),") to come to develop and maintain ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are not only relevant for realizing specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),", but also are fit for expressing and communicating the ",(0,a.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," that is used for doing so. This is known as ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Specifically, ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," provide the members of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"owning community")," (but also non-members) to establish a provable similar understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", which is prerequisite for fruitful cooperation, and realizing ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/17aedecb.7db18364.js b/assets/js/17aedecb.0dfac046.js similarity index 99% rename from assets/js/17aedecb.7db18364.js rename to assets/js/17aedecb.0dfac046.js index 2ecf735ff..dcc613ec9 100644 --- a/assets/js/17aedecb.7db18364.js +++ b/assets/js/17aedecb.0dfac046.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4510],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>h});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},l=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,l=o(e,["components","mdxType","originalType","parentName"]),m=d(r),h=n,u=m["".concat(c,".").concat(h)]||m[h]||p[h]||i;return r?a.createElement(u,s(s({ref:t},l),{},{components:r})):a.createElement(u,s({ref:t},l))}));function h(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=r.length,s=new Array(i);s[0]=m;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,s[1]=o;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>i,metadata:()=>o,toc:()=>d});var a=r(3117),n=(r(7294),r(3905));const i={id:"hrd",displayed_sidebar:"tev2SideBar",term:"hrd",termType:"concept",isa:"dictionary",glossaryTerm:"Human Readable Dictionary",glossaryAbbr:"HRD",glossaryText:"a [dictionary](@) that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",grouptags:["dictionary","reference-materials"],formPhrases:["hrd{ss}","human-readable-dictionar{yies}","human-readable-dictionar{yies}-hrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="HRD - Human Readable Dictionary",o={unversionedId:"terms/hrd",id:"terms/hrd",title:"HRD - Human Readable Dictionary",description:"A Human Readable Dictionary or HRD is a dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",source:"@site/docs/terms/hrd.md",sourceDirName:"terms",slug:"/terms/hrd",permalink:"/tev2-specifications/docs/terms/hrd",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrd.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrd",displayed_sidebar:"tev2SideBar",term:"hrd",termType:"concept",isa:"dictionary",glossaryTerm:"Human Readable Dictionary",glossaryAbbr:"HRD",glossaryText:"a [dictionary](@) that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",grouptags:["dictionary","reference-materials"],formPhrases:["hrd{ss}","human-readable-dictionar{yies}","human-readable-dictionar{yies}-hrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Examples",id:"examples",level:2}],l={toc:d};function p(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"hrd---human-readable-dictionary"},"HRD - Human Readable Dictionary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Human Readable Dictionary")," or ",(0,n.kt)("strong",{parentName:"p"},"HRD")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"meanings")," in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"A printed HRD containing commonly used ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"explanations")," is a valuable reference tool for people that want to learn the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," and the different meanings some of their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," have."),(0,n.kt)("li",{parentName:"ol"},"Online HRDs often include hyperlinks, cross-references, and examples to provide comprehensive explanations of terms.")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4510],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>h});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},l=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,l=o(e,["components","mdxType","originalType","parentName"]),m=d(r),h=n,u=m["".concat(c,".").concat(h)]||m[h]||p[h]||i;return r?a.createElement(u,s(s({ref:t},l),{},{components:r})):a.createElement(u,s({ref:t},l))}));function h(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=r.length,s=new Array(i);s[0]=m;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,s[1]=o;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>i,metadata:()=>o,toc:()=>d});var a=r(3117),n=(r(7294),r(3905));const i={id:"hrd",displayed_sidebar:"tev2SideBar",term:"hrd",termType:"concept",isa:"dictionary",glossaryTerm:"Human Readable Dictionary",glossaryAbbr:"HRD",glossaryText:"a [dictionary](@) that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",grouptags:["dictionary","reference-materials"],formPhrases:["hrd{ss}","human-readable-dictionar{yies}","human-readable-dictionar{yies}-hrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="HRD - Human Readable Dictionary",o={unversionedId:"terms/hrd",id:"terms/hrd",title:"HRD - Human Readable Dictionary",description:"A Human Readable Dictionary or HRD is a dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",source:"@site/docs/terms/hrd.md",sourceDirName:"terms",slug:"/terms/hrd",permalink:"/tev2-specifications/docs/terms/hrd",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrd.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrd",displayed_sidebar:"tev2SideBar",term:"hrd",termType:"concept",isa:"dictionary",glossaryTerm:"Human Readable Dictionary",glossaryAbbr:"HRD",glossaryText:"a [dictionary](@) that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.",grouptags:["dictionary","reference-materials"],formPhrases:["hrd{ss}","human-readable-dictionar{yies}","human-readable-dictionar{yies}-hrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Examples",id:"examples",level:2}],l={toc:d};function p(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"hrd---human-readable-dictionary"},"HRD - Human Readable Dictionary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Human Readable Dictionary")," or ",(0,n.kt)("strong",{parentName:"p"},"HRD")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"meanings")," in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"A printed HRD containing commonly used ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"explanations")," is a valuable reference tool for people that want to learn the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," and the different meanings some of their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," have."),(0,n.kt)("li",{parentName:"ol"},"Online HRDs often include hyperlinks, cross-references, and examples to provide comprehensive explanations of terms.")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1d857b0c.223e3f35.js b/assets/js/1d857b0c.b8795f51.js similarity index 98% rename from assets/js/1d857b0c.223e3f35.js rename to assets/js/1d857b0c.b8795f51.js index 3c4dec09c..75a7d796b 100644 --- a/assets/js/1d857b0c.223e3f35.js +++ b/assets/js/1d857b0c.b8795f51.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7087],{3905:(e,t,r)=>{r.d(t,{Zo:()=>f,kt:()=>d});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},f=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,c=e.parentName,f=a(e,["components","mdxType","originalType","parentName"]),m=l(r),d=o,y=m["".concat(c,".").concat(d)]||m[d]||p[d]||i;return r?n.createElement(y,s(s({ref:t},f),{},{components:r})):n.createElement(y,s({ref:t},f))}));function d(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,s=new Array(i);s[0]=m;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:o,s[1]=a;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>i,metadata:()=>a,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const i={term:"terminology-identifier",termType:"concept",isa:"identifier",bodyFile:"/specs/syntax/31-terminology-identifiers.md",glossaryTerm:"Terminology Identifier",glossaryText:"a [text](identifier@), of the form `:`, that identifies a [terminology](@) from within a particular [scope](@), and can also be used to find the [MRG](@) file (in the [glossarydir](@) of that same [scope](@)) that contains [entries](mrg-entry@) for every [term](@) contained in that [terminology](@).",glossaryNotes:["If `` and/or `:` is omitted, their values are taken be the current (or default) ones."],grouptags:[],formPhrases:["terminology-identifier{ss}"],status:"proposed",created:20230929,updated:20230929,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s=void 0,a={unversionedId:"terms/terminology-identifier",id:"terms/terminology-identifier",title:"terminology-identifier",description:"",source:"@site/docs/terms/terminology-identifier.md",sourceDirName:"terms",slug:"/terms/terminology-identifier",permalink:"/tev2-specifications/docs/terms/terminology-identifier",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology-identifier.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{term:"terminology-identifier",termType:"concept",isa:"identifier",bodyFile:"/specs/syntax/31-terminology-identifiers.md",glossaryTerm:"Terminology Identifier",glossaryText:"a [text](identifier@), of the form `:`, that identifies a [terminology](@) from within a particular [scope](@), and can also be used to find the [MRG](@) file (in the [glossarydir](@) of that same [scope](@)) that contains [entries](mrg-entry@) for every [term](@) contained in that [terminology](@).",glossaryNotes:["If `` and/or `:` is omitted, their values are taken be the current (or default) ones."],grouptags:[],formPhrases:["terminology-identifier{ss}"],status:"proposed",created:20230929,updated:20230929,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"}},c={},l=[],f={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},f,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7087],{3905:(e,t,r)=>{r.d(t,{Zo:()=>f,kt:()=>d});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function s(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},f=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,c=e.parentName,f=a(e,["components","mdxType","originalType","parentName"]),m=l(r),d=o,y=m["".concat(c,".").concat(d)]||m[d]||p[d]||i;return r?n.createElement(y,s(s({ref:t},f),{},{components:r})):n.createElement(y,s({ref:t},f))}));function d(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,s=new Array(i);s[0]=m;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:o,s[1]=a;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>i,metadata:()=>a,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const i={term:"terminology-identifier",termType:"concept",isa:"identifier",bodyFile:"/specs/syntax/31-terminology-identifiers.md",glossaryTerm:"Terminology Identifier",glossaryText:"a [text](identifier@), of the form `:`, that identifies a [terminology](@) from within a particular [scope](@), and can also be used to find the [MRG](@) file (in the [glossarydir](@) of that same [scope](@)) that contains [entries](mrg-entry@) for every [term](@) contained in that [terminology](@).",glossaryNotes:["If `` and/or `:` is omitted, their values are taken be the current (or default) ones."],grouptags:[],formPhrases:["terminology-identifier{ss}"],status:"proposed",created:20230929,updated:20230929,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s=void 0,a={unversionedId:"terms/terminology-identifier",id:"terms/terminology-identifier",title:"terminology-identifier",description:"",source:"@site/docs/terms/terminology-identifier.md",sourceDirName:"terms",slug:"/terms/terminology-identifier",permalink:"/tev2-specifications/docs/terms/terminology-identifier",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology-identifier.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{term:"terminology-identifier",termType:"concept",isa:"identifier",bodyFile:"/specs/syntax/31-terminology-identifiers.md",glossaryTerm:"Terminology Identifier",glossaryText:"a [text](identifier@), of the form `:`, that identifies a [terminology](@) from within a particular [scope](@), and can also be used to find the [MRG](@) file (in the [glossarydir](@) of that same [scope](@)) that contains [entries](mrg-entry@) for every [term](@) contained in that [terminology](@).",glossaryNotes:["If `` and/or `:` is omitted, their values are taken be the current (or default) ones."],grouptags:[],formPhrases:["terminology-identifier{ss}"],status:"proposed",created:20230929,updated:20230929,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"}},c={},l=[],f={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},f,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1ebbe01d.ce6c1b90.js b/assets/js/1ebbe01d.dcf22545.js similarity index 99% rename from assets/js/1ebbe01d.ce6c1b90.js rename to assets/js/1ebbe01d.dcf22545.js index a6c07d578..2cd0e2166 100644 --- a/assets/js/1ebbe01d.ce6c1b90.js +++ b/assets/js/1ebbe01d.dcf22545.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9901],{3905:(e,t,a)=>{a.d(t,{Zo:()=>h,kt:()=>f});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=r.createContext({}),d=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},h=function(e){var t=d(e.components);return r.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),u=d(a),f=n,p=u["".concat(c,".").concat(f)]||u[f]||l[f]||i;return a?r.createElement(p,o(o({ref:t},h),{},{components:a})):r.createElement(p,o({ref:t},h))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=a.length,o=new Array(i);o[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var d=2;d{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>l,frontMatter:()=>i,metadata:()=>s,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const i={id:"header",displayed_sidebar:"tev2SideBar",term:"header",termType:"concept",isa:null,bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Header (of a Curated Text)",glossaryText:"the part of a [curated text](@), which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",glossaryNotes:["Headers live in [curated text files](@)."],grouptags:[],formPhrases:["header{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Header",s={unversionedId:"terms/header",id:"terms/header",title:"Header",description:"The Header (of a Curated Text) is the part at the beginning of that curated text, that starts with a line that (only) contains the text ---, and that ends with a second occurrence of such a line. The header is a set of key-value pairs (interleaved with comments) that contain meta data about the curated text and/or data that could also have been part of the body, but is so small that it doesn't warrant to have a dedicated section for it.",source:"@site/docs/terms/header.md",sourceDirName:"terms",slug:"/terms/header",permalink:"/tev2-specifications/docs/terms/header",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/header.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"header",displayed_sidebar:"tev2SideBar",term:"header",termType:"concept",isa:null,bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Header (of a Curated Text)",glossaryText:"the part of a [curated text](@), which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",glossaryNotes:["Headers live in [curated text files](@)."],grouptags:[],formPhrases:["header{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Notes",id:"notes",level:2}],h={toc:d};function l(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"header"},"Header"),(0,n.kt)("p",null,"The ",(0,n.kt)("strong",{parentName:"p"},"Header (of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Text"),")")," is the part at the beginning of that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", that starts with a line that (only) contains the text ",(0,n.kt)("inlineCode",{parentName:"p"},"---"),", and that ends with a second occurrence of such a line. The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," is a set of key-value pairs (interleaved with comments) that contain meta data about the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and/or data that could also have been part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", but is so small that it doesn't warrant to have a dedicated section for it."),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"The header is crucial for categorizing and managing curated texts, enabling efficient retrieval and navigation of relevant information."),(0,n.kt)("li",{parentName:"ul"},"The information within the header ensures consistency and accuracy in the curation process.")))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9901],{3905:(e,t,a)=>{a.d(t,{Zo:()=>h,kt:()=>f});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=r.createContext({}),d=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},h=function(e){var t=d(e.components);return r.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),u=d(a),f=n,p=u["".concat(c,".").concat(f)]||u[f]||l[f]||i;return a?r.createElement(p,o(o({ref:t},h),{},{components:a})):r.createElement(p,o({ref:t},h))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=a.length,o=new Array(i);o[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var d=2;d{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>l,frontMatter:()=>i,metadata:()=>s,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const i={id:"header",displayed_sidebar:"tev2SideBar",term:"header",termType:"concept",isa:null,bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Header (of a Curated Text)",glossaryText:"the part of a [curated text](@), which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",glossaryNotes:["Headers live in [curated text files](@)."],grouptags:[],formPhrases:["header{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Header",s={unversionedId:"terms/header",id:"terms/header",title:"Header",description:"The Header (of a Curated Text) is the part at the beginning of that curated text, that starts with a line that (only) contains the text ---, and that ends with a second occurrence of such a line. The header is a set of key-value pairs (interleaved with comments) that contain meta data about the curated text and/or data that could also have been part of the body, but is so small that it doesn't warrant to have a dedicated section for it.",source:"@site/docs/terms/header.md",sourceDirName:"terms",slug:"/terms/header",permalink:"/tev2-specifications/docs/terms/header",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/header.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"header",displayed_sidebar:"tev2SideBar",term:"header",termType:"concept",isa:null,bodyFile:"/specs/files/10-curated-text-file.md",glossaryTerm:"Header (of a Curated Text)",glossaryText:"the part of a [curated text](@), which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",glossaryNotes:["Headers live in [curated text files](@)."],grouptags:[],formPhrases:["header{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Notes",id:"notes",level:2}],h={toc:d};function l(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"header"},"Header"),(0,n.kt)("p",null,"The ",(0,n.kt)("strong",{parentName:"p"},"Header (of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Text"),")")," is the part at the beginning of that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", that starts with a line that (only) contains the text ",(0,n.kt)("inlineCode",{parentName:"p"},"---"),", and that ends with a second occurrence of such a line. The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," is a set of key-value pairs (interleaved with comments) that contain meta data about the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and/or data that could also have been part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", but is so small that it doesn't warrant to have a dedicated section for it."),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"The header is crucial for categorizing and managing curated texts, enabling efficient retrieval and navigation of relevant information."),(0,n.kt)("li",{parentName:"ul"},"The information within the header ensures consistency and accuracy in the curation process.")))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/1fbf49b1.83e4aead.js b/assets/js/1fbf49b1.dcd59120.js similarity index 99% rename from assets/js/1fbf49b1.83e4aead.js rename to assets/js/1fbf49b1.dcd59120.js index 6fb2fd463..ab9548233 100644 --- a/assets/js/1fbf49b1.83e4aead.js +++ b/assets/js/1fbf49b1.dcd59120.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5662],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>d});var r=o(7294);function i(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,r)}return o}function s(e){for(var t=1;t=0||(i[o]=e[o]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(i[o]=e[o])}return i}var c=r.createContext({}),l=function(e){var t=r.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):s(s({},t),e)),o},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var o=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(o),d=i,m=u["".concat(c,".").concat(d)]||u[d]||f[d]||n;return o?r.createElement(m,s(s({ref:t},p),{},{components:o})):r.createElement(m,s({ref:t},p))}));function d(e,t){var o=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=o.length,s=new Array(n);s[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var l=2;l{o.d(t,{Z:()=>v});var r=o(7294),i=o(6010),n=o(3438),s=o(9960),a=o(3919),c=o(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:o}=e;return r.createElement(s.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},o)}function d(e){let{href:t,icon:o,title:n,description:s}=e;return r.createElement(u,{href:t},r.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:n},o," ",n),s&&r.createElement("p",{className:(0,i.Z)("text--truncate",f),title:s},s))}function m(e){let{item:t}=e;const o=(0,n.Wl)(t);return o?r.createElement(d,{href:o,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const o=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,n.xz)(t.docId??void 0);return r.createElement(d,{href:t.href,icon:o,title:t.label,description:t.description??i?.description})}function g(e){let{item:t}=e;switch(t.type){case"link":return r.createElement(h,{item:t});case"category":return r.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const o=(0,n.jA)();return r.createElement(v,{items:o.items,className:t})}function v(e){const{items:t,className:o}=e;if(!t)return r.createElement(y,e);const s=(0,n.MN)(t);return r.createElement("section",{className:(0,i.Z)("row",o)},s.map(((e,t)=>r.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},r.createElement(g,{item:e})))))}},4686:(e,t,o)=>{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>u,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var r=o(3117),i=(o(7294),o(3905)),n=o(2991);const s={id:"specs-tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools)."},a="Specifications - Tools",c={unversionedId:"categories/specs-tools",id:"categories/specs-tools",title:"Specifications - Tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools).",source:"@site/docs/categories/36-specs-tools.md",sourceDirName:"categories",slug:"/categories/specs-tools",permalink:"/tev2-specifications/docs/categories/specs-tools",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/36-specs-tools.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:36,frontMatter:{id:"specs-tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools)."},sidebar:"tev2SideBar",previous:{title:"Handlebars Helpers",permalink:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},next:{title:"TRRT - Term Ref Resolution",permalink:"/tev2-specifications/docs/specs/tools/trrt"}},l={},p=[],f={toc:p};function u(e){let{components:t,...o}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications---tools"},"Specifications - Tools"),(0,i.kt)("p",null,"This section contains the specifications of the various TOOLS that exist within ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,i.kt)("p",null,"These tools are available in the official ",(0,i.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-tools"},"tev2-tools github repository"),"."),(0,i.kt)(n.Z,{folder:"/docs/specs/tools",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5662],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>d});var r=o(7294);function i(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,r)}return o}function s(e){for(var t=1;t=0||(i[o]=e[o]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(i[o]=e[o])}return i}var c=r.createContext({}),l=function(e){var t=r.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):s(s({},t),e)),o},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var o=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(o),d=i,m=u["".concat(c,".").concat(d)]||u[d]||f[d]||n;return o?r.createElement(m,s(s({ref:t},p),{},{components:o})):r.createElement(m,s({ref:t},p))}));function d(e,t){var o=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=o.length,s=new Array(n);s[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var l=2;l{o.d(t,{Z:()=>v});var r=o(7294),i=o(6010),n=o(3438),s=o(9960),a=o(3919),c=o(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:o}=e;return r.createElement(s.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},o)}function d(e){let{href:t,icon:o,title:n,description:s}=e;return r.createElement(u,{href:t},r.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:n},o," ",n),s&&r.createElement("p",{className:(0,i.Z)("text--truncate",f),title:s},s))}function m(e){let{item:t}=e;const o=(0,n.Wl)(t);return o?r.createElement(d,{href:o,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const o=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,n.xz)(t.docId??void 0);return r.createElement(d,{href:t.href,icon:o,title:t.label,description:t.description??i?.description})}function g(e){let{item:t}=e;switch(t.type){case"link":return r.createElement(h,{item:t});case"category":return r.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const o=(0,n.jA)();return r.createElement(v,{items:o.items,className:t})}function v(e){const{items:t,className:o}=e;if(!t)return r.createElement(y,e);const s=(0,n.MN)(t);return r.createElement("section",{className:(0,i.Z)("row",o)},s.map(((e,t)=>r.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},r.createElement(g,{item:e})))))}},4686:(e,t,o)=>{o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>u,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var r=o(3117),i=(o(7294),o(3905)),n=o(2991);const s={id:"specs-tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools)."},a="Specifications - Tools",c={unversionedId:"categories/specs-tools",id:"categories/specs-tools",title:"Specifications - Tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools).",source:"@site/docs/categories/36-specs-tools.md",sourceDirName:"categories",slug:"/categories/specs-tools",permalink:"/tev2-specifications/docs/categories/specs-tools",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/36-specs-tools.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:36,frontMatter:{id:"specs-tools",description:"This section contains the specifications of the various TOOLS that exist, and that are available in the official [tev2-tools github repository](https://github.com/tno-terminology-design/tev2-tools)."},sidebar:"tev2SideBar",previous:{title:"Handlebars Helpers",permalink:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},next:{title:"TRRT - Term Ref Resolution",permalink:"/tev2-specifications/docs/specs/tools/trrt"}},l={},p=[],f={toc:p};function u(e){let{components:t,...o}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications---tools"},"Specifications - Tools"),(0,i.kt)("p",null,"This section contains the specifications of the various TOOLS that exist within ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,i.kt)("p",null,"These tools are available in the official ",(0,i.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-tools"},"tev2-tools github repository"),"."),(0,i.kt)(n.Z,{folder:"/docs/specs/tools",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/21420f13.29e7a7e2.js b/assets/js/21420f13.6a3eb7b4.js similarity index 99% rename from assets/js/21420f13.29e7a7e2.js rename to assets/js/21420f13.6a3eb7b4.js index ddc359b41..73e350eac 100644 --- a/assets/js/21420f13.29e7a7e2.js +++ b/assets/js/21420f13.6a3eb7b4.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2685],{3905:(e,t,a)=>{a.d(t,{Zo:()=>m,kt:()=>l});var i=a(7294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function n(e){for(var t=1;t=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var c=i.createContext({}),h=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):n(n({},t),e)),a},m=function(e){var t=h(e.components);return i.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},f=i.forwardRef((function(e,t){var a=e.components,r=e.mdxType,s=e.originalType,c=e.parentName,m=o(e,["components","mdxType","originalType","parentName"]),f=h(a),l=r,d=f["".concat(c,".").concat(l)]||f[l]||p[l]||s;return a?i.createElement(d,n(n({ref:t},m),{},{components:a})):i.createElement(d,n({ref:t},m))}));function l(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var s=a.length,n=new Array(s);n[0]=f;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:r,n[1]=o;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>p,frontMatter:()=>s,metadata:()=>o,toc:()=>h});var i=a(3117),r=(a(7294),a(3905));const s={id:"form-phrase",displayed_sidebar:"tev2SideBar",term:"form-phrase",termType:"concept",isa:null,glossaryTerm:"Form Phrase (for a Semantic Unit)",glossaryText:"a word or phrase that refers to a particular [semantic unit](@), yet is not (necessarily) the [term](@) that is used in the [definition](@) of that [semantic unit](@). Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",glossaryNotes:["The set of [form phrases](@) that [TEv2 tools](@) can recognize, is specified in the [curated text](@) that documents that [unit](semantic-unit@). Such specifications may contain [form-phrase macros](@).","For looking up the [semantic unit](@) (documentation, as specified in its corresponding [MRG entry](@)), [TEv2 tools](@) can match words or phrases they encounter with the [regularized texts](@) that are listed in the `formPhrases` field of [MRG entries](@). Such [regularized texts](@) do not contain [form-phrase macros](@).","The [MRGT](@) ensures that the texts in the `formPhrases` field of a [curated text](@) are [properly converted](mrgt#processing-form-phrases@), and listed in the `formPhrases` field of the corresponding [MRG entry](@)."],formPhrases:["formphrase{ss}","form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Form Phrase",o={unversionedId:"terms/form-phrase",id:"terms/form-phrase",title:"Form Phrase",description:"A Form Phrase is a word or phrase that occurs in oral or written texts and that refers to a particular semantic unit, yet is not (necessarily) the term that is used in the definition of that semantic unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",source:"@site/docs/terms/form-phrase.md",sourceDirName:"terms",slug:"/terms/form-phrase",permalink:"/tev2-specifications/docs/terms/form-phrase",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/form-phrase.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"form-phrase",displayed_sidebar:"tev2SideBar",term:"form-phrase",termType:"concept",isa:null,glossaryTerm:"Form Phrase (for a Semantic Unit)",glossaryText:"a word or phrase that refers to a particular [semantic unit](@), yet is not (necessarily) the [term](@) that is used in the [definition](@) of that [semantic unit](@). Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",glossaryNotes:["The set of [form phrases](@) that [TEv2 tools](@) can recognize, is specified in the [curated text](@) that documents that [unit](semantic-unit@). Such specifications may contain [form-phrase macros](@).","For looking up the [semantic unit](@) (documentation, as specified in its corresponding [MRG entry](@)), [TEv2 tools](@) can match words or phrases they encounter with the [regularized texts](@) that are listed in the `formPhrases` field of [MRG entries](@). Such [regularized texts](@) do not contain [form-phrase macros](@).","The [MRGT](@) ensures that the texts in the `formPhrases` field of a [curated text](@) are [properly converted](mrgt#processing-form-phrases@), and listed in the `formPhrases` field of the corresponding [MRG entry](@)."],formPhrases:["formphrase{ss}","form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Specifying Form Phrases in Curated Texts",id:"specifying",level:2},{value:"Matching Form Phrases",id:"matching",level:2},{value:"Guidance for Specifying Form Phrases in Curated Texts",id:"guidance",level:2}],m={toc:h};function p(e){let{components:t,...a}=e;return(0,r.kt)("wrapper",(0,i.Z)({},m,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"form-phrase"},"Form Phrase"),(0,r.kt)("p",null,"A ",(0,r.kt)("strong",{parentName:"p"},"Form Phrase")," is a word or phrase that occurs in oral or written texts and that refers to a particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Examples"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," such as `[party](@)`, `[parties](@)` or `[party(s)](@)` should all refer to the same ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),'. This is achieved by specifiying "party", "parties", and "party(s)" as ',(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," for that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that [unit](@)."),(0,r.kt)("h2",{id:"purpose"},"Purpose"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"Form phrases")," serve as (standardized, human readable) identifiers for ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", enabling consistent and unambiguous references across various texts such as manuals, specifications, and guidelines. This is particularly useful (if not vital) in fields where precise terminology is key, ensuring that all stakeholders have a common understanding of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," used and thereby reducing the potential for misinterpretation or confusion.",(0,r.kt)("h2",{id:"specifying"},"Specifying Form Phrases in Curated Texts"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"Form phrases")," are to be specified in (the `formPhrases` field of) the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that describes the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," to which it refers. Here is an example:",(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor", "actors", "actor\'s", "actor(s)", "human actor", "machine actor" ]\n')),(0,r.kt)("p",null,"This specifies that whenever a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," is being converted by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", and the ",(0,r.kt)("inlineCode",{parentName:"p"},"showtext")," or the ",(0,r.kt)("inlineCode",{parentName:"p"},"term")," parts of that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," are any of these ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formPhrases"),", then the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," refers to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is documented by that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". "),(0,r.kt)("p",null,"Note that the specification of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," may include a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase-macro"),", for which several are ",(0,r.kt)("a",{parentName:"p",href:"/docs/terms/form-phrase-macro#predefineds"},"predefined"),". The example below is the equivalent specification as above:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor{ss}", "human actor", "machine actor" ]\n')),(0,r.kt)("p",null,"The same varieties can easily be added for the human and machine actors, as follows"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor{ss}", "human actor{ss}", "machine actor{ss}" ]\n')),(0,r.kt)("h2",{id:"matching"},"Matching Form Phrases"),(0,r.kt)("p",null,"Using (or: matching) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," is the process in which for a given word or phrase, it is determined whether or not it refers to a particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". This is done, e.g., by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," as it ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#finding-mrg-entry",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"tries to find")," an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that corresponds with the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#interpreter-profile",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},(0,r.kt)("inlineCode",{parentName:"p"},"showtext"))," field of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),"."),(0,r.kt)("p",null,"This matching process uses the contents of the ",(0,r.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", which are ",(0,r.kt)("a",{parentName:"p",href:"mrgt#processing-form-phrases"},"derived from")," the contents of the ",(0,r.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and proceeds as follows:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase#regularization-process",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"Regularize")," the given word or phrase;"),(0,r.kt)("li",{parentName:"ol"},"Find all ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that have the result an an entry in its ",(0,r.kt)("inlineCode",{parentName:"li"},"formPhrases"),"-field;"),(0,r.kt)("li",{parentName:"ol"},"If there is a single such an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", then the text is a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," described by that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,r.kt)("p",null,"It is possible that there is no matching ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),"."),(0,r.kt)("p",null,"If multiple ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," match, that is an error condition - that should not happen. Such conditions are typically flagged, e.g., as an error by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),", and they need to be resolved."),(0,r.kt)("h2",{id:"guidance"},"Guidance for Specifying Form Phrases in Curated Texts"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Character Composition"),': A form phrase is composed of a sequence of characters that may include letters, numbers, and spaces. Spaces are permissible if they are a standard part of the term (e.g., "hard drive").')),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Limited Special Characters"),': Generally, a form phrase should not contain special characters like punctuation marks (.,;:!? etc.), except for hyphens, underscores, or other characters if they are an integral part of the term (e.g., "non-refundable", "e-mail").')),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Case Sensitivity"),": While a form phrase may include uppercase or lowercase letters, it is typically treated as case-insensitive during the matching process. This ensures that variations in capitalization do not affect the identification of the term.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Adherence to Language Rules"),": A form phrase should conform to the grammatical and morphological rules of the language it's used in, including correct spelling and, where applicable, pluralization or possessive forms.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Uniqueness within Context"),": Each form phrase must be unique within its context or domain to avoid ambiguities. It should not overlap with or be a substring of another form phrase within the same set of terms.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Contextual Relevance"),": The form phrase should be relevant to its context and accurately represent the term or concept it's associated with, aligning with domain-specific terminology and usage."))))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2685],{3905:(e,t,a)=>{a.d(t,{Zo:()=>m,kt:()=>l});var i=a(7294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function n(e){for(var t=1;t=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var c=i.createContext({}),h=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):n(n({},t),e)),a},m=function(e){var t=h(e.components);return i.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},f=i.forwardRef((function(e,t){var a=e.components,r=e.mdxType,s=e.originalType,c=e.parentName,m=o(e,["components","mdxType","originalType","parentName"]),f=h(a),l=r,d=f["".concat(c,".").concat(l)]||f[l]||p[l]||s;return a?i.createElement(d,n(n({ref:t},m),{},{components:a})):i.createElement(d,n({ref:t},m))}));function l(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var s=a.length,n=new Array(s);n[0]=f;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:r,n[1]=o;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>p,frontMatter:()=>s,metadata:()=>o,toc:()=>h});var i=a(3117),r=(a(7294),a(3905));const s={id:"form-phrase",displayed_sidebar:"tev2SideBar",term:"form-phrase",termType:"concept",isa:null,glossaryTerm:"Form Phrase (for a Semantic Unit)",glossaryText:"a word or phrase that refers to a particular [semantic unit](@), yet is not (necessarily) the [term](@) that is used in the [definition](@) of that [semantic unit](@). Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",glossaryNotes:["The set of [form phrases](@) that [TEv2 tools](@) can recognize, is specified in the [curated text](@) that documents that [unit](semantic-unit@). Such specifications may contain [form-phrase macros](@).","For looking up the [semantic unit](@) (documentation, as specified in its corresponding [MRG entry](@)), [TEv2 tools](@) can match words or phrases they encounter with the [regularized texts](@) that are listed in the `formPhrases` field of [MRG entries](@). Such [regularized texts](@) do not contain [form-phrase macros](@).","The [MRGT](@) ensures that the texts in the `formPhrases` field of a [curated text](@) are [properly converted](mrgt#processing-form-phrases@), and listed in the `formPhrases` field of the corresponding [MRG entry](@)."],formPhrases:["formphrase{ss}","form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Form Phrase",o={unversionedId:"terms/form-phrase",id:"terms/form-phrase",title:"Form Phrase",description:"A Form Phrase is a word or phrase that occurs in oral or written texts and that refers to a particular semantic unit, yet is not (necessarily) the term that is used in the definition of that semantic unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",source:"@site/docs/terms/form-phrase.md",sourceDirName:"terms",slug:"/terms/form-phrase",permalink:"/tev2-specifications/docs/terms/form-phrase",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/form-phrase.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"form-phrase",displayed_sidebar:"tev2SideBar",term:"form-phrase",termType:"concept",isa:null,glossaryTerm:"Form Phrase (for a Semantic Unit)",glossaryText:"a word or phrase that refers to a particular [semantic unit](@), yet is not (necessarily) the [term](@) that is used in the [definition](@) of that [semantic unit](@). Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",glossaryNotes:["The set of [form phrases](@) that [TEv2 tools](@) can recognize, is specified in the [curated text](@) that documents that [unit](semantic-unit@). Such specifications may contain [form-phrase macros](@).","For looking up the [semantic unit](@) (documentation, as specified in its corresponding [MRG entry](@)), [TEv2 tools](@) can match words or phrases they encounter with the [regularized texts](@) that are listed in the `formPhrases` field of [MRG entries](@). Such [regularized texts](@) do not contain [form-phrase macros](@).","The [MRGT](@) ensures that the texts in the `formPhrases` field of a [curated text](@) are [properly converted](mrgt#processing-form-phrases@), and listed in the `formPhrases` field of the corresponding [MRG entry](@)."],formPhrases:["formphrase{ss}","form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Specifying Form Phrases in Curated Texts",id:"specifying",level:2},{value:"Matching Form Phrases",id:"matching",level:2},{value:"Guidance for Specifying Form Phrases in Curated Texts",id:"guidance",level:2}],m={toc:h};function p(e){let{components:t,...a}=e;return(0,r.kt)("wrapper",(0,i.Z)({},m,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"form-phrase"},"Form Phrase"),(0,r.kt)("p",null,"A ",(0,r.kt)("strong",{parentName:"p"},"Form Phrase")," is a word or phrase that occurs in oral or written texts and that refers to a particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Examples"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," such as `[party](@)`, `[parties](@)` or `[party(s)](@)` should all refer to the same ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),'. This is achieved by specifiying "party", "parties", and "party(s)" as ',(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," for that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that [unit](@)."),(0,r.kt)("h2",{id:"purpose"},"Purpose"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"Form phrases")," serve as (standardized, human readable) identifiers for ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", enabling consistent and unambiguous references across various texts such as manuals, specifications, and guidelines. This is particularly useful (if not vital) in fields where precise terminology is key, ensuring that all stakeholders have a common understanding of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," used and thereby reducing the potential for misinterpretation or confusion.",(0,r.kt)("h2",{id:"specifying"},"Specifying Form Phrases in Curated Texts"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"Form phrases")," are to be specified in (the `formPhrases` field of) the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that describes the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," to which it refers. Here is an example:",(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor", "actors", "actor\'s", "actor(s)", "human actor", "machine actor" ]\n')),(0,r.kt)("p",null,"This specifies that whenever a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," is being converted by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", and the ",(0,r.kt)("inlineCode",{parentName:"p"},"showtext")," or the ",(0,r.kt)("inlineCode",{parentName:"p"},"term")," parts of that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," are any of these ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formPhrases"),", then the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," refers to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is documented by that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". "),(0,r.kt)("p",null,"Note that the specification of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," may include a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase-macro"),", for which several are ",(0,r.kt)("a",{parentName:"p",href:"/docs/terms/form-phrase-macro#predefineds"},"predefined"),". The example below is the equivalent specification as above:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor{ss}", "human actor", "machine actor" ]\n')),(0,r.kt)("p",null,"The same varieties can easily be added for the human and machine actors, as follows"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'formPhrases: [ "actor{ss}", "human actor{ss}", "machine actor{ss}" ]\n')),(0,r.kt)("h2",{id:"matching"},"Matching Form Phrases"),(0,r.kt)("p",null,"Using (or: matching) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," is the process in which for a given word or phrase, it is determined whether or not it refers to a particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". This is done, e.g., by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," as it ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#finding-mrg-entry",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"tries to find")," an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that corresponds with the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#interpreter-profile",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},(0,r.kt)("inlineCode",{parentName:"p"},"showtext"))," field of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),"."),(0,r.kt)("p",null,"This matching process uses the contents of the ",(0,r.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),", which are ",(0,r.kt)("a",{parentName:"p",href:"mrgt#processing-form-phrases"},"derived from")," the contents of the ",(0,r.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and proceeds as follows:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase#regularization-process",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"Regularize")," the given word or phrase;"),(0,r.kt)("li",{parentName:"ol"},"Find all ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that have the result an an entry in its ",(0,r.kt)("inlineCode",{parentName:"li"},"formPhrases"),"-field;"),(0,r.kt)("li",{parentName:"ol"},"If there is a single such an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", then the text is a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," described by that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,r.kt)("p",null,"It is possible that there is no matching ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),"."),(0,r.kt)("p",null,"If multiple ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," match, that is an error condition - that should not happen. Such conditions are typically flagged, e.g., as an error by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),", and they need to be resolved."),(0,r.kt)("h2",{id:"guidance"},"Guidance for Specifying Form Phrases in Curated Texts"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Character Composition"),': A form phrase is composed of a sequence of characters that may include letters, numbers, and spaces. Spaces are permissible if they are a standard part of the term (e.g., "hard drive").')),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Limited Special Characters"),': Generally, a form phrase should not contain special characters like punctuation marks (.,;:!? etc.), except for hyphens, underscores, or other characters if they are an integral part of the term (e.g., "non-refundable", "e-mail").')),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Case Sensitivity"),": While a form phrase may include uppercase or lowercase letters, it is typically treated as case-insensitive during the matching process. This ensures that variations in capitalization do not affect the identification of the term.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Adherence to Language Rules"),": A form phrase should conform to the grammatical and morphological rules of the language it's used in, including correct spelling and, where applicable, pluralization or possessive forms.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Uniqueness within Context"),": Each form phrase must be unique within its context or domain to avoid ambiguities. It should not overlap with or be a substring of another form phrase within the same set of terms.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Contextual Relevance"),": The form phrase should be relevant to its context and accurately represent the term or concept it's associated with, aligning with domain-specific terminology and usage."))))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/23374ca6.46a14837.js b/assets/js/23374ca6.5cf7ece5.js similarity index 98% rename from assets/js/23374ca6.46a14837.js rename to assets/js/23374ca6.5cf7ece5.js index 0d9258dad..8062426d9 100644 --- a/assets/js/23374ca6.46a14837.js +++ b/assets/js/23374ca6.5cf7ece5.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[8421],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>d});var n=o(7294);function r(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function i(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,n)}return o}function a(e){for(var t=1;t=0||(r[o]=e[o]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(r[o]=e[o])}return r}var c=n.createContext({}),l=function(e){var t=n.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):a(a({},t),e)),o},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var o=e.components,r=e.mdxType,i=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(o),d=r,f=m["".concat(c,".").concat(d)]||m[d]||u[d]||i;return o?n.createElement(f,a(a({ref:t},p),{},{components:o})):n.createElement(f,a({ref:t},p))}));function d(e,t){var o=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=o.length,a=new Array(i);a[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:r,a[1]=s;for(var l=2;l{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>u,frontMatter:()=>i,metadata:()=>s,toc:()=>l});var n=o(3117),r=(o(7294),o(3905));const i={id:"tev2-readme",sidebar_label:"Contributing",date:20220402},a="Contributing to TEv2 Tools",s={unversionedId:"tev2-readme",id:"tev2-readme",title:"Contributing to TEv2 Tools",description:"This documentation is based on the ToIP TT-Tools Proposal memo, which we currently keep as a reference.",source:"@site/docs/README.md",sourceDirName:".",slug:"/",permalink:"/tev2-specifications/docs/",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/README.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-readme",sidebar_label:"Contributing",date:20220402}},c={},l=[],p={toc:l};function u(e){let{components:t,...o}=e;return(0,r.kt)("wrapper",(0,n.Z)({},p,o,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"contributing-to-tev2-tools"},"Contributing to TEv2 Tools"),(0,r.kt)("admonition",{title:"Editor's note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"This documentation is based on the ",(0,r.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/toip-terminology-toolbox"},"ToIP TT-Tools Proposal")," memo, which we currently keep as a reference.")),(0,r.kt)("p",null,"The '",(0,r.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/category/introduction-overview"},"Terminology Engine v2 (TEv2)"),"' consists of two parts:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"The ",(0,r.kt)("a",{parentName:"li",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/category/specs/tools"},"Terminology Toolbox")," is a set of (extendable) command-line tools that can be used for generic purposes, such as resolving ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermReferences"),", and creating glossaries."),(0,r.kt)("li",{parentName:"ol"},"The use of these, and other tools (in our case: ",(0,r.kt)("a",{parentName:"li",href:"https://docusaurus.io/"},"Docusaurus"),", and ",(0,r.kt)("a",{parentName:"li",href:"https://resources.github.com/ci-cd/"},"github CI/CD"),"), for facilitating the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," by ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms communities"),".")),(0,r.kt)("p",null,"We are seeking parties that can contribute to the development of these (extendable) command-line tools, and do so in close collaboration with the eSSIF-Lab consortium. Please express your interest as an ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-specifications/issues"},"issue in the eSSIF-Lab repo"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[8421],{3905:(e,t,o)=>{o.d(t,{Zo:()=>p,kt:()=>d});var n=o(7294);function r(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function i(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,n)}return o}function a(e){for(var t=1;t=0||(r[o]=e[o]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(r[o]=e[o])}return r}var c=n.createContext({}),l=function(e){var t=n.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):a(a({},t),e)),o},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var o=e.components,r=e.mdxType,i=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(o),d=r,f=m["".concat(c,".").concat(d)]||m[d]||u[d]||i;return o?n.createElement(f,a(a({ref:t},p),{},{components:o})):n.createElement(f,a({ref:t},p))}));function d(e,t){var o=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=o.length,a=new Array(i);a[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:r,a[1]=s;for(var l=2;l{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>u,frontMatter:()=>i,metadata:()=>s,toc:()=>l});var n=o(3117),r=(o(7294),o(3905));const i={id:"tev2-readme",sidebar_label:"Contributing",date:20220402},a="Contributing to TEv2 Tools",s={unversionedId:"tev2-readme",id:"tev2-readme",title:"Contributing to TEv2 Tools",description:"This documentation is based on the ToIP TT-Tools Proposal memo, which we currently keep as a reference.",source:"@site/docs/README.md",sourceDirName:".",slug:"/",permalink:"/tev2-specifications/docs/",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/README.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-readme",sidebar_label:"Contributing",date:20220402}},c={},l=[],p={toc:l};function u(e){let{components:t,...o}=e;return(0,r.kt)("wrapper",(0,n.Z)({},p,o,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"contributing-to-tev2-tools"},"Contributing to TEv2 Tools"),(0,r.kt)("admonition",{title:"Editor's note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"This documentation is based on the ",(0,r.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/toip-terminology-toolbox"},"ToIP TT-Tools Proposal")," memo, which we currently keep as a reference.")),(0,r.kt)("p",null,"The '",(0,r.kt)("a",{parentName:"p",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/category/introduction-overview"},"Terminology Engine v2 (TEv2)"),"' consists of two parts:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"The ",(0,r.kt)("a",{parentName:"li",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/category/specs/tools"},"Terminology Toolbox")," is a set of (extendable) command-line tools that can be used for generic purposes, such as resolving ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermReferences"),", and creating glossaries."),(0,r.kt)("li",{parentName:"ol"},"The use of these, and other tools (in our case: ",(0,r.kt)("a",{parentName:"li",href:"https://docusaurus.io/"},"Docusaurus"),", and ",(0,r.kt)("a",{parentName:"li",href:"https://resources.github.com/ci-cd/"},"github CI/CD"),"), for facilitating the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," by ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms communities"),".")),(0,r.kt)("p",null,"We are seeking parties that can contribute to the development of these (extendable) command-line tools, and do so in close collaboration with the eSSIF-Lab consortium. Please express your interest as an ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/tno-terminology-design/tev2-specifications/issues"},"issue in the eSSIF-Lab repo"),"."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/233866fe.7b200852.js b/assets/js/233866fe.e5a4c533.js similarity index 99% rename from assets/js/233866fe.7b200852.js rename to assets/js/233866fe.e5a4c533.js index 04beaeda2..da4253108 100644 --- a/assets/js/233866fe.7b200852.js +++ b/assets/js/233866fe.e5a4c533.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6551],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>p});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},l=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},h=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,s=e.originalType,c=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),h=m(i),p=o,f=h["".concat(c,".").concat(p)]||h[p]||d[p]||s;return i?a.createElement(f,n(n({ref:t},l),{},{components:i})):a.createElement(f,n({ref:t},l))}));function p(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=i.length,n=new Array(s);n[0]=h;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,n[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var a=i(3117),o=(i(7294),i(3905));const s={id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"concept",glossaryTerm:null,glossaryText:"a set of [terms](scoped-term@) that are used within a single [scope](@) to refer to [concepts](@) and other [semantic units](@) of a single [party](@) (e.g. a [community](@)), enabling [parties](@) to reason and communicate ideas they have about one or more specific topics.",grouptags:[],formPhrases:["terminolog{yies}"],status:"proposed",created:20220606,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Terminology",r={unversionedId:"terms/terminology",id:"terms/terminology",title:"Terminology",description:"Summary",source:"@site/docs/terms/terminology.md",sourceDirName:"terms",slug:"/terms/terminology",permalink:"/tev2-specifications/docs/terms/terminology",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"concept",glossaryTerm:null,glossaryText:"a set of [terms](scoped-term@) that are used within a single [scope](@) to refer to [concepts](@) and other [semantic units](@) of a single [party](@) (e.g. a [community](@)), enabling [parties](@) to reason and communicate ideas they have about one or more specific topics.",grouptags:[],formPhrases:["terminolog{yies}"],status:"proposed",created:20220606,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],l={toc:m};function d(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"terminology"},"Terminology"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"terminology")," is a set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics. It may be viewed as a topic-specific subset of that ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabulary"),"."),(0,o.kt)("p",null,"As each ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," comes with all sorts of related data, such as a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"documentation")," about the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it represents, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that can be used as synonyms, etc., and since (pointers to) all that data is gathered in a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", we can also say that a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of the set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that hold such data of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of."),(0,o.kt)("p",null,"As a consequence, it is easy ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"to generate")," an ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as this is basically the collection of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that constitute the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (apart from ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#structure"},"some meta-data"),", of course). And from there, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossaries")," can be ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"derived"),"."),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," may be versioned, i.e. associated with a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag"),". This allows multiple ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to exist within a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", enabling the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to have one for specific purposes (e.g. for the further development of its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", or for use within a whitepaper)."),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be documented by (at most) one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine-readable glossary"),", from which ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossaries")," can be derived. Selecting the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"(scoped) terms")," that are part of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," and generating the various ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," is done by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator(s)")," of its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"terminology construction manual")," describes how to construct a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," by selecting (groups of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms"),", and manipulating such selections."),(0,o.kt)("h3",{id:"purpose"},"Purpose"),(0,o.kt)("p",null,"In order for ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to properly reason and/or communicate ideas (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") about some topic - in particular when it is a specialist topic - they have to establish a set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", the meaning of which should be ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"defined")," (or otherwise documented) in such a way that the likelihood of misunderstandings between them is minimized. This set of terms is called a ",(0,o.kt)("inlineCode",{parentName:"p"},"**terminology**")))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6551],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>p});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},l=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},h=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,s=e.originalType,c=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),h=m(i),p=o,f=h["".concat(c,".").concat(p)]||h[p]||d[p]||s;return i?a.createElement(f,n(n({ref:t},l),{},{components:i})):a.createElement(f,n({ref:t},l))}));function p(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=i.length,n=new Array(s);n[0]=h;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,n[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var a=i(3117),o=(i(7294),i(3905));const s={id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"concept",glossaryTerm:null,glossaryText:"a set of [terms](scoped-term@) that are used within a single [scope](@) to refer to [concepts](@) and other [semantic units](@) of a single [party](@) (e.g. a [community](@)), enabling [parties](@) to reason and communicate ideas they have about one or more specific topics.",grouptags:[],formPhrases:["terminolog{yies}"],status:"proposed",created:20220606,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Terminology",r={unversionedId:"terms/terminology",id:"terms/terminology",title:"Terminology",description:"Summary",source:"@site/docs/terms/terminology.md",sourceDirName:"terms",slug:"/terms/terminology",permalink:"/tev2-specifications/docs/terms/terminology",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology",displayed_sidebar:"tev2SideBar",term:"terminology",termType:"concept",glossaryTerm:null,glossaryText:"a set of [terms](scoped-term@) that are used within a single [scope](@) to refer to [concepts](@) and other [semantic units](@) of a single [party](@) (e.g. a [community](@)), enabling [parties](@) to reason and communicate ideas they have about one or more specific topics.",grouptags:[],formPhrases:["terminolog{yies}"],status:"proposed",created:20220606,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],l={toc:m};function d(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"terminology"},"Terminology"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"terminology")," is a set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics. It may be viewed as a topic-specific subset of that ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabulary"),"."),(0,o.kt)("p",null,"As each ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," comes with all sorts of related data, such as a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"documentation")," about the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it represents, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that can be used as synonyms, etc., and since (pointers to) all that data is gathered in a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", we can also say that a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of the set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that hold such data of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of."),(0,o.kt)("p",null,"As a consequence, it is easy ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"to generate")," an ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as this is basically the collection of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that constitute the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (apart from ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg#structure"},"some meta-data"),", of course). And from there, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossaries")," can be ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"derived"),"."),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," may be versioned, i.e. associated with a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag"),". This allows multiple ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to exist within a single ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", enabling the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to have one for specific purposes (e.g. for the further development of its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", or for use within a whitepaper)."),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be documented by (at most) one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine-readable glossary"),", from which ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossaries")," can be derived. Selecting the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"(scoped) terms")," that are part of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," and generating the various ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," is done by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator(s)")," of its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"terminology construction manual")," describes how to construct a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," by selecting (groups of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms"),", and manipulating such selections."),(0,o.kt)("h3",{id:"purpose"},"Purpose"),(0,o.kt)("p",null,"In order for ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to properly reason and/or communicate ideas (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") about some topic - in particular when it is a specialist topic - they have to establish a set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", the meaning of which should be ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"defined")," (or otherwise documented) in such a way that the likelihood of misunderstandings between them is minimized. This set of terms is called a ",(0,o.kt)("inlineCode",{parentName:"p"},"**terminology**")))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2a3b95f3.12b9fc66.js b/assets/js/2a3b95f3.40fcd5b7.js similarity index 99% rename from assets/js/2a3b95f3.12b9fc66.js rename to assets/js/2a3b95f3.40fcd5b7.js index ade556aff..80310cb97 100644 --- a/assets/js/2a3b95f3.12b9fc66.js +++ b/assets/js/2a3b95f3.40fcd5b7.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3309],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>d});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function i(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var p=a.createContext({}),c=function(e){var t=a.useContext(p),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=c(e.components);return a.createElement(p.Provider,{value:t},e.children)},g={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,p=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),l=c(r),d=n,m=l["".concat(p,".").concat(d)]||l[d]||g[d]||o;return r?a.createElement(m,i(i({ref:t},u),{},{components:r})):a.createElement(m,i({ref:t},u))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,i=new Array(o);i[0]=l;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:n,i[1]=s;for(var c=2;c{r.r(t),r.d(t,{assets:()=>p,contentTitle:()=>i,default:()=>g,frontMatter:()=>o,metadata:()=>s,toc:()=>c});var a=r(3117),n=(r(7294),r(3905));const o={id:"named-capturing-group",displayed_sidebar:"tev2SideBar",term:"named-capturing-group",termType:"concept",isa:null,glossaryTerm:"Named Capturing Group",glossaryText:"a sub-pattern within a [regex](@) (called a '[capturing group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group)') that has been given a name, allowing one to refer to that sub-pattern.",grouptags:[],formPhrases:["named-capturing-group{ss}","capturing-group{ss}"],status:"proposed",created:20231220,updated:20231220,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Named Capturing Group",s={unversionedId:"terms/named-capturing-group",id:"terms/named-capturing-group",title:"Named Capturing Group",description:"A Named Capturing Group is a sub-pattern within a regex (called a 'capturing group') that has been given a name, allowing one to refer to that sub-pattern.",source:"@site/docs/terms/named-capturing-group.md",sourceDirName:"terms",slug:"/terms/named-capturing-group",permalink:"/tev2-specifications/docs/terms/named-capturing-group",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/named-capturing-group.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"named-capturing-group",displayed_sidebar:"tev2SideBar",term:"named-capturing-group",termType:"concept",isa:null,glossaryTerm:"Named Capturing Group",glossaryText:"a sub-pattern within a [regex](@) (called a '[capturing group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group)') that has been given a name, allowing one to refer to that sub-pattern.",grouptags:[],formPhrases:["named-capturing-group{ss}","capturing-group{ss}"],status:"proposed",created:20231220,updated:20231220,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},p={},c=[],u={toc:c};function g(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"named-capturing-group"},"Named Capturing Group"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Named Capturing Group")," is a sub-pattern within a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern. "),(0,n.kt)("p",null,"It depends on the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," flavor what the syntax is for specifying named capturing groups. "),(0,n.kt)("p",null,"Within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use the ",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript)"),", which has specified a ",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group"},"syntax for named capturing groups"),"."))}g.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3309],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>d});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function i(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var p=a.createContext({}),c=function(e){var t=a.useContext(p),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=c(e.components);return a.createElement(p.Provider,{value:t},e.children)},g={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,p=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),l=c(r),d=n,m=l["".concat(p,".").concat(d)]||l[d]||g[d]||o;return r?a.createElement(m,i(i({ref:t},u),{},{components:r})):a.createElement(m,i({ref:t},u))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,i=new Array(o);i[0]=l;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:n,i[1]=s;for(var c=2;c{r.r(t),r.d(t,{assets:()=>p,contentTitle:()=>i,default:()=>g,frontMatter:()=>o,metadata:()=>s,toc:()=>c});var a=r(3117),n=(r(7294),r(3905));const o={id:"named-capturing-group",displayed_sidebar:"tev2SideBar",term:"named-capturing-group",termType:"concept",isa:null,glossaryTerm:"Named Capturing Group",glossaryText:"a sub-pattern within a [regex](@) (called a '[capturing group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group)') that has been given a name, allowing one to refer to that sub-pattern.",grouptags:[],formPhrases:["named-capturing-group{ss}","capturing-group{ss}"],status:"proposed",created:20231220,updated:20231220,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Named Capturing Group",s={unversionedId:"terms/named-capturing-group",id:"terms/named-capturing-group",title:"Named Capturing Group",description:"A Named Capturing Group is a sub-pattern within a regex (called a 'capturing group') that has been given a name, allowing one to refer to that sub-pattern.",source:"@site/docs/terms/named-capturing-group.md",sourceDirName:"terms",slug:"/terms/named-capturing-group",permalink:"/tev2-specifications/docs/terms/named-capturing-group",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/named-capturing-group.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"named-capturing-group",displayed_sidebar:"tev2SideBar",term:"named-capturing-group",termType:"concept",isa:null,glossaryTerm:"Named Capturing Group",glossaryText:"a sub-pattern within a [regex](@) (called a '[capturing group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group)') that has been given a name, allowing one to refer to that sub-pattern.",grouptags:[],formPhrases:["named-capturing-group{ss}","capturing-group{ss}"],status:"proposed",created:20231220,updated:20231220,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},p={},c=[],u={toc:c};function g(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"named-capturing-group"},"Named Capturing Group"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Named Capturing Group")," is a sub-pattern within a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern. "),(0,n.kt)("p",null,"It depends on the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," flavor what the syntax is for specifying named capturing groups. "),(0,n.kt)("p",null,"Within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use the ",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript)"),", which has specified a ",(0,n.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group"},"syntax for named capturing groups"),"."))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2f0ec223.276d808e.js b/assets/js/2f0ec223.eeb45238.js similarity index 99% rename from assets/js/2f0ec223.276d808e.js rename to assets/js/2f0ec223.eeb45238.js index bb6979676..e5f721713 100644 --- a/assets/js/2f0ec223.276d808e.js +++ b/assets/js/2f0ec223.eeb45238.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1062],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>f});var i=a(7294);function r(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function o(t){for(var e=1;e=0||(r[a]=t[a]);return r}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(r[a]=t[a])}return r}var c=i.createContext({}),h=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):o(o({},e),t)),a},d=function(t){var e=h(t.components);return i.createElement(c.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},l=i.forwardRef((function(t,e){var a=t.components,r=t.mdxType,n=t.originalType,c=t.parentName,d=s(t,["components","mdxType","originalType","parentName"]),l=h(a),f=r,m=l["".concat(c,".").concat(f)]||l[f]||u[f]||n;return a?i.createElement(m,o(o({ref:e},d),{},{components:a})):i.createElement(m,o({ref:e},d))}));function f(t,e){var a=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var n=a.length,o=new Array(n);o[0]=l;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:r,o[1]=s;for(var h=2;h{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>o,default:()=>u,frontMatter:()=>n,metadata:()=>s,toc:()=>h});var i=a(3117),r=(a(7294),a(3905));const n={id:"curated-text",displayed_sidebar:"tev2SideBar",term:"curated-text",termType:"concept",isa:null,glossaryTerm:"Curated Text",glossaryText:"a text that documents a [concept](@) or other [semantic unit](@) of a particular [party](@), and specifies, e.g., the [term(s)](@) by which the [party](@) refers thereto, its [definition](@), and any other relevant information.",grouptags:[],formPhrases:["curated-text{ss}","ctext{ss}"],status:"proposed",created:20220602,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Curated Text",s={unversionedId:"terms/curated-text",id:"terms/curated-text",title:"Curated Text",description:"A curated text is a text that documents a concept or other semantic unit of a particular party, and specifies, e.g., the term(s) by which the party refers thereto, its definition, and any other relevant information.",source:"@site/docs/terms/curated-text.md",sourceDirName:"terms",slug:"/terms/curated-text",permalink:"/tev2-specifications/docs/terms/curated-text",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curated-text.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curated-text",displayed_sidebar:"tev2SideBar",term:"curated-text",termType:"concept",isa:null,glossaryTerm:"Curated Text",glossaryText:"a text that documents a [concept](@) or other [semantic unit](@) of a particular [party](@), and specifies, e.g., the [term(s)](@) by which the [party](@) refers thereto, its [definition](@), and any other relevant information.",grouptags:[],formPhrases:["curated-text{ss}","ctext{ss}"],status:"proposed",created:20220602,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Notes",id:"notes",level:2}],d={toc:h};function u(t){let{components:e,...a}=t;return(0,r.kt)("wrapper",(0,i.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"curated-text"},"Curated Text"),(0,r.kt)("p",null,"A ",(0,r.kt)("strong",{parentName:"p"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"))," is a text that documents a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," consists of two parts: "),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),", which is a set of key-value pairs that are designed to facilitate automated processing;"),(0,r.kt)("li",{parentName:"ul"},"a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", that contains texts that are designed for human interpretation.")),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," live in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files"),", that may have been generated, e.g. from [ingress tools](docs/overview/tev2-architecture#ingress-tools), or may have been constructed manually (using a text editor).",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," are used for a variety of purposes, as they (may) contain texts that:",(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"are included in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," (one ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," for each ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),");"),(0,r.kt)("li",{parentName:"ul"},"are included in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs"),", and (in future), ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),";"),(0,r.kt)("li",{parentName:"ul"},"help ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," get a more in-depth understanding of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is being documented"),(0,r.kt)("li",{parentName:"ul"},"help ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to find out other, related ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," or other ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," related to that which is being described,\netc.")),(0,r.kt)("p",null,"The (technical) structure and syntax for files that contain ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," is specified ",(0,r.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"here"),"."),(0,r.kt)("p",null,"The manuals for ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/contributor/contributor-overview"},"contributors"),", ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/author/author-overview"},"authors")," and ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/curator/curator-overview"},"curators")," will provide guidance for people that act in these respective roles as they work with ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),"."),(0,r.kt)("admonition",{title:"Editor's Note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Text needs to be revised from here onward. Here are some ideas to mention:"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},"contributors can suggest contents as per the curators instructions;"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," can write the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),";"),(0,r.kt)("li",{parentName:"ul"},"curators update the header of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," (conforming to the ",(0,r.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"ctext specifications"),";"),(0,r.kt)("li",{parentName:"ul"},"curators specify the process by which ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," progress/mature, and get statuses assigned;"),(0,r.kt)("li",{parentName:"ul"},"curators generate artifacts from 'decided on' ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", so that",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"rendering tools or generation tools used in other scopes can generate artifacts and"),(0,r.kt)("li",{parentName:"ul"},"people can subsequently access nicely rendered, human readable versions"))))),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,r.kt)("h2",{id:"purpose"},"Purpose"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," are intended to be processable by a variety of tools, that are chosen by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators"),". Together, these tools not only enable the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", but also the generation of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", and a better handling of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," in documentation, whitepapers and the like.",(0,r.kt)("p",null,"The precise conditions that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," and ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"bodies")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," must satisfy will differ across ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," as ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," are autonomous in choosing their tools and ways of working. To support other participants of their ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," in making contributions, they will define an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/ingestion",title:"Ingestion (Process): the process that is run by a Terms-community, in which their members suggest, draft, and discuss Definitions (Terms + Criteria) that are relevant for a particular Scope, and converting such contributions into Curated Texts that accurately document the Concepts and other Semantic Units and that adhere to the TEv2-specifications."},"ingestion process")," for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope(s)")," they ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curate"),", enabling such participants to contribute in ways that are easy for them."),(0,r.kt)("h2",{id:"notes"},"Notes"),(0,r.kt)("p",null,"The intention of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," is to document a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", which is something that has a place in the way of thinking within a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Ways of working (e.g. installation procedures), reports on research to be published in papers, etc., are NOT thought of as part of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", and hence should not be documented as a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". Having said that, this is not a closed discussion; we can think of arguments to the opposite, so who knows..."))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1062],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>f});var i=a(7294);function r(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function o(t){for(var e=1;e=0||(r[a]=t[a]);return r}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(r[a]=t[a])}return r}var c=i.createContext({}),h=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):o(o({},e),t)),a},d=function(t){var e=h(t.components);return i.createElement(c.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},l=i.forwardRef((function(t,e){var a=t.components,r=t.mdxType,n=t.originalType,c=t.parentName,d=s(t,["components","mdxType","originalType","parentName"]),l=h(a),f=r,m=l["".concat(c,".").concat(f)]||l[f]||u[f]||n;return a?i.createElement(m,o(o({ref:e},d),{},{components:a})):i.createElement(m,o({ref:e},d))}));function f(t,e){var a=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var n=a.length,o=new Array(n);o[0]=l;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:r,o[1]=s;for(var h=2;h{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>o,default:()=>u,frontMatter:()=>n,metadata:()=>s,toc:()=>h});var i=a(3117),r=(a(7294),a(3905));const n={id:"curated-text",displayed_sidebar:"tev2SideBar",term:"curated-text",termType:"concept",isa:null,glossaryTerm:"Curated Text",glossaryText:"a text that documents a [concept](@) or other [semantic unit](@) of a particular [party](@), and specifies, e.g., the [term(s)](@) by which the [party](@) refers thereto, its [definition](@), and any other relevant information.",grouptags:[],formPhrases:["curated-text{ss}","ctext{ss}"],status:"proposed",created:20220602,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Curated Text",s={unversionedId:"terms/curated-text",id:"terms/curated-text",title:"Curated Text",description:"A curated text is a text that documents a concept or other semantic unit of a particular party, and specifies, e.g., the term(s) by which the party refers thereto, its definition, and any other relevant information.",source:"@site/docs/terms/curated-text.md",sourceDirName:"terms",slug:"/terms/curated-text",permalink:"/tev2-specifications/docs/terms/curated-text",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curated-text.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curated-text",displayed_sidebar:"tev2SideBar",term:"curated-text",termType:"concept",isa:null,glossaryTerm:"Curated Text",glossaryText:"a text that documents a [concept](@) or other [semantic unit](@) of a particular [party](@), and specifies, e.g., the [term(s)](@) by which the [party](@) refers thereto, its [definition](@), and any other relevant information.",grouptags:[],formPhrases:["curated-text{ss}","ctext{ss}"],status:"proposed",created:20220602,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Notes",id:"notes",level:2}],d={toc:h};function u(t){let{components:e,...a}=t;return(0,r.kt)("wrapper",(0,i.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"curated-text"},"Curated Text"),(0,r.kt)("p",null,"A ",(0,r.kt)("strong",{parentName:"p"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"))," is a text that documents a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," consists of two parts: "),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),", which is a set of key-value pairs that are designed to facilitate automated processing;"),(0,r.kt)("li",{parentName:"ul"},"a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", that contains texts that are designed for human interpretation.")),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," live in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files"),", that may have been generated, e.g. from [ingress tools](docs/overview/tev2-architecture#ingress-tools), or may have been constructed manually (using a text editor).",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," are used for a variety of purposes, as they (may) contain texts that:",(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"are included in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," (one ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," for each ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),");"),(0,r.kt)("li",{parentName:"ul"},"are included in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs"),", and (in future), ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),";"),(0,r.kt)("li",{parentName:"ul"},"help ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," get a more in-depth understanding of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is being documented"),(0,r.kt)("li",{parentName:"ul"},"help ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to find out other, related ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," or other ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," related to that which is being described,\netc.")),(0,r.kt)("p",null,"The (technical) structure and syntax for files that contain ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," is specified ",(0,r.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"here"),"."),(0,r.kt)("p",null,"The manuals for ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/contributor/contributor-overview"},"contributors"),", ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/author/author-overview"},"authors")," and ",(0,r.kt)("a",{parentName:"p",href:"/docs/manuals/curator/curator-overview"},"curators")," will provide guidance for people that act in these respective roles as they work with ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),"."),(0,r.kt)("admonition",{title:"Editor's Note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Text needs to be revised from here onward. Here are some ideas to mention:"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},"contributors can suggest contents as per the curators instructions;"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," can write the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),";"),(0,r.kt)("li",{parentName:"ul"},"curators update the header of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," (conforming to the ",(0,r.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"ctext specifications"),";"),(0,r.kt)("li",{parentName:"ul"},"curators specify the process by which ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," progress/mature, and get statuses assigned;"),(0,r.kt)("li",{parentName:"ul"},"curators generate artifacts from 'decided on' ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", so that",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"rendering tools or generation tools used in other scopes can generate artifacts and"),(0,r.kt)("li",{parentName:"ul"},"people can subsequently access nicely rendered, human readable versions"))))),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,r.kt)("h2",{id:"purpose"},"Purpose"),(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," are intended to be processable by a variety of tools, that are chosen by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators"),". Together, these tools not only enable the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", but also the generation of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", and a better handling of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," in documentation, whitepapers and the like.",(0,r.kt)("p",null,"The precise conditions that ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," and ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"bodies")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," must satisfy will differ across ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," as ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," are autonomous in choosing their tools and ways of working. To support other participants of their ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," in making contributions, they will define an ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/ingestion",title:"Ingestion (Process): the process that is run by a Terms-community, in which their members suggest, draft, and discuss Definitions (Terms + Criteria) that are relevant for a particular Scope, and converting such contributions into Curated Texts that accurately document the Concepts and other Semantic Units and that adhere to the TEv2-specifications."},"ingestion process")," for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope(s)")," they ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curate"),", enabling such participants to contribute in ways that are easy for them."),(0,r.kt)("h2",{id:"notes"},"Notes"),(0,r.kt)("p",null,"The intention of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," is to document a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", which is something that has a place in the way of thinking within a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Ways of working (e.g. installation procedures), reports on research to be published in papers, etc., are NOT thought of as part of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", and hence should not be documented as a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". Having said that, this is not a closed discussion; we can think of arguments to the opposite, so who knows..."))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2ff88f8b.f001c824.js b/assets/js/2ff88f8b.d9d1a512.js similarity index 99% rename from assets/js/2ff88f8b.f001c824.js rename to assets/js/2ff88f8b.d9d1a512.js index f7bb1ca28..d53341b37 100644 --- a/assets/js/2ff88f8b.f001c824.js +++ b/assets/js/2ff88f8b.d9d1a512.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4193],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>p});var o=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function a(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function s(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=o.createContext({}),l=function(e){var t=o.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},h=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var i=e.components,n=e.mdxType,a=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),m=l(i),p=n,u=m["".concat(c,".").concat(p)]||m[p]||d[p]||a;return i?o.createElement(u,s(s({ref:t},h),{},{components:i})):o.createElement(u,s({ref:t},h))}));function p(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=i.length,s=new Array(a);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:n,s[1]=r;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var o=i(3117),n=(i(7294),i(3905));const a={id:"mental-model",displayed_sidebar:"tev2SideBar",term:"mental-model",termType:"concept",isa:"semantic-unit",glossaryTerm:"Mental Model",glossaryText:"a [semantic unit](@) that relates a set of [concepts](@) (ideas), [relations](@) between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').",grouptags:[],formPhrases:["mental-model{ss}","pattern{ss}","conceptual-model{ss}"],status:"proposed",created:20220606,updated:20220607,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Mental Model",r={unversionedId:"terms/mental-model",id:"terms/mental-model",title:"Mental Model",description:"Summary",source:"@site/docs/terms/mental-model.md",sourceDirName:"terms",slug:"/terms/mental-model",permalink:"/tev2-specifications/docs/terms/mental-model",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mental-model.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mental-model",displayed_sidebar:"tev2SideBar",term:"mental-model",termType:"concept",isa:"semantic-unit",glossaryTerm:"Mental Model",glossaryText:"a [semantic unit](@) that relates a set of [concepts](@) (ideas), [relations](@) between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').",grouptags:[],formPhrases:["mental-model{ss}","pattern{ss}","conceptual-model{ss}"],status:"proposed",created:20220606,updated:20220607,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Notes",id:"notes",level:3},{value:"On Using (existing) Mental models",id:"on-using-existing-mental-models",level:3},{value:"On the Construction of Mental Models",id:"on-the-construction-of-mental-models",level:3}],h={toc:l};function d(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,o.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"mental-model"},"Mental Model"),(0,n.kt)("h3",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Pattern"),", ",(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("a",{parentName:"strong",href:"https://en.wikipedia.org/wiki/Mental_model"},"mental model"))," or ",(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("a",{parentName:"strong",href:"https://en.wikipedia.org/wiki/Conceptual_model"},"conceptual model")),") is ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking'). Typically, the number of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," is limited, e.g. to ",(0,n.kt)("a",{parentName:"p",href:"http://psychclassics.yorku.ca/Miller/"},"the magical number 7, plus or minus 2"),", so that individuals can grasp it without making too many mistakes. The quality of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," is directly proportional to its fitness for serving its intended purpose(s), e.g., as a basis for architecting, designing, and implementing IT components and their ",(0,n.kt)("a",{href:"/framework/docs/terms/governance",title:"Governance: the act or process of governing or overseeing the realization of (the results associated with) a set of Objectives by the Owner of these Objectives, in order to ensure they will be fit for the purposes that this Owner intends to use them for."},"governance")," processes."),(0,n.kt)("p",null,"Since every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", it will need to be documented in such a way that the different people that work with it have a (provably) common understanding of what it entails. Typically, such documentation is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that would consist of an introductory text that explains the ideas behind the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," and the purposes for which it was designed, as well as a more formal specification of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," and constraints that it consists of. In order to be consistent, the description of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," must reside in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that also includes defines these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),". A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," may also 'connect' ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," of different ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (preferably no more than two), which you might call an 'interconnection pattern' between these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts (as a specialization of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),")."),(0,n.kt)("h3",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"A (good) mental model can be used"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"to facilitate one's thinking and reasoning about a specific topic, and/or deepen one's understanding of it."),(0,n.kt)("li",{parentName:"ul"},"to effectively explain backgrounds of one's reasoning/understanding of the mental model's topic."),(0,n.kt)("li",{parentName:"ul"},"to efficiently discuss and improve ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," in the mental model."),(0,n.kt)("li",{parentName:"ul"},"to write texts using precisely defined language.")),(0,n.kt)("h3",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A limited set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (preferably not exceeding 7+/-2)",(0,n.kt)("sup",{parentName:"p",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between such concepts, and constraints, such that together they form a coherent and consistent whole that can be used to explain one's thinking about a specific topic within a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,n.kt)("h3",{id:"notes"},"Notes"),(0,n.kt)("p",null,"The first purpose of a mental model is to help us think and reason about a certain topic or issue.\nOne signal that indicates the need of such a model is when we're running circles in our thoughts, and we have this feeling of not understanding, of the topic being (too) complex. Often, we are thinking in terms of concepts that are not fit for the ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," we pursue."),(0,n.kt)("h3",{id:"on-using-existing-mental-models"},"On Using (existing) Mental models"),(0,n.kt)("p",null,"A notorious ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/All_models_are_wrong#Quotations_of_George_Box"},"quotation of George Box"),' is that "all models are wrong", to which he later added "but some are useful". While he was talking about statistical models, his reasoning applies equally well to mental models. Paraphrasing this argument: *The real world is never ',(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("em",{parentName:"strong"},"exactly")),' represented by any model. However, cunningly chosen simple models often do provide remarkably useful approximations. We should not ask "Is the model true?". If "truth" is to be the "whole truth" the answer must be "No". The only question of interest is "Is the model illuminating and useful?"*. That\'s what we have tried to craft our models to.'),(0,n.kt)("p",null,"In other words: your choice of mental model isn't going to change the world for a bit. It only provides you with a particular perspective on reality. If you like the perspective, keep using the model. If not, use another one."),(0,n.kt)("p",null,"Having said that, the crux of using a mental model is that you commit to it for as long as you use it. This means you take whatever the model says to be the case, and you do not allow (parts of) other models or ways of thinking interfere, because it will make you inconsistent and incoherent."),(0,n.kt)("p",null,"For some people this is really easy:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Mathematicians have loads of models, a notorious set are the three geometries (",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Euclidean_geometry"},"Euclidian"),", ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Non-Euclidean_geometry#Elliptic_geometry"},"Elliptic")," and ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Non-Euclidean_geometry#Hyperbolic_geometry"},"Hyperbolic"),"). Depending on what they are doing, they choose one of the three, i.e. the one that fits their purpose best."),(0,n.kt)("li",{parentName:"ul"},"Physicists have them too, e.g. in the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Wave%E2%80%93particle_duality"},"duality principle of light")),(0,n.kt)("li",{parentName:"ul"},"Historians and astronomers are aware of the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Geocentric_model"},"geocentric world model")," that was used to prepare astrological and astronomical charts for over 1500 years. Copernic, Galileo and Kepler came with the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Heliocentrism"},"heliocentric model of the universe"),", which is only taking another perspective on reality (making it easier to prepare such charts).")),(0,n.kt)("p",null,"For other people, it is very difficult. The introduction of the heliocentric model encountered lots of opposition, for various reasons that did not have anything to do with the model's merits. We, too, find that some of our models (specifically: the ",(0,n.kt)("a",{href:"/framework/docs/terms/pattern-party-actor-action",title:"The Parties, Actors and Actions pattern captures the foundational concepts and relations that we need for thinking about how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."},"party-actor-action model"),") is sometimes opposed, where the arguments do not come from within the model itself (in attempts to falsify the model), but have other roots, setting the stage for incoherent and inconsistent argumentations."),(0,n.kt)("p",null,"Perhaps this is comparable with optical illusions, such as that of the ",(0,n.kt)("a",{parentName:"p",href:"https://www.google.com/search?source=univ&tbm=isch&q=optical+illusions+old+young+woman&fir=YIllsD9jihWxTM%252C1sZUL2jWNPvfxM%252C_%253BhsIzlU__RDe_nM%252Cyfw5Hii3UEmJHM%252C_%253Bk64g32oWxpYe8M%252CkqkPUja_z9NllM%252C_%253BFKMuqWLTX2wGtM%252CnTNCHp33apIpSM%252C_%253BEFfy6TSa8qgljM%252CPC_q2aBWJ95QfM%252C_%253BkFbAhDyYIR5MVM%252CWj0wk8hGQLHjWM%252C_%253BAX8XJjwDWQtyUM%252CiGJDEv3hShV9hM%252C_%253BeTsHDY5hHaPs9M%252CGOdBzeJDaJHS-M%252C_%253ByLBf8y95TCv1EM%252C0ZRLesUL5FW6sM%252C_%253Bg99V52yd0J1rOM%252CcYAag1F1qB6TaM%252C_%253BZHfvJXZFxHA4ZM%252CSqZ2N1ZFJLtPbM%252C_%253BXRMAn-j0tsUCvM%252C6vFweEnwB6_V1M%252C_%253BAoZByG4INAwYSM%252Cjhtnii31U6mWzM%252C_%253BCLrz5N2Kp8uAHM%252CmyjTMkeibmtg0M%252C_%253BpWT4mSz6-j-KOM%252CI0eh7eHVJVtHJM%252C_%253BPXcirTX8iQKiJM%252CP20yLZuYAjqV4M%252C_&usg=AI4_-kSPSjX9ixQFqsKa-4GnaDABoPxuKQ&sa=X&ved=2ahUKEwjr1tLOxZH4AhXfwAIHHSnuCXMQjJkEegQIAhAC&biw=1396&bih=665&dpr=1.38"},"old and young women")," let you experience first hand what difficulties you may have in relinquishing ideas you hold (about whether the picture represents one or the other). Only if you can do that, you can see from both perspectives, and at any point in time choose which is the most beneficial for you."),(0,n.kt)("p",null,"Most people may be between these extremes. The bottom line is that you should be decisive: you either use the model, or you don't. There is no in-between. Also, you should be attentive, and watch for any thoughts that may come up that might interfere, and cause you to become incoherent/inconsistent."),(0,n.kt)("p",null,"When assessing a model, start simple. Read the text, try to picture (or hear) what it says: try to follow (understand) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),". Try to figure out how the model would work in situations that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," did not describe (not: how the model is flawed because you cannot think of how it would work). Then find increasingly complex situations, and figure out how the model would work there. If you get stuck (anywhere during this process), then don't jump to conclusions, but rather find others that have used the model, and ask them how it might work."),(0,n.kt)("h3",{id:"on-the-construction-of-mental-models"},"On the Construction of Mental Models"),(0,n.kt)("p",null,"If you're acquianted with using mental models, you may want to construct your own. That is a task that needs to be taken on with care. You must allow the choices for its elements to be validated against many use-cases. Such validation instills trust that our model elements (",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", rules) are well-chosen. It also provides us with the experience (usually after some time) that it has made our thinking easier, and we are better equipped to resolve issues."),(0,n.kt)("p",null,"The careful construction is comparable to a quest: it takes time, multiple versions, and careful reflection. And it needs continuous validation of its parts, by throwing use-cases at it and verifying that the model can describe such cases, and do some reasoning with them."),(0,n.kt)("p",null,"This careful construction must ensure that the mental model gets different properties. For starters, the mental model must be able to reason in (all) static situations, where things do not change, and the so-called 'invariant' rules/constraints must hold. Also, the model must be able to cope with time-dependencies and changes, for which other kinds of rules apply."),(0,n.kt)("p",null,"In the end, the mental model needs to be expressed in several, different ways, depending on whom we want to convey the ideas behind it to. Business people generally need simple models that allow them to (roughly) grasp its gist. Software architects need models with precise definitions that allow them to use its elements in a (formal) reasoning. Software engineers (programmers) need all the details that allow them to create applications and databases that work according to the model's intent. So the level of detail that an expression of the model provides, makes it useful or useless to different audiences."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4193],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>p});var o=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function a(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function s(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=o.createContext({}),l=function(e){var t=o.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},h=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var i=e.components,n=e.mdxType,a=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),m=l(i),p=n,u=m["".concat(c,".").concat(p)]||m[p]||d[p]||a;return i?o.createElement(u,s(s({ref:t},h),{},{components:i})):o.createElement(u,s({ref:t},h))}));function p(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=i.length,s=new Array(a);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:n,s[1]=r;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var o=i(3117),n=(i(7294),i(3905));const a={id:"mental-model",displayed_sidebar:"tev2SideBar",term:"mental-model",termType:"concept",isa:"semantic-unit",glossaryTerm:"Mental Model",glossaryText:"a [semantic unit](@) that relates a set of [concepts](@) (ideas), [relations](@) between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').",grouptags:[],formPhrases:["mental-model{ss}","pattern{ss}","conceptual-model{ss}"],status:"proposed",created:20220606,updated:20220607,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Mental Model",r={unversionedId:"terms/mental-model",id:"terms/mental-model",title:"Mental Model",description:"Summary",source:"@site/docs/terms/mental-model.md",sourceDirName:"terms",slug:"/terms/mental-model",permalink:"/tev2-specifications/docs/terms/mental-model",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mental-model.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mental-model",displayed_sidebar:"tev2SideBar",term:"mental-model",termType:"concept",isa:"semantic-unit",glossaryTerm:"Mental Model",glossaryText:"a [semantic unit](@) that relates a set of [concepts](@) (ideas), [relations](@) between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').",grouptags:[],formPhrases:["mental-model{ss}","pattern{ss}","conceptual-model{ss}"],status:"proposed",created:20220606,updated:20220607,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Notes",id:"notes",level:3},{value:"On Using (existing) Mental models",id:"on-using-existing-mental-models",level:3},{value:"On the Construction of Mental Models",id:"on-the-construction-of-mental-models",level:3}],h={toc:l};function d(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,o.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"mental-model"},"Mental Model"),(0,n.kt)("h3",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Pattern"),", ",(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("a",{parentName:"strong",href:"https://en.wikipedia.org/wiki/Mental_model"},"mental model"))," or ",(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("a",{parentName:"strong",href:"https://en.wikipedia.org/wiki/Conceptual_model"},"conceptual model")),") is ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking'). Typically, the number of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," is limited, e.g. to ",(0,n.kt)("a",{parentName:"p",href:"http://psychclassics.yorku.ca/Miller/"},"the magical number 7, plus or minus 2"),", so that individuals can grasp it without making too many mistakes. The quality of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," is directly proportional to its fitness for serving its intended purpose(s), e.g., as a basis for architecting, designing, and implementing IT components and their ",(0,n.kt)("a",{href:"/framework/docs/terms/governance",title:"Governance: the act or process of governing or overseeing the realization of (the results associated with) a set of Objectives by the Owner of these Objectives, in order to ensure they will be fit for the purposes that this Owner intends to use them for."},"governance")," processes."),(0,n.kt)("p",null,"Since every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", it will need to be documented in such a way that the different people that work with it have a (provably) common understanding of what it entails. Typically, such documentation is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that would consist of an introductory text that explains the ideas behind the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern")," and the purposes for which it was designed, as well as a more formal specification of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," and constraints that it consists of. In order to be consistent, the description of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," must reside in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that also includes defines these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),". A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," may also 'connect' ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," of different ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (preferably no more than two), which you might call an 'interconnection pattern' between these ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts (as a specialization of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),")."),(0,n.kt)("h3",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"A (good) mental model can be used"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"to facilitate one's thinking and reasoning about a specific topic, and/or deepen one's understanding of it."),(0,n.kt)("li",{parentName:"ul"},"to effectively explain backgrounds of one's reasoning/understanding of the mental model's topic."),(0,n.kt)("li",{parentName:"ul"},"to efficiently discuss and improve ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," in the mental model."),(0,n.kt)("li",{parentName:"ul"},"to write texts using precisely defined language.")),(0,n.kt)("h3",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A limited set of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (preferably not exceeding 7+/-2)",(0,n.kt)("sup",{parentName:"p",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between such concepts, and constraints, such that together they form a coherent and consistent whole that can be used to explain one's thinking about a specific topic within a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,n.kt)("h3",{id:"notes"},"Notes"),(0,n.kt)("p",null,"The first purpose of a mental model is to help us think and reason about a certain topic or issue.\nOne signal that indicates the need of such a model is when we're running circles in our thoughts, and we have this feeling of not understanding, of the topic being (too) complex. Often, we are thinking in terms of concepts that are not fit for the ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," we pursue."),(0,n.kt)("h3",{id:"on-using-existing-mental-models"},"On Using (existing) Mental models"),(0,n.kt)("p",null,"A notorious ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/All_models_are_wrong#Quotations_of_George_Box"},"quotation of George Box"),' is that "all models are wrong", to which he later added "but some are useful". While he was talking about statistical models, his reasoning applies equally well to mental models. Paraphrasing this argument: *The real world is never ',(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("em",{parentName:"strong"},"exactly")),' represented by any model. However, cunningly chosen simple models often do provide remarkably useful approximations. We should not ask "Is the model true?". If "truth" is to be the "whole truth" the answer must be "No". The only question of interest is "Is the model illuminating and useful?"*. That\'s what we have tried to craft our models to.'),(0,n.kt)("p",null,"In other words: your choice of mental model isn't going to change the world for a bit. It only provides you with a particular perspective on reality. If you like the perspective, keep using the model. If not, use another one."),(0,n.kt)("p",null,"Having said that, the crux of using a mental model is that you commit to it for as long as you use it. This means you take whatever the model says to be the case, and you do not allow (parts of) other models or ways of thinking interfere, because it will make you inconsistent and incoherent."),(0,n.kt)("p",null,"For some people this is really easy:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Mathematicians have loads of models, a notorious set are the three geometries (",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Euclidean_geometry"},"Euclidian"),", ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Non-Euclidean_geometry#Elliptic_geometry"},"Elliptic")," and ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Non-Euclidean_geometry#Hyperbolic_geometry"},"Hyperbolic"),"). Depending on what they are doing, they choose one of the three, i.e. the one that fits their purpose best."),(0,n.kt)("li",{parentName:"ul"},"Physicists have them too, e.g. in the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Wave%E2%80%93particle_duality"},"duality principle of light")),(0,n.kt)("li",{parentName:"ul"},"Historians and astronomers are aware of the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Geocentric_model"},"geocentric world model")," that was used to prepare astrological and astronomical charts for over 1500 years. Copernic, Galileo and Kepler came with the ",(0,n.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Heliocentrism"},"heliocentric model of the universe"),", which is only taking another perspective on reality (making it easier to prepare such charts).")),(0,n.kt)("p",null,"For other people, it is very difficult. The introduction of the heliocentric model encountered lots of opposition, for various reasons that did not have anything to do with the model's merits. We, too, find that some of our models (specifically: the ",(0,n.kt)("a",{href:"/framework/docs/terms/pattern-party-actor-action",title:"The Parties, Actors and Actions pattern captures the foundational concepts and relations that we need for thinking about how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."},"party-actor-action model"),") is sometimes opposed, where the arguments do not come from within the model itself (in attempts to falsify the model), but have other roots, setting the stage for incoherent and inconsistent argumentations."),(0,n.kt)("p",null,"Perhaps this is comparable with optical illusions, such as that of the ",(0,n.kt)("a",{parentName:"p",href:"https://www.google.com/search?source=univ&tbm=isch&q=optical+illusions+old+young+woman&fir=YIllsD9jihWxTM%252C1sZUL2jWNPvfxM%252C_%253BhsIzlU__RDe_nM%252Cyfw5Hii3UEmJHM%252C_%253Bk64g32oWxpYe8M%252CkqkPUja_z9NllM%252C_%253BFKMuqWLTX2wGtM%252CnTNCHp33apIpSM%252C_%253BEFfy6TSa8qgljM%252CPC_q2aBWJ95QfM%252C_%253BkFbAhDyYIR5MVM%252CWj0wk8hGQLHjWM%252C_%253BAX8XJjwDWQtyUM%252CiGJDEv3hShV9hM%252C_%253BeTsHDY5hHaPs9M%252CGOdBzeJDaJHS-M%252C_%253ByLBf8y95TCv1EM%252C0ZRLesUL5FW6sM%252C_%253Bg99V52yd0J1rOM%252CcYAag1F1qB6TaM%252C_%253BZHfvJXZFxHA4ZM%252CSqZ2N1ZFJLtPbM%252C_%253BXRMAn-j0tsUCvM%252C6vFweEnwB6_V1M%252C_%253BAoZByG4INAwYSM%252Cjhtnii31U6mWzM%252C_%253BCLrz5N2Kp8uAHM%252CmyjTMkeibmtg0M%252C_%253BpWT4mSz6-j-KOM%252CI0eh7eHVJVtHJM%252C_%253BPXcirTX8iQKiJM%252CP20yLZuYAjqV4M%252C_&usg=AI4_-kSPSjX9ixQFqsKa-4GnaDABoPxuKQ&sa=X&ved=2ahUKEwjr1tLOxZH4AhXfwAIHHSnuCXMQjJkEegQIAhAC&biw=1396&bih=665&dpr=1.38"},"old and young women")," let you experience first hand what difficulties you may have in relinquishing ideas you hold (about whether the picture represents one or the other). Only if you can do that, you can see from both perspectives, and at any point in time choose which is the most beneficial for you."),(0,n.kt)("p",null,"Most people may be between these extremes. The bottom line is that you should be decisive: you either use the model, or you don't. There is no in-between. Also, you should be attentive, and watch for any thoughts that may come up that might interfere, and cause you to become incoherent/inconsistent."),(0,n.kt)("p",null,"When assessing a model, start simple. Read the text, try to picture (or hear) what it says: try to follow (understand) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),". Try to figure out how the model would work in situations that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," did not describe (not: how the model is flawed because you cannot think of how it would work). Then find increasingly complex situations, and figure out how the model would work there. If you get stuck (anywhere during this process), then don't jump to conclusions, but rather find others that have used the model, and ask them how it might work."),(0,n.kt)("h3",{id:"on-the-construction-of-mental-models"},"On the Construction of Mental Models"),(0,n.kt)("p",null,"If you're acquianted with using mental models, you may want to construct your own. That is a task that needs to be taken on with care. You must allow the choices for its elements to be validated against many use-cases. Such validation instills trust that our model elements (",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", rules) are well-chosen. It also provides us with the experience (usually after some time) that it has made our thinking easier, and we are better equipped to resolve issues."),(0,n.kt)("p",null,"The careful construction is comparable to a quest: it takes time, multiple versions, and careful reflection. And it needs continuous validation of its parts, by throwing use-cases at it and verifying that the model can describe such cases, and do some reasoning with them."),(0,n.kt)("p",null,"This careful construction must ensure that the mental model gets different properties. For starters, the mental model must be able to reason in (all) static situations, where things do not change, and the so-called 'invariant' rules/constraints must hold. Also, the model must be able to cope with time-dependencies and changes, for which other kinds of rules apply."),(0,n.kt)("p",null,"In the end, the mental model needs to be expressed in several, different ways, depending on whom we want to convey the ideas behind it to. Business people generally need simple models that allow them to (roughly) grasp its gist. Software architects need models with precise definitions that allow them to use its elements in a (formal) reasoning. Software engineers (programmers) need all the details that allow them to create applications and databases that work according to the model's intent. So the level of detail that an expression of the model provides, makes it useful or useless to different audiences."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/32836bf1.a0968033.js b/assets/js/32836bf1.7ae6cb59.js similarity index 99% rename from assets/js/32836bf1.a0968033.js rename to assets/js/32836bf1.7ae6cb59.js index 0c4b72821..6013083ce 100644 --- a/assets/js/32836bf1.a0968033.js +++ b/assets/js/32836bf1.7ae6cb59.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9111],{3905:(t,e,a)=>{a.d(e,{Zo:()=>h,kt:()=>p});var i=a(7294);function r(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function s(t){for(var e=1;e=0||(r[a]=t[a]);return r}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(r[a]=t[a])}return r}var c=i.createContext({}),d=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):s(s({},e),t)),a},h=function(t){var e=d(t.components);return i.createElement(c.Provider,{value:e},t.children)},l={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},f=i.forwardRef((function(t,e){var a=t.components,r=t.mdxType,n=t.originalType,c=t.parentName,h=o(t,["components","mdxType","originalType","parentName"]),f=d(a),p=r,m=f["".concat(c,".").concat(p)]||f[p]||l[p]||n;return a?i.createElement(m,s(s({ref:e},h),{},{components:a})):i.createElement(m,s({ref:e},h))}));function p(t,e){var a=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var n=a.length,s=new Array(n);s[0]=f;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:r,s[1]=o;for(var d=2;d{a.d(e,{Z:()=>c});var i=a(7294),r=a(6775);const n="apiTable_e8hp";function s(t,e){let{name:a,children:n}=t;const s=function(t){let e=t;for(;(0,i.isValidElement)(e);)[e]=i.Children.toArray(e.props.children);return e}(n),o=a?`${a}-${s}`:s,c=`#${o}`,d=(0,r.k6)();return i.createElement("tr",{id:o,tabIndex:0,ref:d.location.hash===c?e:void 0,onClick:t=>{"A"===t.target.tagName.toUpperCase()||d.push(c)},onKeyDown:t=>{"Enter"===t.key&&d.push(c)}},n.props.children)}const o=i.forwardRef(s);function c(t){let{children:e,name:a}=t;const[r,s]=i.Children.toArray(e.props.children),c=(0,i.useRef)(null);(0,i.useEffect)((()=>{c.current?.focus()}),[c]);const d=i.Children.map(s.props.children,(t=>i.createElement(o,{name:a,ref:c},t)));return i.createElement("table",{className:n},r,i.createElement("tbody",null,d))}},297:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>d,contentTitle:()=>o,default:()=>f,frontMatter:()=>s,metadata:()=>c,toc:()=>h});var i=a(3117),r=(a(7294),a(3905)),n=(a(4996),a(869));const s={id:"curated-text-file",date:20231009},o="Curated Text Files",c={unversionedId:"specs/files/curated-text-file",id:"specs/files/curated-text-file",title:"Curated Text Files",description:"Every curated text consists of two parts:",source:"@site/docs/specs/files/10-curated-text-file.md",sourceDirName:"specs/files",slug:"/specs/files/curated-text-file",permalink:"/tev2-specifications/docs/specs/files/curated-text-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/10-curated-text-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:10,frontMatter:{id:"curated-text-file",date:20231009},sidebar:"tev2SideBar",previous:{title:"Specifications - Files",permalink:"/tev2-specifications/docs/categories/specs-files"},next:{title:"Body Files",permalink:"/tev2-specifications/docs/specs/files/body-file"}},d={},h=[{value:"Header Structure",id:"header",level:2},{value:"Predefined TEv2 Header Fields",id:"header-fields",level:2}],l={toc:h};function f(t){let{components:e,...a}=t;return(0,r.kt)("wrapper",(0,i.Z)({},l,a,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"curated-text-files"},"Curated Text Files"),(0,r.kt)("p",null,"Every ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," consists of two parts:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (also called the '",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter"),"' of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"). It a set of (",(0,r.kt)("a",{parentName:"li",href:"https://yaml.org/spec/1.2.2/"},"YAML"),") key-value pairs that contain meta data about the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and/or data that could also have been part of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", but is so small that it doesn't warrant to have a dedicated section for it."),(0,r.kt)("li",{parentName:"ol"},"the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", that contains all other documentation. It has no fixed structure. When the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is to processed using a static site generator such as ",(0,r.kt)("a",{parentName:"li",href:"https://docusaurus.io/docs"},"Docusaurus v2"),", or ",(0,r.kt)("a",{parentName:"li",href:"https://pages.github.com/"},"github pages"),", it would typically contain (",(0,r.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/"},"markdown"),").")),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Example of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text file")," that contains a complete ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")),(0,r.kt)("div",null,(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'---\n# Docusaurus front matter\nid: ctext\nsidebar_label: Curated Texts\n# TEv2 Curated Text Header\nterm: curated-text\ntermType: concept\nglossaryTerm: Curated Text\nglossaryText: a text that documents a concept or other semantic unit of a particular party, and specifies, e.g., the term(s) by which the party refers thereto, its definition, and any other relevant information.\nformPhrases: [ "curated-text{ss}" ]\n# TEv2 Curation status\nstatus: proposed\ncreated: 20220602\nupdated: 20230814\n# Origins/Acknowledgements\ncontributors: RieksJ\nattribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)"\noriginalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"\n---\n\n# Curated Text\n\nA curated text starts with three dashes `---`.\nThis indicates the start of its (YAML) header.\nTypically, the header consists of a sequence of key-value pairs.\nThe header is terminated with another three dashes and a new line.\n\nThe body of the curated text typically starts behind the header block,\nbut it can also be placed in another file within the `scopedir`.\nThe body is typically markdown, but other constructs may be inserted\nthat contribute to the rendering of these texts in a (static) website.\nAn example of this is [MDX](https://mdxjs.com/).\nA discussion on these other constructs is outside the scope of this document.\n')))),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text file")," typically contains the complete ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". However, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," can be stored in a separate ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file"),", in which case, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," specifies where the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," is located."),(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"Curated text files")," live in a (sub)directory of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", which we call its ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir"),". The path of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," (relative to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),") can be found in the `curatedir` field of the [scope section](/docs/specs/files/saf#scope-section) in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".",(0,r.kt)("p",null,"This page specifies the syntax for ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", which boils down to specifying the structure of their ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers"),", as ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"bodies")," do not have any requirements for their structure that the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," need."),(0,r.kt)("h2",{id:"header"},"Header Structure"),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," starts with three dashes ",(0,r.kt)("inlineCode",{parentName:"p"},"---"),", which indicates the start of its (YAML) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),". This is followed by a sequence of key-value pairs (and comments). The ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," is terminated with another three dashes and a new line."),(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"Headers")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are used by ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," tools, but may also contain entries that are used by other tools, such as static site generators. The example above shows some entries that are used by (the static site generator) Docusaurus. In order to avoid confusion about which entries serve what purposes, it is advised to put them in different sections and separate these with comments, as shown in the example.",(0,r.kt)("h2",{id:"header-fields"},"Predefined TEv2 Header Fields"),(0,r.kt)("p",null,"Different ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," use header fields in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," for various purposes. Below is a list of fields that are known to be used by tools that either exist or are under construction. This list is by no means complete, because as tools may be extended, and new tools can be added, it is possible that other fields may have be in use in particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Legend"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,r.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,r.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,r.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,r.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,r.kt)(n.Z,{mdxType:"APITable"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Name"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"termType")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"Text")," that identifies the kind of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," describes. Typical values would be ",(0,r.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,r.kt)("inlineCode",{parentName:"td"},"mental-model"),"), or ",(0,r.kt)("inlineCode",{parentName:"td"},"usecase"),". If not specified, its value defaults to the ",(0,r.kt)("inlineCode",{parentName:"td"},"defaulttype"),"-field in the ",(0,r.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},"scope section")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"term")),(0,r.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,r.kt)("td",{parentName:"tr",align:null},"text that is used to refer to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is documented by this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"isa")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"Term identifier")," that identifies the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of which this is a specialization.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"bodyFile")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Path, relative to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", that contains the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". If not specified, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," in this file serves as the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"glossaryTerm")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that is used for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a human readable ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". For example, for a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," called ",(0,r.kt)("inlineCode",{parentName:"td"},"member"),", you may want to specify a glossaryTerm ",(0,r.kt)("inlineCode",{parentName:"td"},'member (of a community)'),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"glossaryText")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that is used as the (raw) contents for the entry of this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a human readable ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". This text MUST be expected to contain ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"synonymOf")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"Term identifier")," that identifies the defined ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which this is a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"grouptags")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"List of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags"),", each of which signifies that the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"(scoped) term")," that this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents, is part of the group of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it represents.",(0,r.kt)("br",null),"Example: ",(0,r.kt)("inlineCode",{parentName:"td"},"[tev2, management]"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"formPhrases")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"List of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"texts")," that are ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#id",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"used to convert")," the ",(0,r.kt)("inlineCode",{parentName:"td"},"show text")," parts of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," into ",(0,r.kt)("inlineCode",{parentName:"td"},"term"),"s, for the purpose of accommodating plural forms (for nouns) or conjugate forms (for verbs). For details, see ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#specifying",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"specifying form phrases"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"status")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that identifies the status of the term. (",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," of) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," may specify values for this field. An example is the ",(0,r.kt)("a",{parentName:"td",href:"https://github.com/trustoverip/concepts-and-terminology-wg/blob/master/docs/status-tags.md"},"status tags used by ToIP"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"created")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Date at which of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," was created, in the date format as used within this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"updated")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Date at which of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," was last modified, in the date format as used within this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"contributors")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that shows (or refers to) the people that have contributed to this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"attribution")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that credits the original creation of the texts in the document.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"originalLicense")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Reference to the license of the work from which the texts were derived."))))),(0,r.kt)("admonition",{title:"Editor's note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Do we need to provide more guidance, e.g., regarding the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter")," fields that may be used by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," for converting ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", e.g. with popovers?")))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9111],{3905:(t,e,a)=>{a.d(e,{Zo:()=>h,kt:()=>p});var i=a(7294);function r(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function s(t){for(var e=1;e=0||(r[a]=t[a]);return r}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(r[a]=t[a])}return r}var c=i.createContext({}),d=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):s(s({},e),t)),a},h=function(t){var e=d(t.components);return i.createElement(c.Provider,{value:e},t.children)},l={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},f=i.forwardRef((function(t,e){var a=t.components,r=t.mdxType,n=t.originalType,c=t.parentName,h=o(t,["components","mdxType","originalType","parentName"]),f=d(a),p=r,m=f["".concat(c,".").concat(p)]||f[p]||l[p]||n;return a?i.createElement(m,s(s({ref:e},h),{},{components:a})):i.createElement(m,s({ref:e},h))}));function p(t,e){var a=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var n=a.length,s=new Array(n);s[0]=f;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:r,s[1]=o;for(var d=2;d{a.d(e,{Z:()=>c});var i=a(7294),r=a(6775);const n="apiTable_e8hp";function s(t,e){let{name:a,children:n}=t;const s=function(t){let e=t;for(;(0,i.isValidElement)(e);)[e]=i.Children.toArray(e.props.children);return e}(n),o=a?`${a}-${s}`:s,c=`#${o}`,d=(0,r.k6)();return i.createElement("tr",{id:o,tabIndex:0,ref:d.location.hash===c?e:void 0,onClick:t=>{"A"===t.target.tagName.toUpperCase()||d.push(c)},onKeyDown:t=>{"Enter"===t.key&&d.push(c)}},n.props.children)}const o=i.forwardRef(s);function c(t){let{children:e,name:a}=t;const[r,s]=i.Children.toArray(e.props.children),c=(0,i.useRef)(null);(0,i.useEffect)((()=>{c.current?.focus()}),[c]);const d=i.Children.map(s.props.children,(t=>i.createElement(o,{name:a,ref:c},t)));return i.createElement("table",{className:n},r,i.createElement("tbody",null,d))}},297:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>d,contentTitle:()=>o,default:()=>f,frontMatter:()=>s,metadata:()=>c,toc:()=>h});var i=a(3117),r=(a(7294),a(3905)),n=(a(4996),a(869));const s={id:"curated-text-file",date:20231009},o="Curated Text Files",c={unversionedId:"specs/files/curated-text-file",id:"specs/files/curated-text-file",title:"Curated Text Files",description:"Every curated text consists of two parts:",source:"@site/docs/specs/files/10-curated-text-file.md",sourceDirName:"specs/files",slug:"/specs/files/curated-text-file",permalink:"/tev2-specifications/docs/specs/files/curated-text-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/10-curated-text-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:10,frontMatter:{id:"curated-text-file",date:20231009},sidebar:"tev2SideBar",previous:{title:"Specifications - Files",permalink:"/tev2-specifications/docs/categories/specs-files"},next:{title:"Body Files",permalink:"/tev2-specifications/docs/specs/files/body-file"}},d={},h=[{value:"Header Structure",id:"header",level:2},{value:"Predefined TEv2 Header Fields",id:"header-fields",level:2}],l={toc:h};function f(t){let{components:e,...a}=t;return(0,r.kt)("wrapper",(0,i.Z)({},l,a,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"curated-text-files"},"Curated Text Files"),(0,r.kt)("p",null,"Every ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," consists of two parts:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," (also called the '",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter"),"' of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"). It a set of (",(0,r.kt)("a",{parentName:"li",href:"https://yaml.org/spec/1.2.2/"},"YAML"),") key-value pairs that contain meta data about the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and/or data that could also have been part of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", but is so small that it doesn't warrant to have a dedicated section for it."),(0,r.kt)("li",{parentName:"ol"},"the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),", that contains all other documentation. It has no fixed structure. When the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is to processed using a static site generator such as ",(0,r.kt)("a",{parentName:"li",href:"https://docusaurus.io/docs"},"Docusaurus v2"),", or ",(0,r.kt)("a",{parentName:"li",href:"https://pages.github.com/"},"github pages"),", it would typically contain (",(0,r.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/"},"markdown"),").")),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Example of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text file")," that contains a complete ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")),(0,r.kt)("div",null,(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'---\n# Docusaurus front matter\nid: ctext\nsidebar_label: Curated Texts\n# TEv2 Curated Text Header\nterm: curated-text\ntermType: concept\nglossaryTerm: Curated Text\nglossaryText: a text that documents a concept or other semantic unit of a particular party, and specifies, e.g., the term(s) by which the party refers thereto, its definition, and any other relevant information.\nformPhrases: [ "curated-text{ss}" ]\n# TEv2 Curation status\nstatus: proposed\ncreated: 20220602\nupdated: 20230814\n# Origins/Acknowledgements\ncontributors: RieksJ\nattribution: "[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)"\noriginalLicense: "[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"\n---\n\n# Curated Text\n\nA curated text starts with three dashes `---`.\nThis indicates the start of its (YAML) header.\nTypically, the header consists of a sequence of key-value pairs.\nThe header is terminated with another three dashes and a new line.\n\nThe body of the curated text typically starts behind the header block,\nbut it can also be placed in another file within the `scopedir`.\nThe body is typically markdown, but other constructs may be inserted\nthat contribute to the rendering of these texts in a (static) website.\nAn example of this is [MDX](https://mdxjs.com/).\nA discussion on these other constructs is outside the scope of this document.\n')))),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text file")," typically contains the complete ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". However, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," can be stored in a separate ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file"),", in which case, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," specifies where the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," is located."),(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"Curated text files")," live in a (sub)directory of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", which we call its ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir"),". The path of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," (relative to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),") can be found in the `curatedir` field of the [scope section](/docs/specs/files/saf#scope-section) in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".",(0,r.kt)("p",null,"This page specifies the syntax for ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", which boils down to specifying the structure of their ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers"),", as ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"bodies")," do not have any requirements for their structure that the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," need."),(0,r.kt)("h2",{id:"header"},"Header Structure"),(0,r.kt)("p",null,"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," starts with three dashes ",(0,r.kt)("inlineCode",{parentName:"p"},"---"),", which indicates the start of its (YAML) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),". This is followed by a sequence of key-value pairs (and comments). The ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," is terminated with another three dashes and a new line."),(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"Headers")," of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are used by ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," tools, but may also contain entries that are used by other tools, such as static site generators. The example above shows some entries that are used by (the static site generator) Docusaurus. In order to avoid confusion about which entries serve what purposes, it is advised to put them in different sections and separate these with comments, as shown in the example.",(0,r.kt)("h2",{id:"header-fields"},"Predefined TEv2 Header Fields"),(0,r.kt)("p",null,"Different ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," use header fields in ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," for various purposes. Below is a list of fields that are known to be used by tools that either exist or are under construction. This list is by no means complete, because as tools may be extended, and new tools can be added, it is possible that other fields may have be in use in particular ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Legend"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,r.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,r.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,r.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,r.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,r.kt)(n.Z,{mdxType:"APITable"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Name"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"termType")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"Text")," that identifies the kind of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," describes. Typical values would be ",(0,r.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,r.kt)("inlineCode",{parentName:"td"},"mental-model"),"), or ",(0,r.kt)("inlineCode",{parentName:"td"},"usecase"),". If not specified, its value defaults to the ",(0,r.kt)("inlineCode",{parentName:"td"},"defaulttype"),"-field in the ",(0,r.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},"scope section")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"term")),(0,r.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,r.kt)("td",{parentName:"tr",align:null},"text that is used to refer to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is documented by this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"isa")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"Term identifier")," that identifies the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of which this is a specialization.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"bodyFile")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Path, relative to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", that contains the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". If not specified, the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," in this file serves as the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"glossaryTerm")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that is used for the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a human readable ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". For example, for a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," called ",(0,r.kt)("inlineCode",{parentName:"td"},"member"),", you may want to specify a glossaryTerm ",(0,r.kt)("inlineCode",{parentName:"td"},'member (of a community)'),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"glossaryText")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that is used as the (raw) contents for the entry of this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a human readable ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". This text MUST be expected to contain ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"synonymOf")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"Term identifier")," that identifies the defined ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which this is a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"grouptags")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"List of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags"),", each of which signifies that the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"(scoped) term")," that this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents, is part of the group of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it represents.",(0,r.kt)("br",null),"Example: ",(0,r.kt)("inlineCode",{parentName:"td"},"[tev2, management]"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"formPhrases")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"List of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"texts")," that are ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#id",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"used to convert")," the ",(0,r.kt)("inlineCode",{parentName:"td"},"show text")," parts of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," into ",(0,r.kt)("inlineCode",{parentName:"td"},"term"),"s, for the purpose of accommodating plural forms (for nouns) or conjugate forms (for verbs). For details, see ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#specifying",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"specifying form phrases"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"status")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that identifies the status of the term. (",(0,r.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," of) ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," may specify values for this field. An example is the ",(0,r.kt)("a",{parentName:"td",href:"https://github.com/trustoverip/concepts-and-terminology-wg/blob/master/docs/status-tags.md"},"status tags used by ToIP"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"created")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Date at which of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," was created, in the date format as used within this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"updated")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Date at which of the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," was last modified, in the date format as used within this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"contributors")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that shows (or refers to) the people that have contributed to this ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"attribution")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Text that credits the original creation of the texts in the document.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},(0,r.kt)("inlineCode",{parentName:"td"},"originalLicense")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:null},"Reference to the license of the work from which the texts were derived."))))),(0,r.kt)("admonition",{title:"Editor's note",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Do we need to provide more guidance, e.g., regarding the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter")," fields that may be used by the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," for converting ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", e.g. with popovers?")))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/358bfd91.1f9dfaa7.js b/assets/js/358bfd91.9de08b05.js similarity index 99% rename from assets/js/358bfd91.1f9dfaa7.js rename to assets/js/358bfd91.9de08b05.js index e6549c3be..75775c4c3 100644 --- a/assets/js/358bfd91.1f9dfaa7.js +++ b/assets/js/358bfd91.9de08b05.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1351],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>f});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},l=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},h=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),h=m(i),f=o,p=h["".concat(c,".").concat(f)]||h[f]||d[f]||n;return i?a.createElement(p,r(r({ref:t},l),{},{components:i})):a.createElement(p,r({ref:t},l))}));function f(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=i.length,r=new Array(n);r[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,r[1]=s;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>n,mark:()=>l,metadata:()=>s,toc:()=>m});var a=i(3117),o=(i(7294),i(3905));i(4996);const n={id:"tev2-common-understanding",sidebar_label:"Understanding One Another",description:"The needs of a community that wants to create and maintain a shared understanding.",date:20220513},r="Enabling a Common Understanding in a Community",s={unversionedId:"overview/tev2-common-understanding",id:"overview/tev2-common-understanding",title:"Enabling a Common Understanding in a Community",description:"The needs of a community that wants to create and maintain a shared understanding.",source:"@site/docs/overview/00-tev2-common-understanding.md",sourceDirName:"overview",slug:"/overview/tev2-common-understanding",permalink:"/tev2-specifications/docs/overview/tev2-common-understanding",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/00-tev2-common-understanding.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:0,frontMatter:{id:"tev2-common-understanding",sidebar_label:"Understanding One Another",description:"The needs of a community that wants to create and maintain a shared understanding.",date:20220513},sidebar:"tev2SideBar",previous:{title:"Overview",permalink:"/tev2-specifications/docs/categories/overview"},next:{title:"Purpose",permalink:"/tev2-specifications/docs/overview/tev2-purpose"}},c={},m=[],l=e=>{let{children:t}=e;return(0,o.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},d={toc:m,mark:l};function h(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"enabling-a-common-understanding-in-a-community"},"Enabling a Common Understanding in a Community"),(0,o.kt)("p",null,"In order for a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (e.g. a workgroup, taskforce, project/product team, department, etc.) to realize its ",(0,o.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),", it is beneficial that its members have a common set of the ideas, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are relevant for realizing these ",(0,o.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". The ability to realize such a common understanding, and to demonstrate that this is actually the case, is a critical capability for success."),(0,o.kt)("p",null,"The Terminology Engine (v2) is a set of specifications and tools that (technically) facilitate such capabilities, by recognizing that each ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," wants (and needs):"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"its own ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that can develop over time (producing different versions);"),(0,o.kt)("li",{parentName:"ul"},"to autonomously ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"define")," specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", create its particular documentation for its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," or other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),";"),(0,o.kt)("li",{parentName:"ul"},"to 'import' (borrow, include, use) specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are defined by other ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities"),";"),(0,o.kt)("li",{parentName:"ul"},"to make its own ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," available for other ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," to 'import';"),(0,o.kt)("li",{parentName:"ul"},"to generate tangible artifacts such as ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries")," and other documentation (specifications, white papers, etc.) that actually use the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as committed to by (each member of) the ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),".")),(0,o.kt)("p",null,"This technical support must, however, be complemented with methods that a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," will actually use to produce and maintain its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". ",(0,o.kt)("mark",null,"We need to decide whether or not to provide guidance for that as well.")),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"(",(0,o.kt)("a",{parentName:"p",href:"https://link.springer.com/article/10.1007/s10588-021-09326-z"},"Agredo-Delgado, et. al., 2021"),")",(0,o.kt)("sup",{parentName:"p",id:"fnref-1"},(0,o.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1"))," have tested a process for constructing a shared understanding in computer-supported collaborative work, where the construction part consists of 4 steps:"),(0,o.kt)("ol",{parentName:"admonition"},(0,o.kt)("li",{parentName:"ol"},"each group member acquires an individual understanding of the subject;"),(0,o.kt)("li",{parentName:"ol"},"each group member exposes his/her ideas and the others actively listen to them;"),(0,o.kt)("li",{parentName:"ol"},"the group refines, builds or modifies the original ideas;"),(0,o.kt)("li",{parentName:"ol"},"the differences of interpretation between the group members are dealt with in a constructive fashion, through arguments and clarifications."))),(0,o.kt)("div",{className:"footnotes"},(0,o.kt)("hr",{parentName:"div"}),(0,o.kt)("ol",{parentName:"div"},(0,o.kt)("li",{parentName:"ol",id:"fn-1"},"Agredo-Delgado, V., Ruiz, P.H., Mon, A. et al. Applying a process for the shared understanding construction in computer-supported collaborative work: an experiment. Comput Math Organ Theory 28, 247-270 (2022). ",(0,o.kt)("a",{parentName:"li",href:"https://doi.org/10.1007/s10588-021-09326-z"},"https://doi.org/10.1007/s10588-021-09326-z"),(0,o.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}h.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1351],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>f});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},l=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},h=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),h=m(i),f=o,p=h["".concat(c,".").concat(f)]||h[f]||d[f]||n;return i?a.createElement(p,r(r({ref:t},l),{},{components:i})):a.createElement(p,r({ref:t},l))}));function f(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=i.length,r=new Array(n);r[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,r[1]=s;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>n,mark:()=>l,metadata:()=>s,toc:()=>m});var a=i(3117),o=(i(7294),i(3905));i(4996);const n={id:"tev2-common-understanding",sidebar_label:"Understanding One Another",description:"The needs of a community that wants to create and maintain a shared understanding.",date:20220513},r="Enabling a Common Understanding in a Community",s={unversionedId:"overview/tev2-common-understanding",id:"overview/tev2-common-understanding",title:"Enabling a Common Understanding in a Community",description:"The needs of a community that wants to create and maintain a shared understanding.",source:"@site/docs/overview/00-tev2-common-understanding.md",sourceDirName:"overview",slug:"/overview/tev2-common-understanding",permalink:"/tev2-specifications/docs/overview/tev2-common-understanding",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/00-tev2-common-understanding.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:0,frontMatter:{id:"tev2-common-understanding",sidebar_label:"Understanding One Another",description:"The needs of a community that wants to create and maintain a shared understanding.",date:20220513},sidebar:"tev2SideBar",previous:{title:"Overview",permalink:"/tev2-specifications/docs/categories/overview"},next:{title:"Purpose",permalink:"/tev2-specifications/docs/overview/tev2-purpose"}},c={},m=[],l=e=>{let{children:t}=e;return(0,o.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},d={toc:m,mark:l};function h(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"enabling-a-common-understanding-in-a-community"},"Enabling a Common Understanding in a Community"),(0,o.kt)("p",null,"In order for a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (e.g. a workgroup, taskforce, project/product team, department, etc.) to realize its ",(0,o.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),", it is beneficial that its members have a common set of the ideas, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are relevant for realizing these ",(0,o.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". The ability to realize such a common understanding, and to demonstrate that this is actually the case, is a critical capability for success."),(0,o.kt)("p",null,"The Terminology Engine (v2) is a set of specifications and tools that (technically) facilitate such capabilities, by recognizing that each ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," wants (and needs):"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"its own ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that can develop over time (producing different versions);"),(0,o.kt)("li",{parentName:"ul"},"to autonomously ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"define")," specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", create its particular documentation for its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," or other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),";"),(0,o.kt)("li",{parentName:"ul"},"to 'import' (borrow, include, use) specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are defined by other ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities"),";"),(0,o.kt)("li",{parentName:"ul"},"to make its own ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," available for other ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"communities")," to 'import';"),(0,o.kt)("li",{parentName:"ul"},"to generate tangible artifacts such as ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries")," and other documentation (specifications, white papers, etc.) that actually use the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," as committed to by (each member of) the ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),".")),(0,o.kt)("p",null,"This technical support must, however, be complemented with methods that a ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," will actually use to produce and maintain its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". ",(0,o.kt)("mark",null,"We need to decide whether or not to provide guidance for that as well.")),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"(",(0,o.kt)("a",{parentName:"p",href:"https://link.springer.com/article/10.1007/s10588-021-09326-z"},"Agredo-Delgado, et. al., 2021"),")",(0,o.kt)("sup",{parentName:"p",id:"fnref-1"},(0,o.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1"))," have tested a process for constructing a shared understanding in computer-supported collaborative work, where the construction part consists of 4 steps:"),(0,o.kt)("ol",{parentName:"admonition"},(0,o.kt)("li",{parentName:"ol"},"each group member acquires an individual understanding of the subject;"),(0,o.kt)("li",{parentName:"ol"},"each group member exposes his/her ideas and the others actively listen to them;"),(0,o.kt)("li",{parentName:"ol"},"the group refines, builds or modifies the original ideas;"),(0,o.kt)("li",{parentName:"ol"},"the differences of interpretation between the group members are dealt with in a constructive fashion, through arguments and clarifications."))),(0,o.kt)("div",{className:"footnotes"},(0,o.kt)("hr",{parentName:"div"}),(0,o.kt)("ol",{parentName:"div"},(0,o.kt)("li",{parentName:"ol",id:"fn-1"},"Agredo-Delgado, V., Ruiz, P.H., Mon, A. et al. Applying a process for the shared understanding construction in computer-supported collaborative work: an experiment. Comput Math Organ Theory 28, 247-270 (2022). ",(0,o.kt)("a",{parentName:"li",href:"https://doi.org/10.1007/s10588-021-09326-z"},"https://doi.org/10.1007/s10588-021-09326-z"),(0,o.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/361f2510.99d3af36.js b/assets/js/361f2510.3b071128.js similarity index 98% rename from assets/js/361f2510.99d3af36.js rename to assets/js/361f2510.3b071128.js index 76e179466..663c0d357 100644 --- a/assets/js/361f2510.99d3af36.js +++ b/assets/js/361f2510.3b071128.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1911],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>f});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},g={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},u=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,a=e.originalType,c=e.parentName,l=i(e,["components","mdxType","originalType","parentName"]),u=p(r),f=s,d=u["".concat(c,".").concat(f)]||u[f]||g[f]||a;return r?o.createElement(d,n(n({ref:t},l),{},{components:r})):o.createElement(d,n({ref:t},l))}));function f(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var a=r.length,n=new Array(a);n[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:s,n[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>g,frontMatter:()=>a,metadata:()=>i,toc:()=>p});var o=r(3117),s=(r(7294),r(3905));const a={id:"regex",displayed_sidebar:"tev2SideBar",term:"regex",termType:"concept",isa:null,glossaryTerm:"Regular Expression",glossaryAbbr:"Regex",glossaryText:"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",glossaryNotes:["Within [TEv2](@), we use a [JavaScript flavor (ECMAScript 2022)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp)."],grouptags:[],formPhrases:["regex","regexes","regexp{ss}","regular-expression{ss}"],status:"proposed",created:20231219,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Regular Expression (Regex)",i={unversionedId:"terms/regex",id:"terms/regex",title:"Regular Expression (Regex)",description:"A Regular Expression or regex is a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",source:"@site/docs/terms/regex.md",sourceDirName:"terms",slug:"/terms/regex",permalink:"/tev2-specifications/docs/terms/regex",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/regex.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"regex",displayed_sidebar:"tev2SideBar",term:"regex",termType:"concept",isa:null,glossaryTerm:"Regular Expression",glossaryAbbr:"Regex",glossaryText:"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",glossaryNotes:["Within [TEv2](@), we use a [JavaScript flavor (ECMAScript 2022)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp)."],grouptags:[],formPhrases:["regex","regexes","regexp{ss}","regular-expression{ss}"],status:"proposed",created:20231219,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],l={toc:p};function g(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"regular-expression-regex"},"Regular Expression (Regex)"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Regular Expression")," or ",(0,s.kt)("strong",{parentName:"p"},"regex")," is a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("p",null,"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use the ",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)")," as the language to use for regexes."),(0,s.kt)("p",null,"For details, you may consult the ",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions"},"Mozilla user guide"),", but there are many other resources on the Internet as well."))}g.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1911],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>f});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},g={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},u=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,a=e.originalType,c=e.parentName,l=i(e,["components","mdxType","originalType","parentName"]),u=p(r),f=s,d=u["".concat(c,".").concat(f)]||u[f]||g[f]||a;return r?o.createElement(d,n(n({ref:t},l),{},{components:r})):o.createElement(d,n({ref:t},l))}));function f(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var a=r.length,n=new Array(a);n[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:s,n[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>g,frontMatter:()=>a,metadata:()=>i,toc:()=>p});var o=r(3117),s=(r(7294),r(3905));const a={id:"regex",displayed_sidebar:"tev2SideBar",term:"regex",termType:"concept",isa:null,glossaryTerm:"Regular Expression",glossaryAbbr:"Regex",glossaryText:"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",glossaryNotes:["Within [TEv2](@), we use a [JavaScript flavor (ECMAScript 2022)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp)."],grouptags:[],formPhrases:["regex","regexes","regexp{ss}","regular-expression{ss}"],status:"proposed",created:20231219,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Regular Expression (Regex)",i={unversionedId:"terms/regex",id:"terms/regex",title:"Regular Expression (Regex)",description:"A Regular Expression or regex is a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",source:"@site/docs/terms/regex.md",sourceDirName:"terms",slug:"/terms/regex",permalink:"/tev2-specifications/docs/terms/regex",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/regex.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"regex",displayed_sidebar:"tev2SideBar",term:"regex",termType:"concept",isa:null,glossaryTerm:"Regular Expression",glossaryAbbr:"Regex",glossaryText:"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",glossaryNotes:["Within [TEv2](@), we use a [JavaScript flavor (ECMAScript 2022)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp)."],grouptags:[],formPhrases:["regex","regexes","regexp{ss}","regular-expression{ss}"],status:"proposed",created:20231219,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],l={toc:p};function g(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"regular-expression-regex"},"Regular Expression (Regex)"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Regular Expression")," or ",(0,s.kt)("strong",{parentName:"p"},"regex")," is a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("p",null,"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use the ",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)")," as the language to use for regexes."),(0,s.kt)("p",null,"For details, you may consult the ",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions"},"Mozilla user guide"),", but there are many other resources on the Internet as well."))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/3723a308.0fa7d01a.js b/assets/js/3723a308.c13c371e.js similarity index 99% rename from assets/js/3723a308.0fa7d01a.js rename to assets/js/3723a308.c13c371e.js index 898d1975a..57e8223b7 100644 --- a/assets/js/3723a308.0fa7d01a.js +++ b/assets/js/3723a308.c13c371e.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6667],{3905:(e,t,r)=>{r.d(t,{Zo:()=>f,kt:()=>h});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function a(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),l=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},f=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},d=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,f=n(e,["components","mdxType","originalType","parentName"]),d=l(r),h=s,u=d["".concat(c,".").concat(h)]||d[h]||p[h]||i;return r?o.createElement(u,a(a({ref:t},f),{},{components:r})):o.createElement(u,a({ref:t},f))}));function h(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=r.length,a=new Array(i);a[0]=d;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:s,a[1]=n;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>p,frontMatter:()=>i,metadata:()=>n,toc:()=>l});var o=r(3117),s=(r(7294),r(3905));const i={id:"sorter",displayed_sidebar:"tev2SideBar",term:"sorter",termType:"concept",isa:null,glossaryTerm:"Sorter",glossaryText:"a specification, in the form of a predefined value or a [handlebars template](@), of the value that is to be used for sorting a list, e.g., for sorting [HRG entries](@) within a [HRG list](@).",grouptags:[],formPhrases:["sorter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a="Sorter",n={unversionedId:"terms/sorter",id:"terms/sorter",title:"Sorter",description:"A sorter is a specification, in the form of a predefined value or a handlebars template, of the value that is to be used for sorting a list, e.g., for sorting HRG entries within a HRG list.",source:"@site/docs/terms/sorter.md",sourceDirName:"terms",slug:"/terms/sorter",permalink:"/tev2-specifications/docs/terms/sorter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/sorter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"sorter",displayed_sidebar:"tev2SideBar",term:"sorter",termType:"concept",isa:null,glossaryTerm:"Sorter",glossaryText:"a specification, in the form of a predefined value or a [handlebars template](@), of the value that is to be used for sorting a list, e.g., for sorting [HRG entries](@) within a [HRG list](@).",grouptags:[],formPhrases:["sorter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],f={toc:l};function p(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},f,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"sorter"},"Sorter"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"sorter")," is a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"specifications")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," will tell you whether or not sorting is necessary and if so, which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorters")," are predefined for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool"),". Note that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorters")," can use ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/moustache-variable",title:"Moustache Variable: a placeholder in the form of a 'moustache' tag, e.g.: ``, that are used by Converters to produce a text by which a text construct that is located by an Interpreter will be replaced. See also https://mustache.github.io/mustache.5.html"},"moustache variables")," that are specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of that tool."),(0,s.kt)("admonition",{title:"Editor's note",type:"info"},(0,s.kt)("p",{parentName:"admonition"},"We could perhaps add references to appropriate sections of relevant tools, so that readers can see examples of this.")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6667],{3905:(e,t,r)=>{r.d(t,{Zo:()=>f,kt:()=>h});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function a(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),l=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},f=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},d=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,f=n(e,["components","mdxType","originalType","parentName"]),d=l(r),h=s,u=d["".concat(c,".").concat(h)]||d[h]||p[h]||i;return r?o.createElement(u,a(a({ref:t},f),{},{components:r})):o.createElement(u,a({ref:t},f))}));function h(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=r.length,a=new Array(i);a[0]=d;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:s,a[1]=n;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>p,frontMatter:()=>i,metadata:()=>n,toc:()=>l});var o=r(3117),s=(r(7294),r(3905));const i={id:"sorter",displayed_sidebar:"tev2SideBar",term:"sorter",termType:"concept",isa:null,glossaryTerm:"Sorter",glossaryText:"a specification, in the form of a predefined value or a [handlebars template](@), of the value that is to be used for sorting a list, e.g., for sorting [HRG entries](@) within a [HRG list](@).",grouptags:[],formPhrases:["sorter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a="Sorter",n={unversionedId:"terms/sorter",id:"terms/sorter",title:"Sorter",description:"A sorter is a specification, in the form of a predefined value or a handlebars template, of the value that is to be used for sorting a list, e.g., for sorting HRG entries within a HRG list.",source:"@site/docs/terms/sorter.md",sourceDirName:"terms",slug:"/terms/sorter",permalink:"/tev2-specifications/docs/terms/sorter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/sorter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"sorter",displayed_sidebar:"tev2SideBar",term:"sorter",termType:"concept",isa:null,glossaryTerm:"Sorter",glossaryText:"a specification, in the form of a predefined value or a [handlebars template](@), of the value that is to be used for sorting a list, e.g., for sorting [HRG entries](@) within a [HRG list](@).",grouptags:[],formPhrases:["sorter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],f={toc:l};function p(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},f,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"sorter"},"Sorter"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"sorter")," is a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"specifications")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," will tell you whether or not sorting is necessary and if so, which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorters")," are predefined for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool"),". Note that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorters")," can use ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/moustache-variable",title:"Moustache Variable: a placeholder in the form of a 'moustache' tag, e.g.: ``, that are used by Converters to produce a text by which a text construct that is located by an Interpreter will be replaced. See also https://mustache.github.io/mustache.5.html"},"moustache variables")," that are specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of that tool."),(0,s.kt)("admonition",{title:"Editor's note",type:"info"},(0,s.kt)("p",{parentName:"admonition"},"We could perhaps add references to appropriate sections of relevant tools, so that readers can see examples of this.")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/37bf8d6e.5e041a09.js b/assets/js/37bf8d6e.4faa2b09.js similarity index 99% rename from assets/js/37bf8d6e.5e041a09.js rename to assets/js/37bf8d6e.4faa2b09.js index c0c361bc0..69bcee2f4 100644 --- a/assets/js/37bf8d6e.5e041a09.js +++ b/assets/js/37bf8d6e.4faa2b09.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2904],{3905:(e,t,a)=>{a.d(t,{Zo:()=>c,kt:()=>u});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function o(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=r.createContext({}),d=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},c=function(e){var t=d(e.components);return r.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),m=d(a),u=n,f=m["".concat(l,".").concat(u)]||m[u]||p[u]||o;return a?r.createElement(f,s(s({ref:t},c),{},{components:a})):r.createElement(f,s({ref:t},c))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,s=new Array(o);s[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,s[1]=i;for(var d=2;d{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>p,frontMatter:()=>o,metadata:()=>i,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const o={id:"formatted-text",displayed_sidebar:"tev2SideBar",term:"formatted-text",termType:"concept",isa:"text-format",glossaryTerm:"Formatted Text",glossaryText:"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",grouptags:[],formPhrases:["formatted-text{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Formatted Text",i={unversionedId:"terms/formatted-text",id:"terms/formatted-text",title:"Formatted Text",description:"Formatted Text refers to a document or text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",source:"@site/docs/terms/formatted-text.md",sourceDirName:"terms",slug:"/terms/formatted-text",permalink:"/tev2-specifications/docs/terms/formatted-text",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/formatted-text.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"formatted-text",displayed_sidebar:"tev2SideBar",term:"formatted-text",termType:"concept",isa:"text-format",glossaryTerm:"Formatted Text",glossaryText:"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",grouptags:[],formPhrases:["formatted-text{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},d=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2},{value:"Miscellaneous",id:"miscellaneous",level:2}],c={toc:d};function p(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},c,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"formatted-text"},"Formatted Text"),(0,n.kt)("p",null,(0,n.kt)("strong",{parentName:"p"},"Formatted Text")," refers to a document or text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"An HTML page with headings, bold and italic text, and bullet points is an example of formatted text, that has been generated from e.g., a markdown document."),(0,n.kt)("li",{parentName:"ol"},"A PDF document with a structured layout, different font styles, and properly formatted equations represents formatted text, that may have been generated from a LaTeX document")),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Formatted text enhances the readability and visual appeal of a document, making it more accessible to readers."),(0,n.kt)("li",{parentName:"ul"},"Different formatting options, such as fonts, colors, and alignments, contribute to the overall presentation of the text.")),(0,n.kt)("h2",{id:"miscellaneous"},"Miscellaneous"),(0,n.kt)("p",null,'The term "Formatted Text" encompasses documents or text that have undergone processing to present them with a specific layout and style. This process includes applying formatting elements such as headings, bold and italic text, bullet points, tables, images, and more.'),(0,n.kt)("p",null,'The criterion for identifying "Formatted Text" is whether the document or text has been processed and organized to improve its visual appeal and readability. Formatted texts are typically used in various contexts, including web pages, books, reports, and presentations.'),(0,n.kt)("p",null,'The hover text provides a concise description of the term when users hover over it. Synonyms for this term include "styled-text" and "visually-appealing-text."'),(0,n.kt)("p",null,'The term is classified under the "text-format" concept, which means it belongs to a category related to different text formatting methods. Additionally, it is grouped under "document-format" to indicate its association with processed documents.'),(0,n.kt)("p",null,'The curation status of this term is "proposed," indicating that it is still under review and subject to potential changes.'))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2904],{3905:(e,t,a)=>{a.d(t,{Zo:()=>c,kt:()=>u});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function o(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=r.createContext({}),d=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},c=function(e){var t=d(e.components);return r.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),m=d(a),u=n,f=m["".concat(l,".").concat(u)]||m[u]||p[u]||o;return a?r.createElement(f,s(s({ref:t},c),{},{components:a})):r.createElement(f,s({ref:t},c))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,s=new Array(o);s[0]=m;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,s[1]=i;for(var d=2;d{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>p,frontMatter:()=>o,metadata:()=>i,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const o={id:"formatted-text",displayed_sidebar:"tev2SideBar",term:"formatted-text",termType:"concept",isa:"text-format",glossaryTerm:"Formatted Text",glossaryText:"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",grouptags:[],formPhrases:["formatted-text{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Formatted Text",i={unversionedId:"terms/formatted-text",id:"terms/formatted-text",title:"Formatted Text",description:"Formatted Text refers to a document or text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",source:"@site/docs/terms/formatted-text.md",sourceDirName:"terms",slug:"/terms/formatted-text",permalink:"/tev2-specifications/docs/terms/formatted-text",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/formatted-text.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"formatted-text",displayed_sidebar:"tev2SideBar",term:"formatted-text",termType:"concept",isa:"text-format",glossaryTerm:"Formatted Text",glossaryText:"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.",grouptags:[],formPhrases:["formatted-text{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},d=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2},{value:"Miscellaneous",id:"miscellaneous",level:2}],c={toc:d};function p(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},c,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"formatted-text"},"Formatted Text"),(0,n.kt)("p",null,(0,n.kt)("strong",{parentName:"p"},"Formatted Text")," refers to a document or text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"An HTML page with headings, bold and italic text, and bullet points is an example of formatted text, that has been generated from e.g., a markdown document."),(0,n.kt)("li",{parentName:"ol"},"A PDF document with a structured layout, different font styles, and properly formatted equations represents formatted text, that may have been generated from a LaTeX document")),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Formatted text enhances the readability and visual appeal of a document, making it more accessible to readers."),(0,n.kt)("li",{parentName:"ul"},"Different formatting options, such as fonts, colors, and alignments, contribute to the overall presentation of the text.")),(0,n.kt)("h2",{id:"miscellaneous"},"Miscellaneous"),(0,n.kt)("p",null,'The term "Formatted Text" encompasses documents or text that have undergone processing to present them with a specific layout and style. This process includes applying formatting elements such as headings, bold and italic text, bullet points, tables, images, and more.'),(0,n.kt)("p",null,'The criterion for identifying "Formatted Text" is whether the document or text has been processed and organized to improve its visual appeal and readability. Formatted texts are typically used in various contexts, including web pages, books, reports, and presentations.'),(0,n.kt)("p",null,'The hover text provides a concise description of the term when users hover over it. Synonyms for this term include "styled-text" and "visually-appealing-text."'),(0,n.kt)("p",null,'The term is classified under the "text-format" concept, which means it belongs to a category related to different text formatting methods. Additionally, it is grouped under "document-format" to indicate its association with processed documents.'),(0,n.kt)("p",null,'The curation status of this term is "proposed," indicating that it is still under review and subject to potential changes.'))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/3a41d33b.f248a35d.js b/assets/js/3a41d33b.0adcab32.js similarity index 98% rename from assets/js/3a41d33b.f248a35d.js rename to assets/js/3a41d33b.0adcab32.js index 62872ef86..170f25645 100644 --- a/assets/js/3a41d33b.f248a35d.js +++ b/assets/js/3a41d33b.0adcab32.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4098],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>d});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),p=l(r),d=a,f=p["".concat(c,".").concat(d)]||p[d]||m[d]||o;return r?n.createElement(f,i(i({ref:t},u),{},{components:r})):n.createElement(f,i({ref:t},u))}));function d(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=p;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),o=r(3438),i=r(9960),s=r(3919),c=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(i.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function d(e){let{href:t,icon:r,title:o,description:i}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:o},r," ",o),i&&n.createElement("p",{className:(0,a.Z)("text--truncate",m),title:i},i))}function f(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(d,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(d,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(h,{item:t});case"category":return n.createElement(f,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(g,e);const i=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},i.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},422:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>d,frontMatter:()=>s,metadata:()=>l,toc:()=>m});var n=r(3117),a=(r(7294),r(3905)),o=r(4996),i=r(2991);const s={id:"manuals-author",description:"This section contains the manuals for users in the role of author."},c="Manuals for Authors",l={unversionedId:"categories/manuals-author",id:"categories/manuals-author",title:"Manuals for Authors",description:"This section contains the manuals for users in the role of author.",source:"@site/docs/categories/22-manuals-author.md",sourceDirName:"categories",slug:"/categories/manuals-author",permalink:"/tev2-specifications/docs/categories/manuals-author",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/22-manuals-author.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:22,frontMatter:{id:"manuals-author",description:"This section contains the manuals for users in the role of author."},sidebar:"tev2SideBar",previous:{title:"Manuals",permalink:"/tev2-specifications/docs/categories/manuals"},next:{title:"Author Overview",permalink:"/tev2-specifications/docs/manuals/author/author-overview"}},u={},m=[],p={toc:m};function d(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"manuals-for-authors"},"Manuals for Authors"),(0,a.kt)("img",{alt:"This entire section is still under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,a.kt)("br",null),(0,a.kt)("br",null),(0,a.kt)("p",null,"This section contains manuals for users in their role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,a.kt)(i.Z,{folder:"/docs/manuals/author",mdxType:"DocCardList"}))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4098],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>d});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),p=l(r),d=a,f=p["".concat(c,".").concat(d)]||p[d]||m[d]||o;return r?n.createElement(f,i(i({ref:t},u),{},{components:r})):n.createElement(f,i({ref:t},u))}));function d(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=p;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),o=r(3438),i=r(9960),s=r(3919),c=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(i.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function d(e){let{href:t,icon:r,title:o,description:i}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:o},r," ",o),i&&n.createElement("p",{className:(0,a.Z)("text--truncate",m),title:i},i))}function f(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(d,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function h(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(d,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(h,{item:t});case"category":return n.createElement(f,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(g,e);const i=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},i.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},422:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>d,frontMatter:()=>s,metadata:()=>l,toc:()=>m});var n=r(3117),a=(r(7294),r(3905)),o=r(4996),i=r(2991);const s={id:"manuals-author",description:"This section contains the manuals for users in the role of author."},c="Manuals for Authors",l={unversionedId:"categories/manuals-author",id:"categories/manuals-author",title:"Manuals for Authors",description:"This section contains the manuals for users in the role of author.",source:"@site/docs/categories/22-manuals-author.md",sourceDirName:"categories",slug:"/categories/manuals-author",permalink:"/tev2-specifications/docs/categories/manuals-author",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/22-manuals-author.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:22,frontMatter:{id:"manuals-author",description:"This section contains the manuals for users in the role of author."},sidebar:"tev2SideBar",previous:{title:"Manuals",permalink:"/tev2-specifications/docs/categories/manuals"},next:{title:"Author Overview",permalink:"/tev2-specifications/docs/manuals/author/author-overview"}},u={},m=[],p={toc:m};function d(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"manuals-for-authors"},"Manuals for Authors"),(0,a.kt)("img",{alt:"This entire section is still under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,a.kt)("br",null),(0,a.kt)("br",null),(0,a.kt)("p",null,"This section contains manuals for users in their role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,a.kt)(i.Z,{folder:"/docs/manuals/author",mdxType:"DocCardList"}))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/3c160063.ede6db0e.js b/assets/js/3c160063.577d1f8f.js similarity index 99% rename from assets/js/3c160063.ede6db0e.js rename to assets/js/3c160063.577d1f8f.js index 1a7f086c5..1bb06a967 100644 --- a/assets/js/3c160063.ede6db0e.js +++ b/assets/js/3c160063.577d1f8f.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1441],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>p});var n=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=n.createContext({}),h=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},l=function(e){var t=h(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),m=h(i),p=a,f=m["".concat(c,".").concat(p)]||m[p]||d[p]||o;return i?n.createElement(f,s(s({ref:t},l),{},{components:i})):n.createElement(f,s({ref:t},l))}));function p(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,s=new Array(o);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>r,default:()=>m,frontMatter:()=>s,metadata:()=>c,toc:()=>l});var n=i(3117),a=(i(7294),i(3905)),o=i(4996);const s={id:"definition",displayed_sidebar:"tev2SideBar",term:"definition",termType:"pattern",glossaryTerm:"Definition Pattern",glossaryText:"a [mental model](@) that describes the relations between a [concept](@) (or any other [semantic unit](@)), the [term(s)](@) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that [semantic unit](@).",grouptags:[],formPhrases:["definition{ss}-pattern{ss}"],status:"proposed",created:20240316,updated:20240316,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Definition Pattern",c={unversionedId:"terms/patterns/definition",id:"terms/patterns/definition",title:"Definition Pattern",description:"This mental model describes the relations between a concept (or any other semantic unit), the term(s) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that semantic unit.",source:"@site/docs/terms/patterns/pattern-definition.md",sourceDirName:"terms/patterns",slug:"/terms/patterns/definition",permalink:"/tev2-specifications/docs/terms/patterns/definition",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/patterns/pattern-definition.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"definition",displayed_sidebar:"tev2SideBar",term:"definition",termType:"pattern",glossaryTerm:"Definition Pattern",glossaryText:"a [mental model](@) that describes the relations between a [concept](@) (or any other [semantic unit](@)), the [term(s)](@) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that [semantic unit](@).",grouptags:[],formPhrases:["definition{ss}-pattern{ss}"],status:"proposed",created:20240316,updated:20240316,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},h={},l=[{value:"Purpose",id:"purpose",level:2},{value:"Introduction",id:"introduction",level:2},{value:"Formalized model",id:"formalized-model",level:2}],d={toc:l};function m(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,n.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"definition-pattern"},"Definition Pattern"),(0,a.kt)("p",null,"This ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," describes the relations between a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,a.kt)("h2",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"The purpose of this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," is to provide a solid basis for "),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"mechanisms that enable people to understand others;"),(0,a.kt)("li",{parentName:"ul"},"authoring texts that use ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," whose ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," have a high likelihood of being understandable by the intended audience of the text;"),(0,a.kt)("li",{parentName:"ul"},"developing ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that can be used within a group of people.")),(0,a.kt)("h2",{id:"introduction"},"Introduction"),(0,a.kt)("p",null,'Cognitive science has it that people have their individual ideas, concepts, etc. for making sense of the world around them. These things, that are called "',(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),"\" in cognitive science, are intangible. They are part of one's mind, and cannot readily be communicated to others."),(0,a.kt)("p",null,"People have created representations of such ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are tangible, and therefor can be used in communications. ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Word"},"Words")," or ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Phrase"},"phrases")," are one example, but people also came to use ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Symbol"},"symbols"),", ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Sign_(semiotics)"},"signs"),", sounds etc."),(0,a.kt)("p",null,"The problem here is that there typically is no guarantee that people use such representations to refer to the same ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),". The result is that words or phrases may be ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Ambiguity"},"ambiguous"),", or ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Conflation"},"conflated"),"."),(0,a.kt)("p",null,"Fortunately, all of us have learned 'the meaning' of a large number of words and phrases, that is: what they mean in the social, cultural, national context in which we have grown up. They are the basic words of our ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/First_language"},"mother tongue"),". The context in which we grew up ensured that the people therein understand these basic words in the same way, that is: for all practical purposes."),(0,a.kt)("p",null,"This is the basis on top of which we can introduce new terms, and describe ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts")," that are new, or that are particular specializations of other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),". Such descriptions should enable others that are to understand these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),". Ideally, they are criteria that enable others to determine what is, and what is not, an instance (or: example) of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),". "),(0,a.kt)("p",null,"Such criteria can be tested for validity:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},"Devise an arbitrary use-cases in which people can apply the criteria to something."),(0,a.kt)("li",{parentName:"ol"},"Have all participants determine whether or not this something complies with the criteria."),(0,a.kt)("li",{parentName:"ol"},"If there are participants that have a different judgment, they have a different understanding. To fix this may require adjustment of the criteria"),(0,a.kt)("li",{parentName:"ol"},"The more use-cases are devised in which people have the same judgments, the greater the likelihood that they have the same understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept")," that is being described.")),(0,a.kt)("h2",{id:"formalized-model"},"Formalized model"),(0,a.kt)("p",null,"Here is a visual representation of this pattern, using the following ",(0,a.kt)("strong",{parentName:"p"},(0,a.kt)("a",{parentName:"strong",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions")),":"),(0,a.kt)("img",{alt:"Conceptual model of the 'definition' pattern",src:(0,o.Z)("images/tev2-definition.png")}),(0,a.kt)("p",null,"The figure shows ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", using a cloud-like symbol to illustrate that this is something intangible. It also shows that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," is part of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", which typically contains several (i.e., a lot) of them."),(0,a.kt)("p",null,"Within the context of its ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", every ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),":"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"can have at most one determinant, i.e., a criterion (a description) that can be used to determine whether or not something is an instance (or: example) of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic-unit"),"."),(0,a.kt)("li",{parentName:"ul"},"can be represented by any number of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"words or phrases (terms)"),", which are synonyms (or aliases) of each other."),(0,a.kt)("li",{parentName:"ul"},"can have at most one ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", which is the composition of all ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used to refer to the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the (single) criterion that is its determinant.")),(0,a.kt)("p",null,"Thus, a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," only exists for a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," if the determinant exists, and there is at least one ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used within that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to it."))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1441],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>p});var n=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=n.createContext({}),h=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},l=function(e){var t=h(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),m=h(i),p=a,f=m["".concat(c,".").concat(p)]||m[p]||d[p]||o;return i?n.createElement(f,s(s({ref:t},l),{},{components:i})):n.createElement(f,s({ref:t},l))}));function p(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,s=new Array(o);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var h=2;h{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>r,default:()=>m,frontMatter:()=>s,metadata:()=>c,toc:()=>l});var n=i(3117),a=(i(7294),i(3905)),o=i(4996);const s={id:"definition",displayed_sidebar:"tev2SideBar",term:"definition",termType:"pattern",glossaryTerm:"Definition Pattern",glossaryText:"a [mental model](@) that describes the relations between a [concept](@) (or any other [semantic unit](@)), the [term(s)](@) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that [semantic unit](@).",grouptags:[],formPhrases:["definition{ss}-pattern{ss}"],status:"proposed",created:20240316,updated:20240316,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Definition Pattern",c={unversionedId:"terms/patterns/definition",id:"terms/patterns/definition",title:"Definition Pattern",description:"This mental model describes the relations between a concept (or any other semantic unit), the term(s) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that semantic unit.",source:"@site/docs/terms/patterns/pattern-definition.md",sourceDirName:"terms/patterns",slug:"/terms/patterns/definition",permalink:"/tev2-specifications/docs/terms/patterns/definition",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/patterns/pattern-definition.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"definition",displayed_sidebar:"tev2SideBar",term:"definition",termType:"pattern",glossaryTerm:"Definition Pattern",glossaryText:"a [mental model](@) that describes the relations between a [concept](@) (or any other [semantic unit](@)), the [term(s)](@) that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that [semantic unit](@).",grouptags:[],formPhrases:["definition{ss}-pattern{ss}"],status:"proposed",created:20240316,updated:20240316,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},h={},l=[{value:"Purpose",id:"purpose",level:2},{value:"Introduction",id:"introduction",level:2},{value:"Formalized model",id:"formalized-model",level:2}],d={toc:l};function m(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,n.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"definition-pattern"},"Definition Pattern"),(0,a.kt)("p",null,"This ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," describes the relations between a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,a.kt)("h2",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"The purpose of this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," is to provide a solid basis for "),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"mechanisms that enable people to understand others;"),(0,a.kt)("li",{parentName:"ul"},"authoring texts that use ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," whose ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," have a high likelihood of being understandable by the intended audience of the text;"),(0,a.kt)("li",{parentName:"ul"},"developing ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that can be used within a group of people.")),(0,a.kt)("h2",{id:"introduction"},"Introduction"),(0,a.kt)("p",null,'Cognitive science has it that people have their individual ideas, concepts, etc. for making sense of the world around them. These things, that are called "',(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),"\" in cognitive science, are intangible. They are part of one's mind, and cannot readily be communicated to others."),(0,a.kt)("p",null,"People have created representations of such ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that are tangible, and therefor can be used in communications. ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Word"},"Words")," or ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Phrase"},"phrases")," are one example, but people also came to use ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Symbol"},"symbols"),", ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Sign_(semiotics)"},"signs"),", sounds etc."),(0,a.kt)("p",null,"The problem here is that there typically is no guarantee that people use such representations to refer to the same ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),". The result is that words or phrases may be ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Ambiguity"},"ambiguous"),", or ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Conflation"},"conflated"),"."),(0,a.kt)("p",null,"Fortunately, all of us have learned 'the meaning' of a large number of words and phrases, that is: what they mean in the social, cultural, national context in which we have grown up. They are the basic words of our ",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/First_language"},"mother tongue"),". The context in which we grew up ensured that the people therein understand these basic words in the same way, that is: for all practical purposes."),(0,a.kt)("p",null,"This is the basis on top of which we can introduce new terms, and describe ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts")," that are new, or that are particular specializations of other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),". Such descriptions should enable others that are to understand these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),". Ideally, they are criteria that enable others to determine what is, and what is not, an instance (or: example) of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),". "),(0,a.kt)("p",null,"Such criteria can be tested for validity:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},"Devise an arbitrary use-cases in which people can apply the criteria to something."),(0,a.kt)("li",{parentName:"ol"},"Have all participants determine whether or not this something complies with the criteria."),(0,a.kt)("li",{parentName:"ol"},"If there are participants that have a different judgment, they have a different understanding. To fix this may require adjustment of the criteria"),(0,a.kt)("li",{parentName:"ol"},"The more use-cases are devised in which people have the same judgments, the greater the likelihood that they have the same understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept")," that is being described.")),(0,a.kt)("h2",{id:"formalized-model"},"Formalized model"),(0,a.kt)("p",null,"Here is a visual representation of this pattern, using the following ",(0,a.kt)("strong",{parentName:"p"},(0,a.kt)("a",{parentName:"strong",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions")),":"),(0,a.kt)("img",{alt:"Conceptual model of the 'definition' pattern",src:(0,o.Z)("images/tev2-definition.png")}),(0,a.kt)("p",null,"The figure shows ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", using a cloud-like symbol to illustrate that this is something intangible. It also shows that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," is part of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", which typically contains several (i.e., a lot) of them."),(0,a.kt)("p",null,"Within the context of its ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", every ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),":"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"can have at most one determinant, i.e., a criterion (a description) that can be used to determine whether or not something is an instance (or: example) of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic-unit"),"."),(0,a.kt)("li",{parentName:"ul"},"can be represented by any number of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"words or phrases (terms)"),", which are synonyms (or aliases) of each other."),(0,a.kt)("li",{parentName:"ul"},"can have at most one ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", which is the composition of all ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used to refer to the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the (single) criterion that is its determinant.")),(0,a.kt)("p",null,"Thus, a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," only exists for a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," if the determinant exists, and there is at least one ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used within that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to it."))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/41daa8b4.355738cc.js b/assets/js/41daa8b4.89a887d6.js similarity index 98% rename from assets/js/41daa8b4.355738cc.js rename to assets/js/41daa8b4.89a887d6.js index b1fec8833..3923a658e 100644 --- a/assets/js/41daa8b4.355738cc.js +++ b/assets/js/41daa8b4.89a887d6.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1576],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>m});var a=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},d=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var r=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=l(r),m=o,f=u["".concat(c,".").concat(m)]||u[m]||p[m]||n;return r?a.createElement(f,s(s({ref:t},d),{},{components:r})):a.createElement(f,s({ref:t},d))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=r.length,s=new Array(n);s[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:o,s[1]=i;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>n,metadata:()=>i,toc:()=>l});var a=r(3117),o=(r(7294),r(3905));const n={id:"hrdt",displayed_sidebar:"tev2SideBar",term:"hrdt",termType:"concept",isa:null,glossaryTerm:"Human Readable Dictionary Tool",glossaryAbbr:"HRDT",glossaryText:"a software tool designed to create, manage, and process [Human Readable Dictionaries (HRDs)](hrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["human-readable-dictionary-tool{ss}","hrd-tool{ss}","hrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="HRDT - Human Readable Dictionary Tool",i={unversionedId:"terms/hrdt",id:"terms/hrdt",title:"HRDT - Human Readable Dictionary Tool",description:"HRDT stands for Human Readable Dictionary Tool. It refers to a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs).",source:"@site/docs/terms/hrdt.md",sourceDirName:"terms",slug:"/terms/hrdt",permalink:"/tev2-specifications/docs/terms/hrdt",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrdt.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrdt",displayed_sidebar:"tev2SideBar",term:"hrdt",termType:"concept",isa:null,glossaryTerm:"Human Readable Dictionary Tool",glossaryAbbr:"HRDT",glossaryText:"a software tool designed to create, manage, and process [Human Readable Dictionaries (HRDs)](hrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["human-readable-dictionary-tool{ss}","hrd-tool{ss}","hrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,a.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"hrdt---human-readable-dictionary-tool"},"HRDT - Human Readable Dictionary Tool"),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"HRDT")," stands for ",(0,o.kt)("strong",{parentName:"p"},"Human Readable Dictionary Tool"),". It refers to a software tool designed to create, manage, and process ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," specifications (will) have a ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/tools-envisaged/hrdt"},"HRDT specification")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1576],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>m});var a=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},d=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var r=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=i(e,["components","mdxType","originalType","parentName"]),u=l(r),m=o,f=u["".concat(c,".").concat(m)]||u[m]||p[m]||n;return r?a.createElement(f,s(s({ref:t},d),{},{components:r})):a.createElement(f,s({ref:t},d))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=r.length,s=new Array(n);s[0]=u;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i.mdxType="string"==typeof e?e:o,s[1]=i;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>n,metadata:()=>i,toc:()=>l});var a=r(3117),o=(r(7294),r(3905));const n={id:"hrdt",displayed_sidebar:"tev2SideBar",term:"hrdt",termType:"concept",isa:null,glossaryTerm:"Human Readable Dictionary Tool",glossaryAbbr:"HRDT",glossaryText:"a software tool designed to create, manage, and process [Human Readable Dictionaries (HRDs)](hrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["human-readable-dictionary-tool{ss}","hrd-tool{ss}","hrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="HRDT - Human Readable Dictionary Tool",i={unversionedId:"terms/hrdt",id:"terms/hrdt",title:"HRDT - Human Readable Dictionary Tool",description:"HRDT stands for Human Readable Dictionary Tool. It refers to a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs).",source:"@site/docs/terms/hrdt.md",sourceDirName:"terms",slug:"/terms/hrdt",permalink:"/tev2-specifications/docs/terms/hrdt",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrdt.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrdt",displayed_sidebar:"tev2SideBar",term:"hrdt",termType:"concept",isa:null,glossaryTerm:"Human Readable Dictionary Tool",glossaryAbbr:"HRDT",glossaryText:"a software tool designed to create, manage, and process [Human Readable Dictionaries (HRDs)](hrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["human-readable-dictionary-tool{ss}","hrd-tool{ss}","hrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,a.Z)({},d,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"hrdt---human-readable-dictionary-tool"},"HRDT - Human Readable Dictionary Tool"),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"HRDT")," stands for ",(0,o.kt)("strong",{parentName:"p"},"Human Readable Dictionary Tool"),". It refers to a software tool designed to create, manage, and process ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," specifications (will) have a ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/tools-envisaged/hrdt"},"HRDT specification")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/43f125f7.2ad2e8d6.js b/assets/js/43f125f7.aa73321a.js similarity index 99% rename from assets/js/43f125f7.2ad2e8d6.js rename to assets/js/43f125f7.aa73321a.js index 82b8066bb..47f05a794 100644 --- a/assets/js/43f125f7.2ad2e8d6.js +++ b/assets/js/43f125f7.aa73321a.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7983],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=i.createContext({}),l=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=l(a),p=n,f=h["".concat(c,".").concat(p)]||h[p]||m[p]||r;return a?i.createElement(f,o(o({ref:t},d),{},{components:a})):i.createElement(f,o({ref:t},d))}));function p(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var l=2;l{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),c=a(1980),l=a(7392),d=a(12);function m(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??m(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function p(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function f(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!p({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[c,l]=f({queryString:a,groupId:i}),[m,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),k=(()=>{const e=c??m;return p({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{k&&s(k)}),[k]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!p({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),l(e),u(e)}),[l,u,r]),tabValues:r}}var k=a(2389);const y="tabList__CuJ",g="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:s,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:m}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=l[a].value;i!==s&&(m(t),c(i))},p=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:p,onClick:h},o,{className:(0,r.Z)("tabs__item",g,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function b(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function N(e){const t=u(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(v,(0,i.Z)({},e,t)),n.createElement(b,(0,i.Z)({},e,t)))}function T(e){const t=(0,k.Z)();return n.createElement(N,(0,i.Z)({key:String(t)},e))}},1531:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var i=a(3117),n=(a(7294),a(3905));a(4996),a(4866),a(5162);const r={id:"term-selection",sidebar_label:"Term Selection",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},o="Term Selection - Syntax",s={unversionedId:"specs/syntax/term-selection",id:"specs/syntax/term-selection",title:"Term Selection - Syntax",description:"A term selection instruction is a specification for the MRGT to modify the provisional MRG that it is working with should be modified. This documents specifies the syntax for the various instructions.",source:"@site/docs/specs/syntax/62-term-selection.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/term-selection",permalink:"/tev2-specifications/docs/specs/syntax/term-selection",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/62-term-selection.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:62,frontMatter:{id:"term-selection",sidebar_label:"Term Selection",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},sidebar:"tev2SideBar",previous:{title:"MRG References (MRGRefs)",permalink:"/tev2-specifications/docs/specs/syntax/mrg-refs"},next:{title:"Handlebars Helpers",permalink:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"}},c={},l=[{value:"Selecting Terms to be Removed from the Provisional MRG",id:"remove-terms",level:2},{value:"Renaming/rewriting term fields",id:"rename-terms",level:2}],d={toc:l};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"term-selection---syntax"},"Term Selection - Syntax"),(0,n.kt)("p",null,"A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instruction")," is a specification for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," to modify the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that it is working with should be modified. This documents specifies the syntax for the various instructions."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Example of a `termselection` field in a SAF"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"Term selection instructions")," go in the `termselection` fields of in the [versions section](/docs/specs/files/saf#versions) of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". This `termselection` field is an array of YAML texts. Here is an example:",(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-yaml"},' termselection:\n - "[party,actor,action,onboarding,organization]@essif-lab"\n - "rename action [id:act, term:act, formPhrases:\'act{ss}\']"\n - "term[action]@essif-lab"\n')),(0,n.kt)("admonition",{title:"Every instruction must be surrounded by quotes",type:"warning"},(0,n.kt)("p",{parentName:"admonition"},"This is to ensure YAML interpreters can actually read it.",(0,n.kt)("br",null),"\nTake care to properly nest quotes (as in the 'rename' instruction of the example)."))),(0,n.kt)("h1",{id:"adding-terms"},"Selecting Terms to be Added to the Provisional MRG"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formphrase")," (for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),").")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"the name of a field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", whichever the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," uses as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a text value."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"*"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", and add it to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"[ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from ",(0,n.kt)("em",{parentName:"td"},"every")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'" [ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that has a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," with a field named ",(0,n.kt)("inlineCode",{parentName:"td"},""),", and whose value matches any of the specified values ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".",(0,n.kt)("sup",{parentName:"td",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))))),(0,n.kt)("admonition",{title:"Adding terms from other scopes",type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"By adding ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," to any of the above instructions, you specify that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that are to be selected must originate from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,n.kt)("inlineCode",{parentName:"p"},"")," identifies."),(0,n.kt)("p",{parentName:"admonition"},"The instruction ",(0,n.kt)("inlineCode",{parentName:"p"},'"[ party, actor ]@essif-lab"')," will copy all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the (default version) of the ","[MRG]"," as it exists in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab"),". Of course, ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab")," must be defined as a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," in one of the entries of the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scopes"},"scopes section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples for adding terms"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"',"[actor,party]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"term ',"[actor]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"status',"[proposed,approved]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"somefield []"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has no value specified.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"',"[actor,party]",'@tev2:v1"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"@tev2:v1"),", that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"term ',"[actor,party]",'@tev2:v1"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"@tev2:v1"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"grouptags',"[x,y,z]",'@essif-lab"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"essif-lab"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field contains one or more of the values ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),"."))))),(0,n.kt)("h2",{id:"remove-terms"},"Selecting Terms to be Removed from the Provisional MRG"),(0,n.kt)("p",null,"The syntax for removing terms is similar to one that is used for adding terms, but it is preceded with a ",(0,n.kt)("inlineCode",{parentName:"p"},"-"),"character, as follows:"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formphrase")," (for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),").")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"the name of a field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", whichever the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," uses as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a text value."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"-[ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Remove every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"- [ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Remove every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that has a field named ",(0,n.kt)("inlineCode",{parentName:"td"},""),", and whose value matches any of the specified values ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".",(0,n.kt)("sup",{parentName:"td",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples for removing terms:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-',"[actor,party]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"match")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-term ',"[actor]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-status',"[proposed,approved]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-grouptags',"[x,y,z]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field of which one of the listed ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-somefield []"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field that has no value specified."))))),(0,n.kt)("h2",{id:"rename-terms"},"Renaming/rewriting term fields"),(0,n.kt)("p",null,"In analogy with ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),", we accommodate for the renaming of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (better: modifying fields in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),") as they are 'imported' from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," other than the one that we are constructing. However, the analogy breaks down in the sense that it is not only the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that should be renamable (which is sufficient for ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),"), but also certain attributes may need to be changed, e.g. the ",(0,n.kt)("inlineCode",{parentName:"p"},"formPhrases"),"."),(0,n.kt)("p",null,"The following syntaxes are available for renaming fields in a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," that is part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that is selected for the renaming process, which may optionally be preceded with ",(0,n.kt)("inlineCode",{parentName:"td"},":")," (where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," would then be the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"termType")," field in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"). Note that this value is an identifier for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},">")),(0,n.kt)("td",{parentName:"tr",align:null},"a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"td"},"formPhrases"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"glossaryText"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"status"),", etc.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},">")),(0,n.kt)("td",{parentName:"tr",align:null},"a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"td"},">"),". If the text contains multiple words, it should be surrounded with quotes."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"rename [ :, :, ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"In the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", the values of the fields ",(0,n.kt)("inlineCode",{parentName:"td"},"k")," are replaced by their corresponding values ",(0,n.kt)("inlineCode",{parentName:"td"},"v")," (also if ",(0,n.kt)("inlineCode",{parentName:"td"},"v")," is the empty string)")))),(0,n.kt)("p",null,"Here is how it works. First, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG Entry")," is searched that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"p"},""),". If found, all ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pairs are processed in the sequence they are specified. Processing a ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pair consists of looking for a field named ",(0,n.kt)("inlineCode",{parentName:"p"},"")," in the selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". We now have the following situations:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then the contents of the field is overwritten by ",(0,n.kt)("inlineCode",{parentName:"li"},""),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then the contents of the field is deleted;"))),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does not exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then a new field named ",(0,n.kt)("inlineCode",{parentName:"li"},"")," with the specified ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then nothing is done.")))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Renaming examples"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},"\"rename party [ status:accepted, glossaryText:'A natural person or a legal person' ]\"")),":"),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"accepted"),", and "),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural person or a legal person"'),"."))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},'"',(0,n.kt)("inlineCode",{parentName:"strong"},"rename party [ term:partij, formPhrases:'partij{en}', glossaryText:'Een natuurlijk persoon of een rechtspersoon' ]\""))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"partij"),";"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"approved"),"."),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural or legal person"')))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'"rename party [ glossaryText: ]"'))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"removes the contents from the ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field if such a field exists.",(0,n.kt)("br",null)))))),(0,n.kt)("div",{className:"footnotes"},(0,n.kt)("hr",{parentName:"div"}),(0,n.kt)("ol",{parentName:"div"},(0,n.kt)("li",{parentName:"ol",id:"fn-1"},"'matching' means that ","[",(0,n.kt)("mark",null,"TBD: specify the matching algorithm, in particular when the field itself is an arry, such as ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"headingids"),", etc."),"]",(0,n.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7983],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>p});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=i.createContext({}),l=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=l(a),p=n,f=h["".concat(c,".").concat(p)]||h[p]||m[p]||r;return a?i.createElement(f,o(o({ref:t},d),{},{components:a})):i.createElement(f,o({ref:t},d))}));function p(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var l=2;l{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),c=a(1980),l=a(7392),d=a(12);function m(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??m(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function p(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function f(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!p({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[c,l]=f({queryString:a,groupId:i}),[m,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),k=(()=>{const e=c??m;return p({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{k&&s(k)}),[k]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!p({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),l(e),u(e)}),[l,u,r]),tabValues:r}}var k=a(2389);const y="tabList__CuJ",g="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:s,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:m}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=l[a].value;i!==s&&(m(t),c(i))},p=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:p,onClick:h},o,{className:(0,r.Z)("tabs__item",g,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function b(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function N(e){const t=u(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(v,(0,i.Z)({},e,t)),n.createElement(b,(0,i.Z)({},e,t)))}function T(e){const t=(0,k.Z)();return n.createElement(N,(0,i.Z)({key:String(t)},e))}},1531:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var i=a(3117),n=(a(7294),a(3905));a(4996),a(4866),a(5162);const r={id:"term-selection",sidebar_label:"Term Selection",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},o="Term Selection - Syntax",s={unversionedId:"specs/syntax/term-selection",id:"specs/syntax/term-selection",title:"Term Selection - Syntax",description:"A term selection instruction is a specification for the MRGT to modify the provisional MRG that it is working with should be modified. This documents specifies the syntax for the various instructions.",source:"@site/docs/specs/syntax/62-term-selection.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/term-selection",permalink:"/tev2-specifications/docs/specs/syntax/term-selection",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/62-term-selection.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:62,frontMatter:{id:"term-selection",sidebar_label:"Term Selection",toc_min_heading_level:2,toc_max_heading_level:2,date:20240129},sidebar:"tev2SideBar",previous:{title:"MRG References (MRGRefs)",permalink:"/tev2-specifications/docs/specs/syntax/mrg-refs"},next:{title:"Handlebars Helpers",permalink:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"}},c={},l=[{value:"Selecting Terms to be Removed from the Provisional MRG",id:"remove-terms",level:2},{value:"Renaming/rewriting term fields",id:"rename-terms",level:2}],d={toc:l};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"term-selection---syntax"},"Term Selection - Syntax"),(0,n.kt)("p",null,"A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instruction")," is a specification for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," to modify the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that it is working with should be modified. This documents specifies the syntax for the various instructions."),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Example of a `termselection` field in a SAF"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"Term selection instructions")," go in the `termselection` fields of in the [versions section](/docs/specs/files/saf#versions) of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". This `termselection` field is an array of YAML texts. Here is an example:",(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-yaml"},' termselection:\n - "[party,actor,action,onboarding,organization]@essif-lab"\n - "rename action [id:act, term:act, formPhrases:\'act{ss}\']"\n - "term[action]@essif-lab"\n')),(0,n.kt)("admonition",{title:"Every instruction must be surrounded by quotes",type:"warning"},(0,n.kt)("p",{parentName:"admonition"},"This is to ensure YAML interpreters can actually read it.",(0,n.kt)("br",null),"\nTake care to properly nest quotes (as in the 'rename' instruction of the example)."))),(0,n.kt)("h1",{id:"adding-terms"},"Selecting Terms to be Added to the Provisional MRG"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formphrase")," (for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),").")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"the name of a field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", whichever the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," uses as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a text value."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"*"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", and add it to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"[ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from ",(0,n.kt)("em",{parentName:"td"},"every")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'" [ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Create an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that has a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," with a field named ",(0,n.kt)("inlineCode",{parentName:"td"},""),", and whose value matches any of the specified values ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".",(0,n.kt)("sup",{parentName:"td",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))))),(0,n.kt)("admonition",{title:"Adding terms from other scopes",type:"tip"},(0,n.kt)("p",{parentName:"admonition"},"By adding ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," to any of the above instructions, you specify that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that are to be selected must originate from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,n.kt)("inlineCode",{parentName:"p"},"")," identifies."),(0,n.kt)("p",{parentName:"admonition"},"The instruction ",(0,n.kt)("inlineCode",{parentName:"p"},'"[ party, actor ]@essif-lab"')," will copy all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," from the (default version) of the ","[MRG]"," as it exists in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab"),". Of course, ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab")," must be defined as a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," in one of the entries of the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scopes"},"scopes section")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples for adding terms"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"',"[actor,party]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"term ',"[actor]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"status',"[proposed,approved]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"somefield []"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field in its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," has no value specified.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"',"[actor,party]",'@tev2:v1"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"@tev2:v1"),", that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"term ',"[actor,party]",'@tev2:v1"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"@tev2:v1"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field has the value ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"grouptags',"[x,y,z]",'@essif-lab"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"select every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," ",(0,n.kt)("inlineCode",{parentName:"td"},"essif-lab"),", of which the ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field contains one or more of the values ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),"."))))),(0,n.kt)("h2",{id:"remove-terms"},"Selecting Terms to be Removed from the Provisional MRG"),(0,n.kt)("p",null,"The syntax for removing terms is similar to one that is used for adding terms, but it is preceded with a ",(0,n.kt)("inlineCode",{parentName:"p"},"-"),"character, as follows:"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"formphrase")," (for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),").")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"the name of a field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", whichever the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," uses as its source.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},""),", ",(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"a text value."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"-[ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Remove every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"matches")," any of the ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"- [ , , ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"Remove every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that has a field named ",(0,n.kt)("inlineCode",{parentName:"td"},""),", and whose value matches any of the specified values ",(0,n.kt)("inlineCode",{parentName:"td"},">"),".",(0,n.kt)("sup",{parentName:"td",id:"fnref-1"},(0,n.kt)("a",{parentName:"sup",href:"#fn-1",className:"footnote-ref"},"1")))))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Examples for removing terms:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Syntax:"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Meaning:"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-',"[actor,party]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase#matching",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"match")," any of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," ",(0,n.kt)("inlineCode",{parentName:"td"},"actor")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"party"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-term ',"[actor]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"actor"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-status',"[proposed,approved]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"status")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"td"},"proposed")," or ",(0,n.kt)("inlineCode",{parentName:"td"},"approved"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-grouptags',"[x,y,z]",'"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags")," field of which one of the listed ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/grouptag",title:"Grouptag: a Tag that is used to group Terms within a specific Scope."},"grouptags")," is ",(0,n.kt)("inlineCode",{parentName:"td"},"x"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"y"),", or ",(0,n.kt)("inlineCode",{parentName:"td"},"z"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},'"-somefield []"'),(0,n.kt)("td",{parentName:"tr",align:"left"},"remove all entries that have a ",(0,n.kt)("inlineCode",{parentName:"td"},"somefield")," field that has no value specified."))))),(0,n.kt)("h2",{id:"rename-terms"},"Renaming/rewriting term fields"),(0,n.kt)("p",null,"In analogy with ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),", we accommodate for the renaming of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (better: modifying fields in ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),") as they are 'imported' from ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," other than the one that we are constructing. However, the analogy breaks down in the sense that it is not only the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that should be renamable (which is sufficient for ",(0,n.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Namespace"},"namespaces"),"), but also certain attributes may need to be changed, e.g. the ",(0,n.kt)("inlineCode",{parentName:"p"},"formPhrases"),"."),(0,n.kt)("p",null,"The following syntaxes are available for renaming fields in a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," that is part of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),":"),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Legend of abbreviations used"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},"")),(0,n.kt)("td",{parentName:"tr",align:null},"is the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"term")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," that is selected for the renaming process, which may optionally be preceded with ",(0,n.kt)("inlineCode",{parentName:"td"},":")," (where ",(0,n.kt)("inlineCode",{parentName:"td"},"")," would then be the value of the ",(0,n.kt)("inlineCode",{parentName:"td"},"termType")," field in that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"). Note that this value is an identifier for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},">")),(0,n.kt)("td",{parentName:"tr",align:null},"a text that corresponds with a field name in an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", such as ",(0,n.kt)("inlineCode",{parentName:"td"},"formPhrases"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"glossaryText"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"td"},"status"),", etc.")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},">")),(0,n.kt)("td",{parentName:"tr",align:null},"a text that will replace the existing text of the field identified by ",(0,n.kt)("inlineCode",{parentName:"td"},">"),". If the text contains multiple words, it should be surrounded with quotes."))))),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:null},"Instruction"),(0,n.kt)("th",{parentName:"tr",align:null},"Description"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:null},(0,n.kt)("inlineCode",{parentName:"td"},'"rename [ :, :, ... ]"')),(0,n.kt)("td",{parentName:"tr",align:null},"In the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is identified by ",(0,n.kt)("inlineCode",{parentName:"td"},"")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG"),", the values of the fields ",(0,n.kt)("inlineCode",{parentName:"td"},"k")," are replaced by their corresponding values ",(0,n.kt)("inlineCode",{parentName:"td"},"v")," (also if ",(0,n.kt)("inlineCode",{parentName:"td"},"v")," is the empty string)")))),(0,n.kt)("p",null,"Here is how it works. First, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG Entry")," is searched that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," field whose value is ",(0,n.kt)("inlineCode",{parentName:"p"},""),". If found, all ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pairs are processed in the sequence they are specified. Processing a ",(0,n.kt)("inlineCode",{parentName:"p"},""),":",(0,n.kt)("inlineCode",{parentName:"p"},"")," pair consists of looking for a field named ",(0,n.kt)("inlineCode",{parentName:"p"},"")," in the selected ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". We now have the following situations:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then the contents of the field is overwritten by ",(0,n.kt)("inlineCode",{parentName:"li"},""),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then the contents of the field is deleted;"))),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," field does not exists, and",(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is not empty, then a new field named ",(0,n.kt)("inlineCode",{parentName:"li"},"")," with the specified ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is added to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),";"),(0,n.kt)("li",{parentName:"ul"},"if the ",(0,n.kt)("inlineCode",{parentName:"li"},"")," is empty, then nothing is done.")))),(0,n.kt)("details",null,(0,n.kt)("summary",null,"Renaming examples"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},"\"rename party [ status:accepted, glossaryText:'A natural person or a legal person' ]\"")),":"),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"accepted"),", and "),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural person or a legal person"'),"."))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},'"',(0,n.kt)("inlineCode",{parentName:"strong"},"rename party [ term:partij, formPhrases:'partij{en}', glossaryText:'Een natuurlijk persoon of een rechtspersoon' ]\""))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"partij"),";"),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"status")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},"approved"),"."),(0,n.kt)("li",{parentName:"ul"},"changes (or creates) its ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field to so that it contains ",(0,n.kt)("inlineCode",{parentName:"li"},'"A natural or legal person"')))),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("p",{parentName:"li"},(0,n.kt)("strong",{parentName:"p"},(0,n.kt)("inlineCode",{parentName:"strong"},'"rename party [ glossaryText: ]"'))),(0,n.kt)("ul",{parentName:"li"},(0,n.kt)("li",{parentName:"ul"},"searches for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entry")," whose ",(0,n.kt)("inlineCode",{parentName:"li"},"term")," field has value ",(0,n.kt)("inlineCode",{parentName:"li"},"party"),", and (when found)"),(0,n.kt)("li",{parentName:"ul"},"removes the contents from the ",(0,n.kt)("inlineCode",{parentName:"li"},"glossaryText")," field if such a field exists.",(0,n.kt)("br",null)))))),(0,n.kt)("div",{className:"footnotes"},(0,n.kt)("hr",{parentName:"div"}),(0,n.kt)("ol",{parentName:"div"},(0,n.kt)("li",{parentName:"ol",id:"fn-1"},"'matching' means that ","[",(0,n.kt)("mark",null,"TBD: specify the matching algorithm, in particular when the field itself is an arry, such as ",(0,n.kt)("inlineCode",{parentName:"li"},"grouptags"),", ",(0,n.kt)("inlineCode",{parentName:"li"},"headingids"),", etc."),"]",(0,n.kt)("a",{parentName:"li",href:"#fnref-1",className:"footnote-backref"},"\u21a9")))))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4832e89f.e66a3451.js b/assets/js/4832e89f.c8f58aad.js similarity index 98% rename from assets/js/4832e89f.e66a3451.js rename to assets/js/4832e89f.c8f58aad.js index 5b7861801..7f95d7c21 100644 --- a/assets/js/4832e89f.e66a3451.js +++ b/assets/js/4832e89f.c8f58aad.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9895],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>d});var r=n(7294);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function s(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var o=r.createContext({}),l=function(e){var t=r.useContext(o),n=t;return e&&(n="function"==typeof e?e(t):c(c({},t),e)),n},p=function(e){var t=l(e.components);return r.createElement(o.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var n=e.components,i=e.mdxType,s=e.originalType,o=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(n),d=i,m=u["".concat(o,".").concat(d)]||u[d]||f[d]||s;return n?r.createElement(m,c(c({ref:t},p),{},{components:n})):r.createElement(m,c({ref:t},p))}));function d(e,t){var n=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=n.length,c=new Array(s);c[0]=u;var a={};for(var o in t)hasOwnProperty.call(t,o)&&(a[o]=t[o]);a.originalType=e,a.mdxType="string"==typeof e?e:i,c[1]=a;for(var l=2;l{n.d(t,{Z:()=>v});var r=n(7294),i=n(6010),s=n(3438),c=n(9960),a=n(3919),o=n(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:n}=e;return r.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},n)}function d(e){let{href:t,icon:n,title:s,description:c}=e;return r.createElement(u,{href:t},r.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:s},n," ",s),c&&r.createElement("p",{className:(0,i.Z)("text--truncate",f),title:c},c))}function m(e){let{item:t}=e;const n=(0,s.Wl)(t);return n?r.createElement(d,{href:n,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,o.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function y(e){let{item:t}=e;const n=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,s.xz)(t.docId??void 0);return r.createElement(d,{href:t.href,icon:n,title:t.label,description:t.description??i?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return r.createElement(y,{item:t});case"category":return r.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const n=(0,s.jA)();return r.createElement(v,{items:n.items,className:t})}function v(e){const{items:t,className:n}=e;if(!t)return r.createElement(g,e);const c=(0,s.MN)(t);return r.createElement("section",{className:(0,i.Z)("row",n)},c.map(((e,t)=>r.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},r.createElement(h,{item:e})))))}},221:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>u,frontMatter:()=>c,metadata:()=>o,toc:()=>p});var r=n(3117),i=(n(7294),n(3905)),s=n(2991);const c={id:"specs-syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2."},a="Specifications - Syntax",o={unversionedId:"categories/specs-syntax",id:"categories/specs-syntax",title:"Specifications - Syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2.",source:"@site/docs/categories/34-specs-syntax.md",sourceDirName:"categories",slug:"/categories/specs-syntax",permalink:"/tev2-specifications/docs/categories/specs-syntax",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/34-specs-syntax.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:34,frontMatter:{id:"specs-syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2."},sidebar:"tev2SideBar",previous:{title:"TEv2 Config Files",permalink:"/tev2-specifications/docs/specs/files/configuration-file"},next:{title:"Term References (TermRefs)",permalink:"/tev2-specifications/docs/specs/syntax/term-refs"}},l={},p=[],f={toc:p};function u(e){let{components:t,...n}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,n,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications---syntax"},"Specifications - Syntax"),(0,i.kt)("p",null,"This section contains the specifications of the various SYNTAXes that are used within ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,i.kt)(s.Z,{folder:"/docs/specs/syntax",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9895],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>d});var r=n(7294);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function s(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var o=r.createContext({}),l=function(e){var t=r.useContext(o),n=t;return e&&(n="function"==typeof e?e(t):c(c({},t),e)),n},p=function(e){var t=l(e.components);return r.createElement(o.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},u=r.forwardRef((function(e,t){var n=e.components,i=e.mdxType,s=e.originalType,o=e.parentName,p=a(e,["components","mdxType","originalType","parentName"]),u=l(n),d=i,m=u["".concat(o,".").concat(d)]||u[d]||f[d]||s;return n?r.createElement(m,c(c({ref:t},p),{},{components:n})):r.createElement(m,c({ref:t},p))}));function d(e,t){var n=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=n.length,c=new Array(s);c[0]=u;var a={};for(var o in t)hasOwnProperty.call(t,o)&&(a[o]=t[o]);a.originalType=e,a.mdxType="string"==typeof e?e:i,c[1]=a;for(var l=2;l{n.d(t,{Z:()=>v});var r=n(7294),i=n(6010),s=n(3438),c=n(9960),a=n(3919),o=n(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",f="cardDescription_PWke";function u(e){let{href:t,children:n}=e;return r.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},n)}function d(e){let{href:t,icon:n,title:s,description:c}=e;return r.createElement(u,{href:t},r.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:s},n," ",s),c&&r.createElement("p",{className:(0,i.Z)("text--truncate",f),title:c},c))}function m(e){let{item:t}=e;const n=(0,s.Wl)(t);return n?r.createElement(d,{href:n,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,o.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function y(e){let{item:t}=e;const n=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,s.xz)(t.docId??void 0);return r.createElement(d,{href:t.href,icon:n,title:t.label,description:t.description??i?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return r.createElement(y,{item:t});case"category":return r.createElement(m,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function g(e){let{className:t}=e;const n=(0,s.jA)();return r.createElement(v,{items:n.items,className:t})}function v(e){const{items:t,className:n}=e;if(!t)return r.createElement(g,e);const c=(0,s.MN)(t);return r.createElement("section",{className:(0,i.Z)("row",n)},c.map(((e,t)=>r.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},r.createElement(h,{item:e})))))}},221:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>u,frontMatter:()=>c,metadata:()=>o,toc:()=>p});var r=n(3117),i=(n(7294),n(3905)),s=n(2991);const c={id:"specs-syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2."},a="Specifications - Syntax",o={unversionedId:"categories/specs-syntax",id:"categories/specs-syntax",title:"Specifications - Syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2.",source:"@site/docs/categories/34-specs-syntax.md",sourceDirName:"categories",slug:"/categories/specs-syntax",permalink:"/tev2-specifications/docs/categories/specs-syntax",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/34-specs-syntax.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:34,frontMatter:{id:"specs-syntax",description:"This section contains the specifications of the various SYNTAXes that are used within TEv2."},sidebar:"tev2SideBar",previous:{title:"TEv2 Config Files",permalink:"/tev2-specifications/docs/specs/files/configuration-file"},next:{title:"Term References (TermRefs)",permalink:"/tev2-specifications/docs/specs/syntax/term-refs"}},l={},p=[],f={toc:p};function u(e){let{components:t,...n}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,n,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications---syntax"},"Specifications - Syntax"),(0,i.kt)("p",null,"This section contains the specifications of the various SYNTAXes that are used within ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),"."),(0,i.kt)(s.Z,{folder:"/docs/specs/syntax",mdxType:"DocCardList"}))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/48eddb86.3f4a9239.js b/assets/js/48eddb86.36c555d6.js similarity index 99% rename from assets/js/48eddb86.3f4a9239.js rename to assets/js/48eddb86.36c555d6.js index 297af793d..e6588dcf8 100644 --- a/assets/js/48eddb86.3f4a9239.js +++ b/assets/js/48eddb86.36c555d6.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1587],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>h});var r=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=r.createContext({}),l=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},d=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),p=l(a),h=i,m=p["".concat(c,".").concat(h)]||p[h]||f[h]||n;return a?r.createElement(m,s(s({ref:t},d),{},{components:a})):r.createElement(m,s({ref:t},d))}));function h(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=a.length,s=new Array(n);s[0]=p;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:i,s[1]=o;for(var l=2;l{a.d(t,{Z:()=>s});var r=a(7294),i=a(6010);const n="tabItem_Ymn6";function s(e){let{children:t,hidden:a,className:s}=e;return r.createElement("div",{role:"tabpanel",className:(0,i.Z)(n,s),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var r=a(3117),i=a(7294),n=a(6010),s=a(2466),o=a(6775),c=a(1980),l=a(7392),d=a(12);function f(e){return function(e){return i.Children.map(e,(e=>{if(!e||(0,i.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:r,default:i}}=e;return{value:t,label:a,attributes:r,default:i}}))}function p(e){const{values:t,children:a}=e;return(0,i.useMemo)((()=>{const e=t??f(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function h(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function m(e){let{queryString:t=!1,groupId:a}=e;const r=(0,o.k6)(),n=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(n),(0,i.useCallback)((e=>{if(!n)return;const t=new URLSearchParams(r.location.search);t.set(n,e),r.replace({...r.location,search:t.toString()})}),[n,r])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:r}=e,n=p(e),[s,o]=(0,i.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!h({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const r=a.find((e=>e.default))??a[0];if(!r)throw new Error("Unexpected error: 0 tabValues");return r.value}({defaultValue:t,tabValues:n}))),[c,l]=m({queryString:a,groupId:r}),[f,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[r,n]=(0,d.Nk)(a);return[r,(0,i.useCallback)((e=>{a&&n.set(e)}),[a,n])]}({groupId:r}),g=(()=>{const e=c??f;return h({value:e,tabValues:n})?e:null})();(0,i.useLayoutEffect)((()=>{g&&o(g)}),[g]);return{selectedValue:s,selectValue:(0,i.useCallback)((e=>{if(!h({value:e,tabValues:n}))throw new Error(`Can't select invalid tab value=${e}`);o(e),l(e),u(e)}),[l,u,n]),tabValues:n}}var g=a(2389);const y="tabList__CuJ",b="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:o,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:f}=(0,s.o5)(),p=e=>{const t=e.currentTarget,a=d.indexOf(t),r=l[a].value;r!==o&&(f(t),c(r))},h=e=>{let t=null;switch(e.key){case"Enter":p(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return i.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,n.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:s}=e;return i.createElement("li",(0,r.Z)({role:"tab",tabIndex:o===t?0:-1,"aria-selected":o===t,key:t,ref:e=>d.push(e),onKeyDown:h,onClick:p},s,{className:(0,n.Z)("tabs__item",b,s?.className,{"tabs__item--active":o===t})}),a??t)})))}function k(e){let{lazy:t,children:a,selectedValue:r}=e;const n=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=n.find((e=>e.props.value===r));return e?(0,i.cloneElement)(e,{className:"margin-top--md"}):null}return i.createElement("div",{className:"margin-top--md"},n.map(((e,t)=>(0,i.cloneElement)(e,{key:t,hidden:e.props.value!==r}))))}function w(e){const t=u(e);return i.createElement("div",{className:(0,n.Z)("tabs-container",y)},i.createElement(v,(0,r.Z)({},e,t)),i.createElement(k,(0,r.Z)({},e,t)))}function T(e){const t=(0,g.Z)();return i.createElement(w,(0,r.Z)({key:String(t)},e))}},869:(e,t,a)=>{a.d(t,{Z:()=>c});var r=a(7294),i=a(6775);const n="apiTable_e8hp";function s(e,t){let{name:a,children:n}=e;const s=function(e){let t=e;for(;(0,r.isValidElement)(t);)[t]=r.Children.toArray(t.props.children);return t}(n),o=a?`${a}-${s}`:s,c=`#${o}`,l=(0,i.k6)();return r.createElement("tr",{id:o,tabIndex:0,ref:l.location.hash===c?t:void 0,onClick:e=>{"A"===e.target.tagName.toUpperCase()||l.push(c)},onKeyDown:e=>{"Enter"===e.key&&l.push(c)}},n.props.children)}const o=r.forwardRef(s);function c(e){let{children:t,name:a}=e;const[i,s]=r.Children.toArray(t.props.children),c=(0,r.useRef)(null);(0,r.useEffect)((()=>{c.current?.focus()}),[c]);const l=r.Children.map(s.props.children,(e=>r.createElement(o,{name:a,ref:c},e)));return r.createElement("table",{className:n},i,r.createElement("tbody",null,l))}},4351:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>f,contentTitle:()=>l,default:()=>m,frontMatter:()=>c,metadata:()=>d,toc:()=>p});var r=a(3117),i=(a(7294),a(3905)),n=(a(4996),a(869)),s=a(4866),o=a(5162);const c={id:"mrg-refs",sidebar_label:"MRG References (MRGRefs)",date:20231029},l="MRG References - Syntax",d={unversionedId:"specs/syntax/mrg-refs",id:"specs/syntax/mrg-refs",title:"MRG References - Syntax",description:"MRG References (or MRGRefs for short) are textual constructs that refer to a specific terminology within a particular scope. The purpose of an MRG Reference is that it can be converted (by the HRGT) into a text that contains a human readable glossary of the terms contained in that terminology.",source:"@site/docs/specs/syntax/41-mrg-refs.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/mrg-refs",permalink:"/tev2-specifications/docs/specs/syntax/mrg-refs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/41-mrg-refs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:41,frontMatter:{id:"mrg-refs",sidebar_label:"MRG References (MRGRefs)",date:20231029},sidebar:"tev2SideBar",previous:{title:"Terminology Identifiers",permalink:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},next:{title:"Term Selection",permalink:"/tev2-specifications/docs/specs/syntax/term-selection"}},f={},p=[{value:"Default MRGRef Syntax",id:"default-mrgref-syntax",level:2},{value:"Predefined MRGRef Interpreters",id:"predefined-mrgref-interpreters",level:2},{value:"Predefined MRGRef Sorters",id:"predefined-mrgref-sorters",level:2},{value:"Predefined MRGRef Converters",id:"predefined-mrgref-converters",level:2},{value:"Converter for Markdown Tables",id:"converter-for-markdown-tables",level:3},{value:"Converter for eSSIF-Lab Glossary lookalikes",id:"converter-for-essif-lab-glossary-lookalikes",level:3},{value:"Custom Glossary Converters",id:"custom-glossary-converters",level:2}],h={toc:p};function m(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,r.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"mrg-references---syntax"},"MRG References - Syntax"),(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRG References")," (or ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," for short) are textual constructs that refer to a specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within a particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The purpose of an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRG Reference")," is that it can be converted (by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),") into a text that contains a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," contained in that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,i.kt)("p",null,"The syntax for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," is not fixed. While there is a default syntax, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can define their own syntax, and specify that as a command-line parameter or a parameter in the configuration file for appropriate tools, such as the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),". If an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is not specified, it defaults to ",(0,i.kt)("inlineCode",{parentName:"p"},"default"),", the associated syntax of which is specified below. "),(0,i.kt)("h2",{id:"default-mrgref-syntax"},"Default MRGRef Syntax"),(0,i.kt)("p",null,"The default syntax for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," is as follows:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'{% hrg="" converter="" sorter="" %}\n')),(0,i.kt)("p",null,"where"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier"),", that identifies a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and implies an associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") within the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),". If empty, or unspecified, it defaults to the default ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,i.kt)("admonition",{type:"warning"},(0,i.kt)("mdxAdmonitionTitle",{parentName:"admonition"},"(",(0,i.kt)("a",{parentName:"mdxAdmonitionTitle",href:"https://github.com/tno-terminology-design/tev2-tools/issues/25"},"issue #25"),")"),(0,i.kt)("p",{parentName:"admonition"},"When the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," points to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is not the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that appear in the generated glossary must be resolved using the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains the identified ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". Currently, the tools do not support a mechanism for doing this. ")),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},'converter=""')," specifies the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that is to be used for generating glossary entries. If it isn't specified as part of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),", it must be specified as a command-line parameter, or as a value in the configuration file that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," uses. "),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a text that specifies either: ",(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},"a predefined way in which glossary entries are being formatted (see ",(0,i.kt)("a",{parentName:"li",href:"#predefined-mrgref-converters"},"further down"),"), such as ",(0,i.kt)("inlineCode",{parentName:"li"},"markdowntable")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"essif-lab"),";"),(0,i.kt)("li",{parentName:"ul"},"a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"."))),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},'sorter=""')," specifies the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorter")," that is to be used for sorting the glossary entries. If it isn't specified as part of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),", it is derived from the command-line parameter, or the a value in the configuration file that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," uses. If neither is specified, it defaults to ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a text that specifies either: ",(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},"a predefined way in which glossary entries are being sorted (see ",(0,i.kt)("a",{parentName:"li",href:"#predefined-mrgref-sorters"},"further down"),"), such as ",(0,i.kt)("inlineCode",{parentName:"li"},"default")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"glossaryterm"),";"),(0,i.kt)("li",{parentName:"ul"},"a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),".")))),(0,i.kt)("h2",{id:"predefined-mrgref-interpreters"},"Predefined MRGRef Interpreters"),(0,i.kt)("p",null,"Predefined glossary interpreters have the advantage that they are easy to use. However, it is possible that in particular contexts, they pose problems. For such cases, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can specify custom formats."),(0,i.kt)("p",null,"The predefined interpreters for detecting ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," are as follows:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"default")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},'{% hrg="" converter="" sorter="" %}'),", where ",(0,i.kt)("inlineCode",{parentName:"td"},'converter=""')," and ",(0,i.kt)("inlineCode",{parentName:"td"},'sorter=""')," are optional. This is the default ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),"."))))),(0,i.kt)("h2",{id:"predefined-mrgref-sorters"},"Predefined MRGRef Sorters"),(0,i.kt)("p",null,"Sorters are similar to ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", in that they can either specify a predefined way of sorting glossary entries, or a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," that specifies how to sort them."),(0,i.kt)("p",null,"The predefined sorters for glossary generation are:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Expression"),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"default")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"{{term}}{{termType}}")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are first sorted on the ",(0,i.kt)("inlineCode",{parentName:"td"},"term")," field, and then on the ",(0,i.kt)("inlineCode",{parentName:"td"},"termType")," field.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"glossaryterm")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"{{glossaryTerm}}{{term}}{{termType}}")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are first sorted on the ",(0,i.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field, and then the same as ",(0,i.kt)("inlineCode",{parentName:"td"},"default"),"."))))),(0,i.kt)("h2",{id:"predefined-mrgref-converters"},"Predefined MRGRef Converters"),(0,i.kt)("p",null,"Predefined glossary layouts have the advantage that they are easy to use, and provide for a (small) range of generally useful layouts. Also, using them would produce acceptable results even in non-standard conditions, e.g., when a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," does not specify its ",(0,i.kt)("inlineCode",{parentName:"p"},"glossaryTerm")," field. "),(0,i.kt)("p",null,"However, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can specify other formats. To help them do this, the examples we provide for the predefined formats also show how the same, or similar, results can be achieved by customized specifications of the glossary layouts."),(0,i.kt)("p",null,"The predefined converters for glossary generation are:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-table-row")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a single markdown table row, where the first cell contains the term, and the second its description.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-section-2")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a markdown section, with the term as section header 2 ",(0,i.kt)("inlineCode",{parentName:"td"},"## "),", and the description as the section body below.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-section-3")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a markdown section, with the term as section header 3 ",(0,i.kt)("inlineCode",{parentName:"td"},"### "),", and the description as the section body below."))))),(0,i.kt)("h3",{id:"converter-for-markdown-tables"},"Converter for Markdown Tables"),(0,i.kt)("p",null,"An ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that specifies ",(0,i.kt)("inlineCode",{parentName:"p"},'converter="markdown-table-row"')," as its glossary layout is appropriate for generating a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," as a markdown table within a regular markdown file. Suppose that markdown file contains the following text."),(0,i.kt)(s.Z,{groupId:"md-converter",defaultValue:"predefined",values:[{label:"Using predefined layout",value:"predefined"},{label:"Simple customized layout",value:"simple"}],mdxType:"Tabs"},(0,i.kt)(o.Z,{value:"predefined",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using the predefined glossary layout called ",(0,i.kt)("inlineCode",{parentName:"p"},"markdown-table-row"),"."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n{% hrg="tev2" converter="markdown-table-row" %}\n---\n'))),(0,i.kt)(o.Z,{value:"simple",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", as follows."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n{% hrg="tev2" converter="| {{glossaryTerm}} | {{glossaryText}} |\\n" %}\n---\n')),(0,i.kt)("p",null,"Note that this is a simple ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", that is not very robust against missing variables. See, e.g., the section on ",(0,i.kt)("a",{parentName:"p",href:"#custom-glossary-converters"},"custom glossary converters")," on how to make them more robust, or even better: the documentation on ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars"),"."))),(0,i.kt)("hr",null),(0,i.kt)("p",null,"Under the assumption that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,i.kt)("inlineCode",{parentName:"p"},"tev2")," refers to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") that holds ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," ",(0,i.kt)("inlineCode",{parentName:"p"},"Glossary"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"Curator")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"Definition"),", the result could e.g., look something like the following."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n| Glossary | an alphabetically sorted list of terms with the (single) meaning it has in (at least) one context. |\n| Curator (of a Scope) | a person responsible for curating, managing, and maintaining the terminologies, to ensure shared understanding among a community working together on a particular set of objectives. |\n| Definition | the combination of a term and a descriptive text, where the term refers to a concept or other semantic unit, and the descriptive text enables a set of parties to have the same understanding about that concept. Ideally, the descriptive text is a criterion that such parties can use to determine what is, and what is not, an instance (or example) of that concept. |\n---\n')),(0,i.kt)("h3",{id:"converter-for-essif-lab-glossary-lookalikes"},"Converter for eSSIF-Lab Glossary lookalikes"),(0,i.kt)("p",null,"An ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that specifies ",(0,i.kt)("inlineCode",{parentName:"p"},'converter="markdown-section-3"')," as its glossary layout is appropriate for generating a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is similar to the one used by ",(0,i.kt)("a",{parentName:"p",href:"https://essif-lab.github.io/framework/docs/essifLab-glossary"},"eSSIF-Lab"),". The markdown file that would produce this would be as follows."),(0,i.kt)(s.Z,{groupId:"essif-converter",defaultValue:"predefined",values:[{label:"Using predefined layout",value:"predefined"},{label:"Simple customized layout",value:"simple"}],mdxType:"Tabs"},(0,i.kt)(o.Z,{value:"predefined",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using the predefined glossary layout called ",(0,i.kt)("inlineCode",{parentName:"p"},"markdown-section-3"),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n{% hrg="essif-lab" converter="markdown-section-3" %}\n\n---\nHere endeth the glossary.\n'))),(0,i.kt)(o.Z,{value:"simple",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", as follows:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n{% hrg="tev2" converter="### [{{glossaryTerm}}]({{localize navurl}})\\n\\n{{glossaryText}}\\n\\n" %}\n\n---\nHere endeth the glossary.\n')),(0,i.kt)("p",null,"Note that this is a simple ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", that is not very robust against missing variables. See, e.g., the section on ",(0,i.kt)("a",{parentName:"p",href:"#custom-glossary-converters"},"custom glossary converters")," on how to make them more robust, or even better: the documentation on ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars"),"."))),(0,i.kt)("hr",null),(0,i.kt)("p",null,"Under the assumption that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,i.kt)("inlineCode",{parentName:"p"},"essif-lab")," refers to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") that holds ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," ",(0,i.kt)("inlineCode",{parentName:"p"},"Glossary"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"Curator")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"Definition"),", the result could e.g., look something like this:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n### [Glossary](/docs/terms/glossary)\n\nan alphabetically sorted list of terms with the (single) meaning it has in (at least) one context.\n\n### [Curator (of a Scope)](/docs/terms/curator)\n\na person responsible for curating, managing, and maintaining the terminologies, to ensure shared understanding among a community working together on a particular set of objectives.\n\n### [Definition](/docs/terms/definition)\n\nthe combination of a term and a descriptive text, where the term refers to a concept or other semantic unit, and the descriptive text enables a set of parties to have the same understanding about that concept. Ideally, the descriptive text is a criterion that such parties can use to determine what is, and what is not, an instance (or example) of that concept.\n\n---\nHere endeth the glossary.\n')),(0,i.kt)("h2",{id:"custom-glossary-converters"},"Custom Glossary Converters"),(0,i.kt)("p",null,"When the predefined glossary converters are not appropriate, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can define their own converter, by specifying them as a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"."),(0,i.kt)("p",null,"The ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"s can use all fields of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," as variables. For example, ",(0,i.kt)("inlineCode",{parentName:"p"},"{{glossaryText}}"),", or ",(0,i.kt)("inlineCode",{parentName:"p"},"{{entry.glossaryText}}"),", is the variable that contains the text specified in the ",(0,i.kt)("inlineCode",{parentName:"p"},"glossaryText")," field of the specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and ",(0,i.kt)("inlineCode",{parentName:"p"},"{{err.file}}")," contains the name of the file where the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," was found."),(0,i.kt)("p",null,"Converters can use the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions",title:"Handlebars Helper Function: a function that can be used in a Handlebars Expression to manipulate or format the data before displaying it within a template."},"TEv2 helper functions")," and ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/block-helpers.html#basic-blocks"},"block helpers")," to create a diverse range of glossary entries. The example below illustrates this functionality. Note that the newlines and spaces are strictly handled by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter"),", in the example they are primarily for readability."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-ts"},'{{capFirst entry.term}}\n\n{{#if entry.glossaryText}}\n *Text derived from the {{mrg.scopetag}} glossary at {{mrg.website}}.*\n {{entry.glossaryText}}\n{{else}}\n No description available here at {{err.file}}, please see {{entry.navurl}}.\n{{/if}}\n\n{{#ifValue entry.termType equals="image"}}\n An image of {{term}}\n{{/ifValue}}\n\n')),(0,i.kt)("p",null,"Partially depending on the ",(0,i.kt)("inlineCode",{parentName:"p"},"TermType")," property of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", this converter string can produce output with images, links, and text, that accurately describes a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," refers to."))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1587],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>h});var r=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function s(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=r.createContext({}),l=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s(s({},t),e)),a},d=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),p=l(a),h=i,m=p["".concat(c,".").concat(h)]||p[h]||f[h]||n;return a?r.createElement(m,s(s({ref:t},d),{},{components:a})):r.createElement(m,s({ref:t},d))}));function h(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=a.length,s=new Array(n);s[0]=p;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:i,s[1]=o;for(var l=2;l{a.d(t,{Z:()=>s});var r=a(7294),i=a(6010);const n="tabItem_Ymn6";function s(e){let{children:t,hidden:a,className:s}=e;return r.createElement("div",{role:"tabpanel",className:(0,i.Z)(n,s),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var r=a(3117),i=a(7294),n=a(6010),s=a(2466),o=a(6775),c=a(1980),l=a(7392),d=a(12);function f(e){return function(e){return i.Children.map(e,(e=>{if(!e||(0,i.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:r,default:i}}=e;return{value:t,label:a,attributes:r,default:i}}))}function p(e){const{values:t,children:a}=e;return(0,i.useMemo)((()=>{const e=t??f(a);return function(e){const t=(0,l.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function h(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function m(e){let{queryString:t=!1,groupId:a}=e;const r=(0,o.k6)(),n=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,c._X)(n),(0,i.useCallback)((e=>{if(!n)return;const t=new URLSearchParams(r.location.search);t.set(n,e),r.replace({...r.location,search:t.toString()})}),[n,r])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:r}=e,n=p(e),[s,o]=(0,i.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!h({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const r=a.find((e=>e.default))??a[0];if(!r)throw new Error("Unexpected error: 0 tabValues");return r.value}({defaultValue:t,tabValues:n}))),[c,l]=m({queryString:a,groupId:r}),[f,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[r,n]=(0,d.Nk)(a);return[r,(0,i.useCallback)((e=>{a&&n.set(e)}),[a,n])]}({groupId:r}),g=(()=>{const e=c??f;return h({value:e,tabValues:n})?e:null})();(0,i.useLayoutEffect)((()=>{g&&o(g)}),[g]);return{selectedValue:s,selectValue:(0,i.useCallback)((e=>{if(!h({value:e,tabValues:n}))throw new Error(`Can't select invalid tab value=${e}`);o(e),l(e),u(e)}),[l,u,n]),tabValues:n}}var g=a(2389);const y="tabList__CuJ",b="tabItem_LNqP";function v(e){let{className:t,block:a,selectedValue:o,selectValue:c,tabValues:l}=e;const d=[],{blockElementScrollPositionUntilNextRender:f}=(0,s.o5)(),p=e=>{const t=e.currentTarget,a=d.indexOf(t),r=l[a].value;r!==o&&(f(t),c(r))},h=e=>{let t=null;switch(e.key){case"Enter":p(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return i.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,n.Z)("tabs",{"tabs--block":a},t)},l.map((e=>{let{value:t,label:a,attributes:s}=e;return i.createElement("li",(0,r.Z)({role:"tab",tabIndex:o===t?0:-1,"aria-selected":o===t,key:t,ref:e=>d.push(e),onKeyDown:h,onClick:p},s,{className:(0,n.Z)("tabs__item",b,s?.className,{"tabs__item--active":o===t})}),a??t)})))}function k(e){let{lazy:t,children:a,selectedValue:r}=e;const n=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=n.find((e=>e.props.value===r));return e?(0,i.cloneElement)(e,{className:"margin-top--md"}):null}return i.createElement("div",{className:"margin-top--md"},n.map(((e,t)=>(0,i.cloneElement)(e,{key:t,hidden:e.props.value!==r}))))}function w(e){const t=u(e);return i.createElement("div",{className:(0,n.Z)("tabs-container",y)},i.createElement(v,(0,r.Z)({},e,t)),i.createElement(k,(0,r.Z)({},e,t)))}function T(e){const t=(0,g.Z)();return i.createElement(w,(0,r.Z)({key:String(t)},e))}},869:(e,t,a)=>{a.d(t,{Z:()=>c});var r=a(7294),i=a(6775);const n="apiTable_e8hp";function s(e,t){let{name:a,children:n}=e;const s=function(e){let t=e;for(;(0,r.isValidElement)(t);)[t]=r.Children.toArray(t.props.children);return t}(n),o=a?`${a}-${s}`:s,c=`#${o}`,l=(0,i.k6)();return r.createElement("tr",{id:o,tabIndex:0,ref:l.location.hash===c?t:void 0,onClick:e=>{"A"===e.target.tagName.toUpperCase()||l.push(c)},onKeyDown:e=>{"Enter"===e.key&&l.push(c)}},n.props.children)}const o=r.forwardRef(s);function c(e){let{children:t,name:a}=e;const[i,s]=r.Children.toArray(t.props.children),c=(0,r.useRef)(null);(0,r.useEffect)((()=>{c.current?.focus()}),[c]);const l=r.Children.map(s.props.children,(e=>r.createElement(o,{name:a,ref:c},e)));return r.createElement("table",{className:n},i,r.createElement("tbody",null,l))}},4351:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>f,contentTitle:()=>l,default:()=>m,frontMatter:()=>c,metadata:()=>d,toc:()=>p});var r=a(3117),i=(a(7294),a(3905)),n=(a(4996),a(869)),s=a(4866),o=a(5162);const c={id:"mrg-refs",sidebar_label:"MRG References (MRGRefs)",date:20231029},l="MRG References - Syntax",d={unversionedId:"specs/syntax/mrg-refs",id:"specs/syntax/mrg-refs",title:"MRG References - Syntax",description:"MRG References (or MRGRefs for short) are textual constructs that refer to a specific terminology within a particular scope. The purpose of an MRG Reference is that it can be converted (by the HRGT) into a text that contains a human readable glossary of the terms contained in that terminology.",source:"@site/docs/specs/syntax/41-mrg-refs.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/mrg-refs",permalink:"/tev2-specifications/docs/specs/syntax/mrg-refs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/41-mrg-refs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:41,frontMatter:{id:"mrg-refs",sidebar_label:"MRG References (MRGRefs)",date:20231029},sidebar:"tev2SideBar",previous:{title:"Terminology Identifiers",permalink:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},next:{title:"Term Selection",permalink:"/tev2-specifications/docs/specs/syntax/term-selection"}},f={},p=[{value:"Default MRGRef Syntax",id:"default-mrgref-syntax",level:2},{value:"Predefined MRGRef Interpreters",id:"predefined-mrgref-interpreters",level:2},{value:"Predefined MRGRef Sorters",id:"predefined-mrgref-sorters",level:2},{value:"Predefined MRGRef Converters",id:"predefined-mrgref-converters",level:2},{value:"Converter for Markdown Tables",id:"converter-for-markdown-tables",level:3},{value:"Converter for eSSIF-Lab Glossary lookalikes",id:"converter-for-essif-lab-glossary-lookalikes",level:3},{value:"Custom Glossary Converters",id:"custom-glossary-converters",level:2}],h={toc:p};function m(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,r.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"mrg-references---syntax"},"MRG References - Syntax"),(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRG References")," (or ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," for short) are textual constructs that refer to a specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within a particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The purpose of an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRG Reference")," is that it can be converted (by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),") into a text that contains a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," contained in that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,i.kt)("p",null,"The syntax for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," is not fixed. While there is a default syntax, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can define their own syntax, and specify that as a command-line parameter or a parameter in the configuration file for appropriate tools, such as the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),". If an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is not specified, it defaults to ",(0,i.kt)("inlineCode",{parentName:"p"},"default"),", the associated syntax of which is specified below. "),(0,i.kt)("h2",{id:"default-mrgref-syntax"},"Default MRGRef Syntax"),(0,i.kt)("p",null,"The default syntax for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," is as follows:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'{% hrg="" converter="" sorter="" %}\n')),(0,i.kt)("p",null,"where"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier"),", that identifies a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and implies an associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") within the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),". If empty, or unspecified, it defaults to the default ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,i.kt)("admonition",{type:"warning"},(0,i.kt)("mdxAdmonitionTitle",{parentName:"admonition"},"(",(0,i.kt)("a",{parentName:"mdxAdmonitionTitle",href:"https://github.com/tno-terminology-design/tev2-tools/issues/25"},"issue #25"),")"),(0,i.kt)("p",{parentName:"admonition"},"When the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," points to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is not the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that appear in the generated glossary must be resolved using the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains the identified ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". Currently, the tools do not support a mechanism for doing this. ")),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},'converter=""')," specifies the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that is to be used for generating glossary entries. If it isn't specified as part of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),", it must be specified as a command-line parameter, or as a value in the configuration file that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," uses. "),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a text that specifies either: ",(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},"a predefined way in which glossary entries are being formatted (see ",(0,i.kt)("a",{parentName:"li",href:"#predefined-mrgref-converters"},"further down"),"), such as ",(0,i.kt)("inlineCode",{parentName:"li"},"markdowntable")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"essif-lab"),";"),(0,i.kt)("li",{parentName:"ul"},"a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"."))),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},'sorter=""')," specifies the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/sorter",title:"Sorter: a specification, in the form of a predefined value or a Handlebars Template, of the value that is to be used for sorting a list, e.g., for sorting HRG Entries within a HRG List."},"sorter")," that is to be used for sorting the glossary entries. If it isn't specified as part of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),", it is derived from the command-line parameter, or the a value in the configuration file that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," uses. If neither is specified, it defaults to ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"")," is a text that specifies either: ",(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},"a predefined way in which glossary entries are being sorted (see ",(0,i.kt)("a",{parentName:"li",href:"#predefined-mrgref-sorters"},"further down"),"), such as ",(0,i.kt)("inlineCode",{parentName:"li"},"default")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"glossaryterm"),";"),(0,i.kt)("li",{parentName:"ul"},"a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),".")))),(0,i.kt)("h2",{id:"predefined-mrgref-interpreters"},"Predefined MRGRef Interpreters"),(0,i.kt)("p",null,"Predefined glossary interpreters have the advantage that they are easy to use. However, it is possible that in particular contexts, they pose problems. For such cases, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can specify custom formats."),(0,i.kt)("p",null,"The predefined interpreters for detecting ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs")," are as follows:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"default")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},'{% hrg="" converter="" sorter="" %}'),", where ",(0,i.kt)("inlineCode",{parentName:"td"},'converter=""')," and ",(0,i.kt)("inlineCode",{parentName:"td"},'sorter=""')," are optional. This is the default ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," for ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),"."))))),(0,i.kt)("h2",{id:"predefined-mrgref-sorters"},"Predefined MRGRef Sorters"),(0,i.kt)("p",null,"Sorters are similar to ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", in that they can either specify a predefined way of sorting glossary entries, or a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," that specifies how to sort them."),(0,i.kt)("p",null,"The predefined sorters for glossary generation are:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Expression"),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"default")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"{{term}}{{termType}}")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are first sorted on the ",(0,i.kt)("inlineCode",{parentName:"td"},"term")," field, and then on the ",(0,i.kt)("inlineCode",{parentName:"td"},"termType")," field.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"glossaryterm")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"{{glossaryTerm}}{{term}}{{termType}}")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are first sorted on the ",(0,i.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field, and then the same as ",(0,i.kt)("inlineCode",{parentName:"td"},"default"),"."))))),(0,i.kt)("h2",{id:"predefined-mrgref-converters"},"Predefined MRGRef Converters"),(0,i.kt)("p",null,"Predefined glossary layouts have the advantage that they are easy to use, and provide for a (small) range of generally useful layouts. Also, using them would produce acceptable results even in non-standard conditions, e.g., when a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," does not specify its ",(0,i.kt)("inlineCode",{parentName:"p"},"glossaryTerm")," field. "),(0,i.kt)("p",null,"However, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can specify other formats. To help them do this, the examples we provide for the predefined formats also show how the same, or similar, results can be achieved by customized specifications of the glossary layouts."),(0,i.kt)("p",null,"The predefined converters for glossary generation are:"),(0,i.kt)(n.Z,{mdxType:"APITable"},(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-table-row")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a single markdown table row, where the first cell contains the term, and the second its description.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-section-2")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a markdown section, with the term as section header 2 ",(0,i.kt)("inlineCode",{parentName:"td"},"## "),", and the description as the section body below.")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("inlineCode",{parentName:"td"},"markdown-section-3")),(0,i.kt)("td",{parentName:"tr",align:"left"},(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are compiled as a markdown section, with the term as section header 3 ",(0,i.kt)("inlineCode",{parentName:"td"},"### "),", and the description as the section body below."))))),(0,i.kt)("h3",{id:"converter-for-markdown-tables"},"Converter for Markdown Tables"),(0,i.kt)("p",null,"An ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that specifies ",(0,i.kt)("inlineCode",{parentName:"p"},'converter="markdown-table-row"')," as its glossary layout is appropriate for generating a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," as a markdown table within a regular markdown file. Suppose that markdown file contains the following text."),(0,i.kt)(s.Z,{groupId:"md-converter",defaultValue:"predefined",values:[{label:"Using predefined layout",value:"predefined"},{label:"Simple customized layout",value:"simple"}],mdxType:"Tabs"},(0,i.kt)(o.Z,{value:"predefined",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using the predefined glossary layout called ",(0,i.kt)("inlineCode",{parentName:"p"},"markdown-table-row"),"."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n{% hrg="tev2" converter="markdown-table-row" %}\n---\n'))),(0,i.kt)(o.Z,{value:"simple",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", as follows."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n{% hrg="tev2" converter="| {{glossaryTerm}} | {{glossaryText}} |\\n" %}\n---\n')),(0,i.kt)("p",null,"Note that this is a simple ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", that is not very robust against missing variables. See, e.g., the section on ",(0,i.kt)("a",{parentName:"p",href:"#custom-glossary-converters"},"custom glossary converters")," on how to make them more robust, or even better: the documentation on ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars"),"."))),(0,i.kt)("hr",null),(0,i.kt)("p",null,"Under the assumption that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,i.kt)("inlineCode",{parentName:"p"},"tev2")," refers to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") that holds ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," ",(0,i.kt)("inlineCode",{parentName:"p"},"Glossary"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"Curator")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"Definition"),", the result could e.g., look something like the following."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'| Term | Description |\n| :--- | :---------- |\n| Glossary | an alphabetically sorted list of terms with the (single) meaning it has in (at least) one context. |\n| Curator (of a Scope) | a person responsible for curating, managing, and maintaining the terminologies, to ensure shared understanding among a community working together on a particular set of objectives. |\n| Definition | the combination of a term and a descriptive text, where the term refers to a concept or other semantic unit, and the descriptive text enables a set of parties to have the same understanding about that concept. Ideally, the descriptive text is a criterion that such parties can use to determine what is, and what is not, an instance (or example) of that concept. |\n---\n')),(0,i.kt)("h3",{id:"converter-for-essif-lab-glossary-lookalikes"},"Converter for eSSIF-Lab Glossary lookalikes"),(0,i.kt)("p",null,"An ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that specifies ",(0,i.kt)("inlineCode",{parentName:"p"},'converter="markdown-section-3"')," as its glossary layout is appropriate for generating a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is similar to the one used by ",(0,i.kt)("a",{parentName:"p",href:"https://essif-lab.github.io/framework/docs/essifLab-glossary"},"eSSIF-Lab"),". The markdown file that would produce this would be as follows."),(0,i.kt)(s.Z,{groupId:"essif-converter",defaultValue:"predefined",values:[{label:"Using predefined layout",value:"predefined"},{label:"Simple customized layout",value:"simple"}],mdxType:"Tabs"},(0,i.kt)(o.Z,{value:"predefined",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using the predefined glossary layout called ",(0,i.kt)("inlineCode",{parentName:"p"},"markdown-section-3"),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n{% hrg="essif-lab" converter="markdown-section-3" %}\n\n---\nHere endeth the glossary.\n'))),(0,i.kt)(o.Z,{value:"simple",mdxType:"TabItem"},(0,i.kt)("br",null),(0,i.kt)("p",null,"Specifying the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," using a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", as follows:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n{% hrg="tev2" converter="### [{{glossaryTerm}}]({{localize navurl}})\\n\\n{{glossaryText}}\\n\\n" %}\n\n---\nHere endeth the glossary.\n')),(0,i.kt)("p",null,"Note that this is a simple ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", that is not very robust against missing variables. See, e.g., the section on ",(0,i.kt)("a",{parentName:"p",href:"#custom-glossary-converters"},"custom glossary converters")," on how to make them more robust, or even better: the documentation on ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars"),"."))),(0,i.kt)("hr",null),(0,i.kt)("p",null,"Under the assumption that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier")," ",(0,i.kt)("inlineCode",{parentName:"p"},"essif-lab")," refers to a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (and associated ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),") that holds ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," ",(0,i.kt)("inlineCode",{parentName:"p"},"Glossary"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"Curator")," and ",(0,i.kt)("inlineCode",{parentName:"p"},"Definition"),", the result could e.g., look something like this:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-markdown"},'---\n# Docusaurus header fields:\nid: glossary\nsidebar_label: Glossary\n---\n\n# Glossary\n\n### [Glossary](/docs/terms/glossary)\n\nan alphabetically sorted list of terms with the (single) meaning it has in (at least) one context.\n\n### [Curator (of a Scope)](/docs/terms/curator)\n\na person responsible for curating, managing, and maintaining the terminologies, to ensure shared understanding among a community working together on a particular set of objectives.\n\n### [Definition](/docs/terms/definition)\n\nthe combination of a term and a descriptive text, where the term refers to a concept or other semantic unit, and the descriptive text enables a set of parties to have the same understanding about that concept. Ideally, the descriptive text is a criterion that such parties can use to determine what is, and what is not, an instance (or example) of that concept.\n\n---\nHere endeth the glossary.\n')),(0,i.kt)("h2",{id:"custom-glossary-converters"},"Custom Glossary Converters"),(0,i.kt)("p",null,"When the predefined glossary converters are not appropriate, ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," can define their own converter, by specifying them as a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"."),(0,i.kt)("p",null,"The ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),"s can use all fields of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," as variables. For example, ",(0,i.kt)("inlineCode",{parentName:"p"},"{{glossaryText}}"),", or ",(0,i.kt)("inlineCode",{parentName:"p"},"{{entry.glossaryText}}"),", is the variable that contains the text specified in the ",(0,i.kt)("inlineCode",{parentName:"p"},"glossaryText")," field of the specific ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and ",(0,i.kt)("inlineCode",{parentName:"p"},"{{err.file}}")," contains the name of the file where the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," was found."),(0,i.kt)("p",null,"Converters can use the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions",title:"Handlebars Helper Function: a function that can be used in a Handlebars Expression to manipulate or format the data before displaying it within a template."},"TEv2 helper functions")," and ",(0,i.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/block-helpers.html#basic-blocks"},"block helpers")," to create a diverse range of glossary entries. The example below illustrates this functionality. Note that the newlines and spaces are strictly handled by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter"),", in the example they are primarily for readability."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-ts"},'{{capFirst entry.term}}\n\n{{#if entry.glossaryText}}\n *Text derived from the {{mrg.scopetag}} glossary at {{mrg.website}}.*\n {{entry.glossaryText}}\n{{else}}\n No description available here at {{err.file}}, please see {{entry.navurl}}.\n{{/if}}\n\n{{#ifValue entry.termType equals="image"}}\n An image of {{term}}\n{{/ifValue}}\n\n')),(0,i.kt)("p",null,"Partially depending on the ",(0,i.kt)("inlineCode",{parentName:"p"},"TermType")," property of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", this converter string can produce output with images, links, and text, that accurately describes a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," refers to."))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/49f969b0.86f05bb3.js b/assets/js/49f969b0.42567dd7.js similarity index 99% rename from assets/js/49f969b0.86f05bb3.js rename to assets/js/49f969b0.42567dd7.js index 744f7ad4e..242c90c96 100644 --- a/assets/js/49f969b0.86f05bb3.js +++ b/assets/js/49f969b0.42567dd7.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3519],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>m});var i=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function s(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var c=i.createContext({}),l=function(e){var t=i.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},p=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),d=l(n),m=o,f=d["".concat(c,".").concat(m)]||d[m]||h[m]||a;return n?i.createElement(f,s(s({ref:t},p),{},{components:n})):i.createElement(f,s({ref:t},p))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,s=new Array(a);s[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,s[1]=r;for(var l=2;l{n.r(t),n.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>h,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var i=n(3117),o=(n(7294),n(3905));const a={id:"relation",displayed_sidebar:"tev2SideBar",term:"relation",termType:"concept",isa:null,glossaryTerm:"Relation (between Concepts)",glossaryText:"a (significant) connection or association between two or more [concepts](@).",glossaryNotes:["These connections define the way these [concepts](@) are interrelated, providing insights into how they interact and influence each other."],grouptags:["conceptual-modeling"],formPhrases:["relation{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Relation (between Concepts)",r={unversionedId:"terms/relation",id:"terms/relation",title:"Relation (between Concepts)",description:"A relation (between concepts) is a (significant) connection or association between two or more concepts. These connections define the way these concepts are interrelated, providing insights into how they interact and influence each other.",source:"@site/docs/terms/relation.md",sourceDirName:"terms",slug:"/terms/relation",permalink:"/tev2-specifications/docs/terms/relation",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/relation.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"relation",displayed_sidebar:"tev2SideBar",term:"relation",termType:"concept",isa:null,glossaryTerm:"Relation (between Concepts)",glossaryText:"a (significant) connection or association between two or more [concepts](@).",glossaryNotes:["These connections define the way these [concepts](@) are interrelated, providing insights into how they interact and influence each other."],grouptags:["conceptual-modeling"],formPhrases:["relation{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],p={toc:l};function h(e){let{components:t,...n}=e;return(0,o.kt)("wrapper",(0,i.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"relation-between-concepts"},"Relation (between Concepts)"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"relation (between ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),")")," is a (significant) connection or association between two or more ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". These connections define the way these ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,o.kt)("p",null,"Relations can have multiplicity constraints, which specify the possible cardinalities or number of occurrences allowed between the connected concepts. (See ",(0,o.kt)("a",{parentName:"p",href:"https://stackoverflow.com/questions/17877582/multiplicity-vs-cardinality#:~:text=Simply%20put%3A%20a%20multiplicity%20is,They%20are%20not%20synonymous."},"this item on StackOverflow"),".) They are crucial for accurately representing the structure and behavior of conceptual models."),(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"Relations")," are complemented with ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"Properties"),", that describe characteristics of individual ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in terms of data attributes or values.",(0,o.kt)("p",null,"Properly defining relations enables people to establish a shared understanding of how different concepts within the model relate to one another, supporting effective collaboration and communication among stakeholders."),(0,o.kt)("h2",{id:"examples"},"Examples"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"In a conceptual model that answers questions about onboarding, keeping, and offboarding people (as employees) in organizations, we have the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," ",(0,o.kt)("inlineCode",{parentName:"li"},"Person"),", the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," ",(0,o.kt)("inlineCode",{parentName:"li"},"Organization"),", and a relation ",(0,o.kt)("inlineCode",{parentName:"li"},"is employee of"),", which connects the ",(0,o.kt)("inlineCode",{parentName:"li"},"Person")," concept with the ",(0,o.kt)("inlineCode",{parentName:"li"},"Organization"),' concept, where this relation and can be defined, e.g., as "{Person} has successfully completed the onboarding process of the {Organization}, and has not been offboarded".'),(0,o.kt)("li",{parentName:"ol"},'A "Part-Of" relation in a hierarchical taxonomy establishes the subordination of concepts, such as "Car" being a part of the "Vehicle" concept.'),(0,o.kt)("li",{parentName:"ol"},"Other examples are given on the page ",(0,o.kt)("a",{parentName:"li",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions"),".")),(0,o.kt)("h2",{id:"notes"},"Notes"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Relations play a fundamental role in expressing the interdependence and dependencies between concepts in a conceptual model."),(0,o.kt)("li",{parentName:"ul"},"Understanding and defining relations are essential for ensuring a consistent and comprehensive representation of the domain.")))}h.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3519],{3905:(e,t,n)=>{n.d(t,{Zo:()=>p,kt:()=>m});var i=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function s(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var c=i.createContext({}),l=function(e){var t=i.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},p=function(e){var t=l(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),d=l(n),m=o,f=d["".concat(c,".").concat(m)]||d[m]||h[m]||a;return n?i.createElement(f,s(s({ref:t},p),{},{components:n})):i.createElement(f,s({ref:t},p))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,s=new Array(a);s[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,s[1]=r;for(var l=2;l{n.r(t),n.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>h,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var i=n(3117),o=(n(7294),n(3905));const a={id:"relation",displayed_sidebar:"tev2SideBar",term:"relation",termType:"concept",isa:null,glossaryTerm:"Relation (between Concepts)",glossaryText:"a (significant) connection or association between two or more [concepts](@).",glossaryNotes:["These connections define the way these [concepts](@) are interrelated, providing insights into how they interact and influence each other."],grouptags:["conceptual-modeling"],formPhrases:["relation{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Relation (between Concepts)",r={unversionedId:"terms/relation",id:"terms/relation",title:"Relation (between Concepts)",description:"A relation (between concepts) is a (significant) connection or association between two or more concepts. These connections define the way these concepts are interrelated, providing insights into how they interact and influence each other.",source:"@site/docs/terms/relation.md",sourceDirName:"terms",slug:"/terms/relation",permalink:"/tev2-specifications/docs/terms/relation",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/relation.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"relation",displayed_sidebar:"tev2SideBar",term:"relation",termType:"concept",isa:null,glossaryTerm:"Relation (between Concepts)",glossaryText:"a (significant) connection or association between two or more [concepts](@).",glossaryNotes:["These connections define the way these [concepts](@) are interrelated, providing insights into how they interact and influence each other."],grouptags:["conceptual-modeling"],formPhrases:["relation{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],p={toc:l};function h(e){let{components:t,...n}=e;return(0,o.kt)("wrapper",(0,i.Z)({},p,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"relation-between-concepts"},"Relation (between Concepts)"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"relation (between ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),")")," is a (significant) connection or association between two or more ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". These connections define the way these ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,o.kt)("p",null,"Relations can have multiplicity constraints, which specify the possible cardinalities or number of occurrences allowed between the connected concepts. (See ",(0,o.kt)("a",{parentName:"p",href:"https://stackoverflow.com/questions/17877582/multiplicity-vs-cardinality#:~:text=Simply%20put%3A%20a%20multiplicity%20is,They%20are%20not%20synonymous."},"this item on StackOverflow"),".) They are crucial for accurately representing the structure and behavior of conceptual models."),(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"Relations")," are complemented with ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"Properties"),", that describe characteristics of individual ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in terms of data attributes or values.",(0,o.kt)("p",null,"Properly defining relations enables people to establish a shared understanding of how different concepts within the model relate to one another, supporting effective collaboration and communication among stakeholders."),(0,o.kt)("h2",{id:"examples"},"Examples"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"In a conceptual model that answers questions about onboarding, keeping, and offboarding people (as employees) in organizations, we have the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," ",(0,o.kt)("inlineCode",{parentName:"li"},"Person"),", the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," ",(0,o.kt)("inlineCode",{parentName:"li"},"Organization"),", and a relation ",(0,o.kt)("inlineCode",{parentName:"li"},"is employee of"),", which connects the ",(0,o.kt)("inlineCode",{parentName:"li"},"Person")," concept with the ",(0,o.kt)("inlineCode",{parentName:"li"},"Organization"),' concept, where this relation and can be defined, e.g., as "{Person} has successfully completed the onboarding process of the {Organization}, and has not been offboarded".'),(0,o.kt)("li",{parentName:"ol"},'A "Part-Of" relation in a hierarchical taxonomy establishes the subordination of concepts, such as "Car" being a part of the "Vehicle" concept.'),(0,o.kt)("li",{parentName:"ol"},"Other examples are given on the page ",(0,o.kt)("a",{parentName:"li",href:"/docs/miscellaneous/notations-and-conventions#pattern-diagram-notations"},"notations and conventions"),".")),(0,o.kt)("h2",{id:"notes"},"Notes"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Relations play a fundamental role in expressing the interdependence and dependencies between concepts in a conceptual model."),(0,o.kt)("li",{parentName:"ul"},"Understanding and defining relations are essential for ensuring a consistent and comprehensive representation of the domain.")))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4a325adb.316ea1c7.js b/assets/js/4a325adb.2d4273c6.js similarity index 99% rename from assets/js/4a325adb.316ea1c7.js rename to assets/js/4a325adb.2d4273c6.js index 417542b6c..9858fce95 100644 --- a/assets/js/4a325adb.316ea1c7.js +++ b/assets/js/4a325adb.2d4273c6.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9487],{3905:(e,t,a)=>{a.d(t,{Zo:()=>p,kt:()=>f});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=r.createContext({}),l=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(a),f=o,h=m["".concat(c,".").concat(f)]||m[f]||d[f]||n;return a?r.createElement(h,i(i({ref:t},p),{},{components:a})):r.createElement(h,i({ref:t},p))}));function f(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,i=new Array(n);i[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,i[1]=s;for(var l=2;l{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>f,frontMatter:()=>i,mark:()=>d,metadata:()=>c,toc:()=>p});var r=a(3117),o=(a(7294),a(3905)),n=a(4996);const i={id:"hrdt",sidebar_label:"HR Dictionary Generation",date:20220801},s="Human Readable Dictionary Generation Tool",c={unversionedId:"specs/tools-envisaged/hrdt",id:"specs/tools-envisaged/hrdt",title:"Human Readable Dictionary Generation Tool",description:"{let{children:t}=e;return(0,o.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},m={toc:p,mark:d};function f(e){let{components:t,...a}=e;return(0,o.kt)("wrapper",(0,r.Z)({},m,a,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"human-readable-dictionary-generation-tool"},"Human Readable Dictionary Generation Tool"),(0,o.kt)("img",{alt:"This page is under construction",src:(0,n.Z)("images/wip/wip-under-construction.png")}),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("p",null,"The ",(0,o.kt)("strong",{parentName:"p"},"Human Readable Dictionary generation Tool (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrdt",title:"Human Readable Dictionary Tool: a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs)."},"HRDT"),")")," generates a Human Readable ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"Dictionary")," (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"HRD"),"), that renders the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"machine readable dictionary (MRD)")," into one of several formats, e.g. HTML, or PDF. This rendering may be subject to further processing by third-party rendering tools, such as ",(0,o.kt)("a",{parentName:"p",href:"https://pages.github.com/"},"github pages")," or ",(0,o.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/docs-introduction"},"Docusaurus"),", etc. (see also: ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"Using the Tools"),")."),(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"HRDs")," can be created for different purposes, e.g. to",(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"compare ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," between different ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", which helps e.g. when aligning ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," between them."),(0,o.kt)("li",{parentName:"ul"},"provide an overview of what various ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," utilize specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," for (education).")),(0,o.kt)("p",null,"And there's certainly going to be more such purposes."),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"Before this tool can really be properly specified, it may help to do some experiments to see what is really needed in order to keep it as simple as possible, and only then start proper specifications.")))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9487],{3905:(e,t,a)=>{a.d(t,{Zo:()=>p,kt:()=>f});var r=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function n(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=r.createContext({}),l=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var a=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(a),f=o,h=m["".concat(c,".").concat(f)]||m[f]||d[f]||n;return a?r.createElement(h,i(i({ref:t},p),{},{components:a})):r.createElement(h,i({ref:t},p))}));function f(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=a.length,i=new Array(n);i[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,i[1]=s;for(var l=2;l{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>f,frontMatter:()=>i,mark:()=>d,metadata:()=>c,toc:()=>p});var r=a(3117),o=(a(7294),a(3905)),n=a(4996);const i={id:"hrdt",sidebar_label:"HR Dictionary Generation",date:20220801},s="Human Readable Dictionary Generation Tool",c={unversionedId:"specs/tools-envisaged/hrdt",id:"specs/tools-envisaged/hrdt",title:"Human Readable Dictionary Generation Tool",description:"{let{children:t}=e;return(0,o.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},m={toc:p,mark:d};function f(e){let{components:t,...a}=e;return(0,o.kt)("wrapper",(0,r.Z)({},m,a,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"human-readable-dictionary-generation-tool"},"Human Readable Dictionary Generation Tool"),(0,o.kt)("img",{alt:"This page is under construction",src:(0,n.Z)("images/wip/wip-under-construction.png")}),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("p",null,"The ",(0,o.kt)("strong",{parentName:"p"},"Human Readable Dictionary generation Tool (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrdt",title:"Human Readable Dictionary Tool: a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs)."},"HRDT"),")")," generates a Human Readable ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"Dictionary")," (",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"HRD"),"), that renders the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"machine readable dictionary (MRD)")," into one of several formats, e.g. HTML, or PDF. This rendering may be subject to further processing by third-party rendering tools, such as ",(0,o.kt)("a",{parentName:"p",href:"https://pages.github.com/"},"github pages")," or ",(0,o.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/docs-introduction"},"Docusaurus"),", etc. (see also: ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"Using the Tools"),")."),(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"HRDs")," can be created for different purposes, e.g. to",(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"compare ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," between different ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", which helps e.g. when aligning ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," between them."),(0,o.kt)("li",{parentName:"ul"},"provide an overview of what various ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," utilize specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," for (education).")),(0,o.kt)("p",null,"And there's certainly going to be more such purposes."),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"Before this tool can really be properly specified, it may help to do some experiments to see what is really needed in order to keep it as simple as possible, and only then start proper specifications.")))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4cd795c8.295daa9c.js b/assets/js/4cd795c8.ca08eaf2.js similarity index 99% rename from assets/js/4cd795c8.295daa9c.js rename to assets/js/4cd795c8.ca08eaf2.js index 2192e7df2..65925ab7d 100644 --- a/assets/js/4cd795c8.295daa9c.js +++ b/assets/js/4cd795c8.ca08eaf2.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2766],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>p});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function r(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},m=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,r=e.originalType,c=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),u=l(i),p=o,f=u["".concat(c,".").concat(p)]||u[p]||d[p]||r;return i?a.createElement(f,n(n({ref:t},m),{},{components:i})):a.createElement(f,n({ref:t},m))}));function p(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=i.length,n=new Array(r);n[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,n[1]=s;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var a=i(3117),o=(i(7294),i(3905));i(4996);const r={id:"tev2-terminology-curation",sidebar_label:"Terminology Curation",description:"Curation is more than just pick some terms.",date:20220303},n="TEv2 - Terminology Curation",s={unversionedId:"overview/tev2-terminology-curation",id:"overview/tev2-terminology-curation",title:"TEv2 - Terminology Curation",description:"Curation is more than just pick some terms.",source:"@site/docs/overview/40-tev2-terminology-curation.md",sourceDirName:"overview",slug:"/overview/tev2-terminology-curation",permalink:"/tev2-specifications/docs/overview/tev2-terminology-curation",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/40-tev2-terminology-curation.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:40,frontMatter:{id:"tev2-terminology-curation",sidebar_label:"Terminology Curation",description:"Curation is more than just pick some terms.",date:20220303},sidebar:"tev2SideBar",previous:{title:"Text Conversions",permalink:"/tev2-specifications/docs/overview/tev2-text-conversion"},next:{title:"Backgrounds",permalink:"/tev2-specifications/docs/overview/tev2-background"}},c={},l=[],m={toc:l};function d(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"tev2---terminology-curation"},"TEv2 - Terminology Curation"),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"This section may need to be revised, and/or moved to the ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/curator-overview"},"Curators Manual"),".")),(0,o.kt)("p",null,"TEv2 assumes that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," data resides in an existing ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory"),", and that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files")," are expected to be processable by other tools, including, but not limited to ",(0,o.kt)("a",{parentName:"p",href:"https://pages.github.com/"},"github pages")," or ",(0,o.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/docs-introduction"},"Docusaurus"),", which are static site generators for web sites that document all sorts of guidance, specifications, etc. Such a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," must be ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/tev2-installation"},"set up")," in advance."),(0,o.kt)("p",null,"Thus, whenever a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," decided that some contribution is to be included in the part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus")," that is maintained by that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community"),", the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community")," are tasked to"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"create/maintain/update any ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"-related administration in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," that is needed for curation, as specified by a ",(0,o.kt)("a",{parentName:"li",href:"docs/specs/files/saf"},"Scope Administration File (SAF)"),";"),(0,o.kt)("li",{parentName:"ol"},"convert that contribution to (a set of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files"),", that comply with the ",(0,o.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"specifications")," for such files;"),(0,o.kt)("li",{parentName:"ol"},"store them at the location as designated in the ",(0,o.kt)("a",{parentName:"li",href:"docs/specs/files/saf"},"SAF"),";"),(0,o.kt)("li",{parentName:"ol"},"generate/update any artifact that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community")," wants to automatically maintain, which in particular includes the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," and associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,o.kt)("p",null,"This document provides an overview of the knowledge that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," may need to perform this task, which can be broken up in the following parts:"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("p",{parentName:"li"},(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/tev2-installation"},"Setup/installation")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," that is suitable for working with TEv2, and the creation of a ",(0,o.kt)("a",{parentName:"p",href:"docs/specs/files/saf"},"SAF"),".")),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"Curation")," of terminological contributions. This requires knowledge about the [file structure](/docs/specs/files/curated-text-file) of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated file"),"."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("p",{parentName:"li"},"Generation of documentation (artifacts). It is typical for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," to want to have a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of the terms they either have defined themselves, or are defined elsewhere but are to be used within that ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),". However, other artifacts may be generated as well (a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary"),", white papers, etc.) - this is all up to the ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."))))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2766],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>p});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function r(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function n(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},m=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},u=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,r=e.originalType,c=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),u=l(i),p=o,f=u["".concat(c,".").concat(p)]||u[p]||d[p]||r;return i?a.createElement(f,n(n({ref:t},m),{},{components:i})):a.createElement(f,n({ref:t},m))}));function p(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=i.length,n=new Array(r);n[0]=u;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,n[1]=s;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var a=i(3117),o=(i(7294),i(3905));i(4996);const r={id:"tev2-terminology-curation",sidebar_label:"Terminology Curation",description:"Curation is more than just pick some terms.",date:20220303},n="TEv2 - Terminology Curation",s={unversionedId:"overview/tev2-terminology-curation",id:"overview/tev2-terminology-curation",title:"TEv2 - Terminology Curation",description:"Curation is more than just pick some terms.",source:"@site/docs/overview/40-tev2-terminology-curation.md",sourceDirName:"overview",slug:"/overview/tev2-terminology-curation",permalink:"/tev2-specifications/docs/overview/tev2-terminology-curation",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/40-tev2-terminology-curation.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:40,frontMatter:{id:"tev2-terminology-curation",sidebar_label:"Terminology Curation",description:"Curation is more than just pick some terms.",date:20220303},sidebar:"tev2SideBar",previous:{title:"Text Conversions",permalink:"/tev2-specifications/docs/overview/tev2-text-conversion"},next:{title:"Backgrounds",permalink:"/tev2-specifications/docs/overview/tev2-background"}},c={},l=[],m={toc:l};function d(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"tev2---terminology-curation"},"TEv2 - Terminology Curation"),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"This section may need to be revised, and/or moved to the ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/curator-overview"},"Curators Manual"),".")),(0,o.kt)("p",null,"TEv2 assumes that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," data resides in an existing ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory"),", and that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files")," are expected to be processable by other tools, including, but not limited to ",(0,o.kt)("a",{parentName:"p",href:"https://pages.github.com/"},"github pages")," or ",(0,o.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/docs-introduction"},"Docusaurus"),", which are static site generators for web sites that document all sorts of guidance, specifications, etc. Such a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," must be ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/tev2-installation"},"set up")," in advance."),(0,o.kt)("p",null,"Thus, whenever a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," decided that some contribution is to be included in the part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus")," that is maintained by that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community"),", the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community")," are tasked to"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"create/maintain/update any ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"-related administration in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," that is needed for curation, as specified by a ",(0,o.kt)("a",{parentName:"li",href:"docs/specs/files/saf"},"Scope Administration File (SAF)"),";"),(0,o.kt)("li",{parentName:"ol"},"convert that contribution to (a set of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files"),", that comply with the ",(0,o.kt)("a",{parentName:"li",href:"/docs/specs/files/curated-text-file"},"specifications")," for such files;"),(0,o.kt)("li",{parentName:"ol"},"store them at the location as designated in the ",(0,o.kt)("a",{parentName:"li",href:"docs/specs/files/saf"},"SAF"),";"),(0,o.kt)("li",{parentName:"ol"},"generate/update any artifact that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"community")," wants to automatically maintain, which in particular includes the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," and associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,o.kt)("p",null,"This document provides an overview of the knowledge that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," may need to perform this task, which can be broken up in the following parts:"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("p",{parentName:"li"},(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/tev2-installation"},"Setup/installation")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scope directory")," that is suitable for working with TEv2, and the creation of a ",(0,o.kt)("a",{parentName:"p",href:"docs/specs/files/saf"},"SAF"),".")),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"Curation")," of terminological contributions. This requires knowledge about the [file structure](/docs/specs/files/curated-text-file) of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated file"),"."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("p",{parentName:"li"},"Generation of documentation (artifacts). It is typical for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms community")," to want to have a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of the terms they either have defined themselves, or are defined elsewhere but are to be used within that ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),". However, other artifacts may be generated as well (a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary"),", white papers, etc.) - this is all up to the ",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."))))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4e095fca.beef019a.js b/assets/js/4e095fca.3b183cf0.js similarity index 99% rename from assets/js/4e095fca.beef019a.js rename to assets/js/4e095fca.3b183cf0.js index ac1250ae2..f79d61c06 100644 --- a/assets/js/4e095fca.beef019a.js +++ b/assets/js/4e095fca.3b183cf0.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5516],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>l});var a=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function r(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function s(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},h=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var i=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,h=o(e,["components","mdxType","originalType","parentName"]),f=m(i),l=n,p=f["".concat(c,".").concat(l)]||f[l]||d[l]||r;return i?a.createElement(p,s(s({ref:t},h),{},{components:i})):a.createElement(p,s({ref:t},h))}));function l(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=i.length,s=new Array(r);s[0]=f;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,s[1]=o;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>r,metadata:()=>o,toc:()=>m});var a=i(3117),n=(i(7294),i(3905));const r={id:"synonym",displayed_sidebar:"tev2SideBar",term:"synonym",termType:"concept",isa:"term",glossaryTerm:"Synonym (of a [term](@))",glossaryText:"a [term](@) that has the same (or sufficiently similar) meaning as another [term](@) (i.e., the [term](@) of which it is a [synonym](@).",grouptags:[],formPhrases:["synonym{ss}"],status:"proposed",created:20221127,updated:20221127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Synonym",o={unversionedId:"terms/synonym",id:"terms/synonym",title:"Synonym",description:"Summary",source:"@site/docs/terms/synonym.md",sourceDirName:"terms",slug:"/terms/synonym",permalink:"/tev2-specifications/docs/terms/synonym",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/synonym.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"synonym",displayed_sidebar:"tev2SideBar",term:"synonym",termType:"concept",isa:"term",glossaryTerm:"Synonym (of a [term](@))",glossaryText:"a [term](@) that has the same (or sufficiently similar) meaning as another [term](@) (i.e., the [term](@) of which it is a [synonym](@).",grouptags:[],formPhrases:["synonym{ss}"],status:"proposed",created:20221127,updated:20221127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:2},{value:"Purpose",id:"purpose",level:2},{value:"The synonymOf field",id:"synonym-of",level:2},{value:"How Synonyms Work in TEv2",id:"synonym-processing",level:3}],h={toc:m};function d(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"synonym"},"Synonym"),(0,n.kt)("h2",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"synonym")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,n.kt)("p",null,"While from a theoretical point of view a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," are identical, in practice they are more 'equivalent', i.e. while they have the same meaning, when using one or the other in a sentence, there is often one term that is preferred over the other."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"Within the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", the ability to ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"define")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," for a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is needed so that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," can be made better readable without taking away control over the structure of an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," entry."),(0,n.kt)("h2",{id:"synonym-of"},"The ",(0,n.kt)("inlineCode",{parentName:"h2"},"synonymOf")," field"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," have an (optional) `synonymOf`-field in their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers"),". The contents of that field must be the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," that can be dereferenced from the current ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (or associated ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),") for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is being documented is a synonym.",(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Do we want to change the requirement that the contents of the field be a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," into a requirement that it should be a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),"?")),(0,n.kt)("h3",{id:"synonym-processing"},"How Synonyms Work in TEv2"),(0,n.kt)("p",null,"Consider a ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym"),", i.e., a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"synonymOf")," field that contains a dereferenceable ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier"),". Let's say that the ",(0,n.kt)("inlineCode",{parentName:"p"},"original")," is what the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym")," is a synonym of. Here's how we construct an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," for the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym")," (assuming that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the original exists:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"Creating a copy of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("inlineCode",{parentName:"li"},"original"),"."),(0,n.kt)("li",{parentName:"ol"},"Copy all fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of the ",(0,n.kt)("inlineCode",{parentName:"li"},"synonym")," into that copy, overwriting fields that already exist."),(0,n.kt)("li",{parentName:"ol"},"Add all required ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," fields as usual, possibly (again) overwriting fields that already exist.")),(0,n.kt)("p",null,"This way of working allows ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to tailor specific fields, such as the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary texts")," field, or the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," fields for the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5516],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>l});var a=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function r(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function s(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},h=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var i=e.components,n=e.mdxType,r=e.originalType,c=e.parentName,h=o(e,["components","mdxType","originalType","parentName"]),f=m(i),l=n,p=f["".concat(c,".").concat(l)]||f[l]||d[l]||r;return i?a.createElement(p,s(s({ref:t},h),{},{components:i})):a.createElement(p,s({ref:t},h))}));function l(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=i.length,s=new Array(r);s[0]=f;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,s[1]=o;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>r,metadata:()=>o,toc:()=>m});var a=i(3117),n=(i(7294),i(3905));const r={id:"synonym",displayed_sidebar:"tev2SideBar",term:"synonym",termType:"concept",isa:"term",glossaryTerm:"Synonym (of a [term](@))",glossaryText:"a [term](@) that has the same (or sufficiently similar) meaning as another [term](@) (i.e., the [term](@) of which it is a [synonym](@).",grouptags:[],formPhrases:["synonym{ss}"],status:"proposed",created:20221127,updated:20221127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Synonym",o={unversionedId:"terms/synonym",id:"terms/synonym",title:"Synonym",description:"Summary",source:"@site/docs/terms/synonym.md",sourceDirName:"terms",slug:"/terms/synonym",permalink:"/tev2-specifications/docs/terms/synonym",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/synonym.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"synonym",displayed_sidebar:"tev2SideBar",term:"synonym",termType:"concept",isa:"term",glossaryTerm:"Synonym (of a [term](@))",glossaryText:"a [term](@) that has the same (or sufficiently similar) meaning as another [term](@) (i.e., the [term](@) of which it is a [synonym](@).",grouptags:[],formPhrases:["synonym{ss}"],status:"proposed",created:20221127,updated:20221127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:2},{value:"Purpose",id:"purpose",level:2},{value:"The synonymOf field",id:"synonym-of",level:2},{value:"How Synonyms Work in TEv2",id:"synonym-processing",level:3}],h={toc:m};function d(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"synonym"},"Synonym"),(0,n.kt)("h2",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"synonym")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,n.kt)("p",null,"While from a theoretical point of view a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and its ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," are identical, in practice they are more 'equivalent', i.e. while they have the same meaning, when using one or the other in a sentence, there is often one term that is preferred over the other."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"Within the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", the ability to ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"define")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," for a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is needed so that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," can be made better readable without taking away control over the structure of an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," entry."),(0,n.kt)("h2",{id:"synonym-of"},"The ",(0,n.kt)("inlineCode",{parentName:"h2"},"synonymOf")," field"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated texts")," have an (optional) `synonymOf`-field in their ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers"),". The contents of that field must be the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," that can be dereferenced from the current ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (or associated ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),") for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is being documented is a synonym.",(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"Do we want to change the requirement that the contents of the field be a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," into a requirement that it should be a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),"?")),(0,n.kt)("h3",{id:"synonym-processing"},"How Synonyms Work in TEv2"),(0,n.kt)("p",null,"Consider a ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym"),", i.e., a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that has a ",(0,n.kt)("inlineCode",{parentName:"p"},"synonymOf")," field that contains a dereferenceable ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier"),". Let's say that the ",(0,n.kt)("inlineCode",{parentName:"p"},"original")," is what the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym")," is a synonym of. Here's how we construct an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," for the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym")," (assuming that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the original exists:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"Creating a copy of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("inlineCode",{parentName:"li"},"original"),"."),(0,n.kt)("li",{parentName:"ol"},"Copy all fields in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of the ",(0,n.kt)("inlineCode",{parentName:"li"},"synonym")," into that copy, overwriting fields that already exist."),(0,n.kt)("li",{parentName:"ol"},"Add all required ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," fields as usual, possibly (again) overwriting fields that already exist.")),(0,n.kt)("p",null,"This way of working allows ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to tailor specific fields, such as the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary texts")," field, or the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," fields for the ",(0,n.kt)("inlineCode",{parentName:"p"},"synonym"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4f2db7e1.bb55741d.js b/assets/js/4f2db7e1.dc637d1d.js similarity index 98% rename from assets/js/4f2db7e1.bb55741d.js rename to assets/js/4f2db7e1.dc637d1d.js index 1fdc6e72d..8015fdb40 100644 --- a/assets/js/4f2db7e1.bb55741d.js +++ b/assets/js/4f2db7e1.dc637d1d.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2739],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function o(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,i=e.originalType,c=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),m=l(r),f=a,d=m["".concat(c,".").concat(f)]||m[f]||p[f]||i;return r?n.createElement(d,o(o({ref:t},u),{},{components:r})):n.createElement(d,o({ref:t},u))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=r.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),i=r(3438),o=r(9960),s=r(3919),c=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",p="cardDescription_PWke";function m(e){let{href:t,children:r}=e;return n.createElement(o.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:i,description:o}=e;return n.createElement(m,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:i},r," ",i),o&&n.createElement("p",{className:(0,a.Z)("text--truncate",p),title:o},o))}function d(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,i.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function h(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(h,e);const o=(0,i.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},o.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},6153:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>f,frontMatter:()=>s,metadata:()=>l,toc:()=>p});var n=r(3117),a=(r(7294),r(3905)),i=r(4996),o=r(2991);const s={id:"manuals"},c="Manuals",l={unversionedId:"categories/manuals",id:"categories/manuals",title:"Manuals",description:"{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function o(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,i=e.originalType,c=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),m=l(r),f=a,d=m["".concat(c,".").concat(f)]||m[f]||p[f]||i;return r?n.createElement(d,o(o({ref:t},u),{},{components:r})):n.createElement(d,o({ref:t},u))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=r.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),i=r(3438),o=r(9960),s=r(3919),c=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",p="cardDescription_PWke";function m(e){let{href:t,children:r}=e;return n.createElement(o.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:i,description:o}=e;return n.createElement(m,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:i},r," ",i),o&&n.createElement("p",{className:(0,a.Z)("text--truncate",p),title:o},o))}function d(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,c.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,i.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function h(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(h,e);const o=(0,i.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},o.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},6153:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>f,frontMatter:()=>s,metadata:()=>l,toc:()=>p});var n=r(3117),a=(r(7294),r(3905)),i=r(4996),o=r(2991);const s={id:"manuals"},c="Manuals",l={unversionedId:"categories/manuals",id:"categories/manuals",title:"Manuals",description:"{r.d(t,{Zo:()=>l,kt:()=>f});var o=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=o.createContext({}),d=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},l=function(e){var t=d(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var r=e.components,a=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=d(r),f=a,u=m["".concat(c,".").concat(f)]||m[f]||p[f]||n;return r?o.createElement(u,i(i({ref:t},l),{},{components:r})):o.createElement(u,i({ref:t},l))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=r.length,i=new Array(n);i[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>p,frontMatter:()=>n,metadata:()=>s,toc:()=>d});var o=r(3117),a=(r(7294),r(3905));const n={id:"mrdt",displayed_sidebar:"tev2SideBar",term:"mrdt",termType:"concept",isa:null,glossaryTerm:"Machine Readable Dictionary Tool",glossaryAbbr:"MRDT",glossaryText:"a software tool designed to create, manage, and process [Machine Readable Dictionaries (MRDs)](mrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["machine-readable-dictionary-tool{ss}","mrd-tool{ss}","mrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="MRDT - Machine Readable Dictionary Tool",s={unversionedId:"terms/mrdt",id:"terms/mrdt",title:"MRDT - Machine Readable Dictionary Tool",description:"MRDT stands for Machine Readable Dictionary Tool. It refers to a software tool designed to create, manage, and process Machine Readable Dictionaries (MRDs).",source:"@site/docs/terms/mrdt.md",sourceDirName:"terms",slug:"/terms/mrdt",permalink:"/tev2-specifications/docs/terms/mrdt",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrdt.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrdt",displayed_sidebar:"tev2SideBar",term:"mrdt",termType:"concept",isa:null,glossaryTerm:"Machine Readable Dictionary Tool",glossaryAbbr:"MRDT",glossaryText:"a software tool designed to create, manage, and process [Machine Readable Dictionaries (MRDs)](mrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["machine-readable-dictionary-tool{ss}","mrd-tool{ss}","mrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],l={toc:d};function p(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"mrdt---machine-readable-dictionary-tool"},"MRDT - Machine Readable Dictionary Tool"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"MRDT")," stands for ",(0,a.kt)("strong",{parentName:"p"},"Machine Readable Dictionary Tool"),". It refers to a software tool designed to create, manage, and process ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," specifications (will) have a ",(0,a.kt)("a",{parentName:"p",href:"/docs/specs/tools-envisaged/mrdt"},"MRDT specification")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4172],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>f});var o=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=o.createContext({}),d=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},l=function(e){var t=d(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var r=e.components,a=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=d(r),f=a,u=m["".concat(c,".").concat(f)]||m[f]||p[f]||n;return r?o.createElement(u,i(i({ref:t},l),{},{components:r})):o.createElement(u,i({ref:t},l))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=r.length,i=new Array(n);i[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>p,frontMatter:()=>n,metadata:()=>s,toc:()=>d});var o=r(3117),a=(r(7294),r(3905));const n={id:"mrdt",displayed_sidebar:"tev2SideBar",term:"mrdt",termType:"concept",isa:null,glossaryTerm:"Machine Readable Dictionary Tool",glossaryAbbr:"MRDT",glossaryText:"a software tool designed to create, manage, and process [Machine Readable Dictionaries (MRDs)](mrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["machine-readable-dictionary-tool{ss}","mrd-tool{ss}","mrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="MRDT - Machine Readable Dictionary Tool",s={unversionedId:"terms/mrdt",id:"terms/mrdt",title:"MRDT - Machine Readable Dictionary Tool",description:"MRDT stands for Machine Readable Dictionary Tool. It refers to a software tool designed to create, manage, and process Machine Readable Dictionaries (MRDs).",source:"@site/docs/terms/mrdt.md",sourceDirName:"terms",slug:"/terms/mrdt",permalink:"/tev2-specifications/docs/terms/mrdt",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrdt.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrdt",displayed_sidebar:"tev2SideBar",term:"mrdt",termType:"concept",isa:null,glossaryTerm:"Machine Readable Dictionary Tool",glossaryAbbr:"MRDT",glossaryText:"a software tool designed to create, manage, and process [Machine Readable Dictionaries (MRDs)](mrd@).",grouptags:["tools","dictionary-tools"],formPhrases:["machine-readable-dictionary-tool{ss}","mrd-tool{ss}","mrdt{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],l={toc:d};function p(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"mrdt---machine-readable-dictionary-tool"},"MRDT - Machine Readable Dictionary Tool"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"MRDT")," stands for ",(0,a.kt)("strong",{parentName:"p"},"Machine Readable Dictionary Tool"),". It refers to a software tool designed to create, manage, and process ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," specifications (will) have a ",(0,a.kt)("a",{parentName:"p",href:"/docs/specs/tools-envisaged/mrdt"},"MRDT specification")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5049cc12.4df7985c.js b/assets/js/5049cc12.56107c43.js similarity index 99% rename from assets/js/5049cc12.4df7985c.js rename to assets/js/5049cc12.56107c43.js index d835948d9..f06308ec9 100644 --- a/assets/js/5049cc12.4df7985c.js +++ b/assets/js/5049cc12.56107c43.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4207],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>d});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},m=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,n=e.originalType,c=e.parentName,m=o(e,["components","mdxType","originalType","parentName"]),l=h(i),d=s,f=l["".concat(c,".").concat(d)]||l[d]||p[d]||n;return i?a.createElement(f,r(r({ref:t},m),{},{components:i})):a.createElement(f,r({ref:t},m))}));function d(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=i.length,r=new Array(n);r[0]=l;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:s,r[1]=o;for(var h=2;h{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>p,frontMatter:()=>n,metadata:()=>o,toc:()=>h});var a=i(3117),s=(i(7294),i(3905));const n={id:"term",displayed_sidebar:"tev2SideBar",term:"term",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"a word or phrase (i.e.: text) that is used to represent [concepts](semantic-unit@).",glossaryNotes:["a term is ambiguous if it represents more than one [concept](semantic-unit@).","a term that is used in a particular [scope](@) (which we call a [scoped term](@)) should not be ambiguous.","a term that is unambiguous can be made part of a [definition](@) by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."],grouptags:[],formPhrases:["term{ss}","word{ss}","phrase{ss}"],status:"proposed",created:20220606,updated:20220809,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Term",o={unversionedId:"terms/term",id:"terms/term",title:"Term",description:"Summary",source:"@site/docs/terms/term.md",sourceDirName:"terms",slug:"/terms/term",permalink:"/tev2-specifications/docs/terms/term",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/term.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"term",displayed_sidebar:"tev2SideBar",term:"term",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"a word or phrase (i.e.: text) that is used to represent [concepts](semantic-unit@).",glossaryNotes:["a term is ambiguous if it represents more than one [concept](semantic-unit@).","a term that is used in a particular [scope](@) (which we call a [scoped term](@)) should not be ambiguous.","a term that is unambiguous can be made part of a [definition](@) by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."],grouptags:[],formPhrases:["term{ss}","word{ss}","phrase{ss}"],status:"proposed",created:20220606,updated:20220809,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Notes",id:"notes",level:3},{value:"Footnotes",id:"footnotes",level:3}],m={toc:h};function p(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"term"},"Term"),(0,s.kt)("h3",{id:"summary"},"Summary"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Term")," is a word or phrase (i.e.: text) that is used to represent (identify) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", e.g. a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model"),", in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),":"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may (and typically does) have different meanings (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantics",title:"Semantics: a mapping between the (tangible/textual) Terms and (intangible) ideas/Concepts - their meaning."},"semantics"),") in different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"/contexts. For example, in the context of a beauty-salon, the term 'nail' has a different meaning than in the context of constructing buildings."),(0,s.kt)("li",{parentName:"ul"},"different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (in the same, or different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"/contexts) may have the same meaning (i.e. represent the same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (",(0,s.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Synonym"},"synonymity"),", ",(0,s.kt)("a",{parentName:"li",href:"https://www.merriam-webster.com/dictionary/alias"},"alias"),").")),(0,s.kt)("p",null,"The precise meaning of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," thus depends on the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context in which it is used. We use the phrase ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," to refer to a term that is part of one particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context, and refers to a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and hence is unambiguous."),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"Terms")," may come in different (grammatical) forms. For example, words/phrases such as 'terms', 'term's', or 'term(s)' are different forms of the word 'term'. Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", words/phrases that are such different forms are called '",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),". They can be specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," to which they (and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," they are varieties of) refer.",(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-refs"},"syntax specification")," specifies the syntax that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," should use as they want to use a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in their text."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("p",null,"Understanding words or phrases uttered by others requires that we are able to 'translate' them into terms that we habitually use, i.e. with the meaning of which we are familiar. While this is mostly an (unconscious) automatism, and it is often also not necessary to be very precise, this may be different when they relate to stuff we find important. The ability to represent a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),") with a specific text or phrase, where this 'representation' is limited to a specific (or several) context(s), helps us to better interpret these words, which is: to properly understand what others actually try to convey in spoken or written language."),(0,s.kt)("h3",{id:"criteria"},"Criteria"),(0,s.kt)("p",null,"A term is a word or phrase (i.e.: text) that is used in at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context, in each of which it represents (and identifies)) one specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is part of the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owns")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("p",null,"There is an important ",(0,s.kt)("a",{parentName:"p",href:"https://simple.wikipedia.org/wiki/Concept"},"distinction")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") and the (multitude of) terms (names, labels) that we need to be able to talk and reason (argue) about them. Please consider that"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are used in different contexts for representing a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),";"),(0,s.kt)("li",{parentName:"ul"},"in different contexts, a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may represent different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),";"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{parentName:"li",href:"http://resolver.tudelft.nl/uuid:964a90da-da81-4d38-9f45-84f3f5fa96b3"},"to resolve terminological disputes"),", which usually are about the 'correct' meaning of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"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.")),(0,s.kt)("hr",null),(0,s.kt)("h3",{id:"footnotes"},"Footnotes"))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4207],{3905:(e,t,i)=>{i.d(t,{Zo:()=>m,kt:()=>d});var a=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=a.createContext({}),h=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},m=function(e){var t=h(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var i=e.components,s=e.mdxType,n=e.originalType,c=e.parentName,m=o(e,["components","mdxType","originalType","parentName"]),l=h(i),d=s,f=l["".concat(c,".").concat(d)]||l[d]||p[d]||n;return i?a.createElement(f,r(r({ref:t},m),{},{components:i})):a.createElement(f,r({ref:t},m))}));function d(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=i.length,r=new Array(n);r[0]=l;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:s,r[1]=o;for(var h=2;h{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>p,frontMatter:()=>n,metadata:()=>o,toc:()=>h});var a=i(3117),s=(i(7294),i(3905));const n={id:"term",displayed_sidebar:"tev2SideBar",term:"term",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"a word or phrase (i.e.: text) that is used to represent [concepts](semantic-unit@).",glossaryNotes:["a term is ambiguous if it represents more than one [concept](semantic-unit@).","a term that is used in a particular [scope](@) (which we call a [scoped term](@)) should not be ambiguous.","a term that is unambiguous can be made part of a [definition](@) by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."],grouptags:[],formPhrases:["term{ss}","word{ss}","phrase{ss}"],status:"proposed",created:20220606,updated:20220809,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Term",o={unversionedId:"terms/term",id:"terms/term",title:"Term",description:"Summary",source:"@site/docs/terms/term.md",sourceDirName:"terms",slug:"/terms/term",permalink:"/tev2-specifications/docs/terms/term",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/term.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"term",displayed_sidebar:"tev2SideBar",term:"term",termType:"concept",isa:"identifier",glossaryTerm:null,glossaryText:"a word or phrase (i.e.: text) that is used to represent [concepts](semantic-unit@).",glossaryNotes:["a term is ambiguous if it represents more than one [concept](semantic-unit@).","a term that is used in a particular [scope](@) (which we call a [scoped term](@)) should not be ambiguous.","a term that is unambiguous can be made part of a [definition](@) by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."],grouptags:[],formPhrases:["term{ss}","word{ss}","phrase{ss}"],status:"proposed",created:20220606,updated:20220809,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Notes",id:"notes",level:3},{value:"Footnotes",id:"footnotes",level:3}],m={toc:h};function p(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,a.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"term"},"Term"),(0,s.kt)("h3",{id:"summary"},"Summary"),(0,s.kt)("p",null,"A ",(0,s.kt)("strong",{parentName:"p"},"Term")," is a word or phrase (i.e.: text) that is used to represent (identify) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", e.g. a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model"),", in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),":"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may (and typically does) have different meanings (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantics",title:"Semantics: a mapping between the (tangible/textual) Terms and (intangible) ideas/Concepts - their meaning."},"semantics"),") in different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"/contexts. For example, in the context of a beauty-salon, the term 'nail' has a different meaning than in the context of constructing buildings."),(0,s.kt)("li",{parentName:"ul"},"different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (in the same, or different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"/contexts) may have the same meaning (i.e. represent the same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (",(0,s.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Synonym"},"synonymity"),", ",(0,s.kt)("a",{parentName:"li",href:"https://www.merriam-webster.com/dictionary/alias"},"alias"),").")),(0,s.kt)("p",null,"The precise meaning of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," thus depends on the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context in which it is used. We use the phrase ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term")," to refer to a term that is part of one particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context, and refers to a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and hence is unambiguous."),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"Terms")," may come in different (grammatical) forms. For example, words/phrases such as 'terms', 'term's', or 'term(s)' are different forms of the word 'term'. Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", words/phrases that are such different forms are called '",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),". They can be specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," to which they (and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," they are varieties of) refer.",(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-refs"},"syntax specification")," specifies the syntax that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," should use as they want to use a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in their text."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("p",null,"Understanding words or phrases uttered by others requires that we are able to 'translate' them into terms that we habitually use, i.e. with the meaning of which we are familiar. While this is mostly an (unconscious) automatism, and it is often also not necessary to be very precise, this may be different when they relate to stuff we find important. The ability to represent a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),") with a specific text or phrase, where this 'representation' is limited to a specific (or several) context(s), helps us to better interpret these words, which is: to properly understand what others actually try to convey in spoken or written language."),(0,s.kt)("h3",{id:"criteria"},"Criteria"),(0,s.kt)("p",null,"A term is a word or phrase (i.e.: text) that is used in at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context, in each of which it represents (and identifies)) one specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is part of the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owns")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("p",null,"There is an important ",(0,s.kt)("a",{parentName:"p",href:"https://simple.wikipedia.org/wiki/Concept"},"distinction")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") and the (multitude of) terms (names, labels) that we need to be able to talk and reason (argue) about them. Please consider that"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are used in different contexts for representing a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),";"),(0,s.kt)("li",{parentName:"ul"},"in different contexts, a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may represent different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),";"),(0,s.kt)("li",{parentName:"ul"},(0,s.kt)("a",{parentName:"li",href:"http://resolver.tudelft.nl/uuid:964a90da-da81-4d38-9f45-84f3f5fa96b3"},"to resolve terminological disputes"),", which usually are about the 'correct' meaning of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"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.")),(0,s.kt)("hr",null),(0,s.kt)("h3",{id:"footnotes"},"Footnotes"))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5395b836.3e1baa53.js b/assets/js/5395b836.052bfdc2.js similarity index 99% rename from assets/js/5395b836.3e1baa53.js rename to assets/js/5395b836.052bfdc2.js index d4d69f739..ef7d86d18 100644 --- a/assets/js/5395b836.3e1baa53.js +++ b/assets/js/5395b836.052bfdc2.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2352],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>u});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),m=p(r),u=s,h=m["".concat(c,".").concat(u)]||m[u]||d[u]||i;return r?o.createElement(h,n(n({ref:t},l),{},{components:r})):o.createElement(h,n({ref:t},l))}));function u(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=r.length,n=new Array(i);n[0]=m;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,n[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>i,metadata:()=>a,toc:()=>p});var o=r(3117),s=(r(7294),r(3905));const i={id:"corpus",displayed_sidebar:"tev2SideBar",term:"corpus",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the documentation that describes the [knowledge](@essif-lab) around a set of [terms](@) and [concepts](@).",grouptags:[],formPhrases:["corpus","corpora","corpus-of-terminology","corpus-of-a-terminology","terminology corpus"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Corpus",a={unversionedId:"terms/corpus",id:"terms/corpus",title:"Corpus",description:"Short Description",source:"@site/docs/terms/corpus.md",sourceDirName:"terms",slug:"/terms/corpus",permalink:"/tev2-specifications/docs/terms/corpus",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/corpus.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"corpus",displayed_sidebar:"tev2SideBar",term:"corpus",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the documentation that describes the [knowledge](@essif-lab) around a set of [terms](@) and [concepts](@).",grouptags:[],formPhrases:["corpus","corpora","corpus-of-terminology","corpus-of-a-terminology","terminology corpus"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Short Description",id:"short-description",level:2},{value:"Purpose",id:"purpose",level:2},{value:"Acknowledgements",id:"acknowledgements",level:2}],l={toc:p};function d(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"corpus"},"Corpus"),(0,s.kt)("h2",{id:"short-description"},"Short Description"),(0,s.kt)("p",null,"The ",(0,s.kt)("strong",{parentName:"p"},"Corpus")," or ",(0,s.kt)("strong",{parentName:"p"},"Corpus of Terminology")," is the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". It is typically governed by conventions that are specified by a group of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms communities"),", such as ",(0,s.kt)("a",{parentName:"p",href:"https://wiki.trustoverip.org/pages/viewpage.action?pageId=65700"},"TOIP's Concepts and Terminology Working Group"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," relates this concept with other terminological ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h2",{id:"purpose"},"Purpose"),(0,s.kt)("p",null,"The purpose of having a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus")," is that it allows for the development of tools that support ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," and groups of people to better communicate, by enabling them to refer to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," whenever that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used. This is particularly beneficial when a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," can be interpreted in different ways (according to different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),")."),(0,s.kt)("p",null,"Tools that we envisage will query for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus"),", and use that e.g. to create a custom ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," document, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," appendix in a paper you write, or as a resource from which you generate pop-up balloons in a website you create."),(0,s.kt)("h2",{id:"acknowledgements"},"Acknowledgements"),(0,s.kt)("p",null,"Part of the description is taken from ",(0,s.kt)("a",{parentName:"p",href:"https://github.com/trustoverip/ctwg/wiki//corpus"},"TOIP CTWG")))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2352],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>u});var o=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},m=o.forwardRef((function(e,t){var r=e.components,s=e.mdxType,i=e.originalType,c=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),m=p(r),u=s,h=m["".concat(c,".").concat(u)]||m[u]||d[u]||i;return r?o.createElement(h,n(n({ref:t},l),{},{components:r})):o.createElement(h,n({ref:t},l))}));function u(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var i=r.length,n=new Array(i);n[0]=m;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,n[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>i,metadata:()=>a,toc:()=>p});var o=r(3117),s=(r(7294),r(3905));const i={id:"corpus",displayed_sidebar:"tev2SideBar",term:"corpus",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the documentation that describes the [knowledge](@essif-lab) around a set of [terms](@) and [concepts](@).",grouptags:[],formPhrases:["corpus","corpora","corpus-of-terminology","corpus-of-a-terminology","terminology corpus"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Corpus",a={unversionedId:"terms/corpus",id:"terms/corpus",title:"Corpus",description:"Short Description",source:"@site/docs/terms/corpus.md",sourceDirName:"terms",slug:"/terms/corpus",permalink:"/tev2-specifications/docs/terms/corpus",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/corpus.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"corpus",displayed_sidebar:"tev2SideBar",term:"corpus",termType:"concept",isa:null,glossaryTerm:null,glossaryText:"the documentation that describes the [knowledge](@essif-lab) around a set of [terms](@) and [concepts](@).",grouptags:[],formPhrases:["corpus","corpora","corpus-of-terminology","corpus-of-a-terminology","terminology corpus"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Short Description",id:"short-description",level:2},{value:"Purpose",id:"purpose",level:2},{value:"Acknowledgements",id:"acknowledgements",level:2}],l={toc:p};function d(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"corpus"},"Corpus"),(0,s.kt)("h2",{id:"short-description"},"Short Description"),(0,s.kt)("p",null,"The ",(0,s.kt)("strong",{parentName:"p"},"Corpus")," or ",(0,s.kt)("strong",{parentName:"p"},"Corpus of Terminology")," is the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". It is typically governed by conventions that are specified by a group of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms communities"),", such as ",(0,s.kt)("a",{parentName:"p",href:"https://wiki.trustoverip.org/pages/viewpage.action?pageId=65700"},"TOIP's Concepts and Terminology Working Group"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," relates this concept with other terminological ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h2",{id:"purpose"},"Purpose"),(0,s.kt)("p",null,"The purpose of having a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus")," is that it allows for the development of tools that support ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," and groups of people to better communicate, by enabling them to refer to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," whenever that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used. This is particularly beneficial when a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," can be interpreted in different ways (according to different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),")."),(0,s.kt)("p",null,"Tools that we envisage will query for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/corpus",title:"Corpus: the documentation that describes the Knowledge around a set of Terms and Concepts."},"corpus"),", and use that e.g. to create a custom ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," document, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," appendix in a paper you write, or as a resource from which you generate pop-up balloons in a website you create."),(0,s.kt)("h2",{id:"acknowledgements"},"Acknowledgements"),(0,s.kt)("p",null,"Part of the description is taken from ",(0,s.kt)("a",{parentName:"p",href:"https://github.com/trustoverip/ctwg/wiki//corpus"},"TOIP CTWG")))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/56c5a385.9e5ce3ea.js b/assets/js/56c5a385.031b75d9.js similarity index 99% rename from assets/js/56c5a385.9e5ce3ea.js rename to assets/js/56c5a385.031b75d9.js index f75b304fc..65a8e1b71 100644 --- a/assets/js/56c5a385.9e5ce3ea.js +++ b/assets/js/56c5a385.031b75d9.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6595],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>f});var r=a(7294);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function o(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,r)}return a}function i(t){for(var e=1;e=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(t);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var c=r.createContext({}),l=function(t){var e=r.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):i(i({},e),t)),a},d=function(t){var e=l(t.components);return r.createElement(c.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return r.createElement(r.Fragment,{},e)}},m=r.forwardRef((function(t,e){var a=t.components,n=t.mdxType,o=t.originalType,c=t.parentName,d=s(t,["components","mdxType","originalType","parentName"]),m=l(a),f=n,p=m["".concat(c,".").concat(f)]||m[f]||u[f]||o;return a?r.createElement(p,i(i({ref:e},d),{},{components:a})):r.createElement(p,i({ref:e},d))}));function f(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var o=a.length,i=new Array(o);i[0]=m;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:n,i[1]=s;for(var l=2;l{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>s,toc:()=>l});var r=a(3117),n=(a(7294),a(3905));const o={id:"front-matter",displayed_sidebar:"tev2SideBar",term:"front-matter",termType:"concept",isa:null,glossaryTerm:"Front Matter",glossaryText:"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",glossaryNotes:["Front matter is also commonly used by various static site generators (not just by [TEv2](@)).","The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."],status:"proposed",created:20240121,updated:20240121,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Front Matter",s={unversionedId:"terms/front-matter",id:"terms/front-matter",title:"Front Matter",description:"Front-matter is a section at the top of a file that contains YAML, TOML, or JSON-formatted metadata. This metadata can include information such as title, description, date, tags, and more. It is used in static site generators like Docusaurus, Hugo and Jekyll to add additional information to the content files, which can then be used in generating the site. The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.",source:"@site/docs/terms/front-matter.md",sourceDirName:"terms",slug:"/terms/front-matter",permalink:"/tev2-specifications/docs/terms/front-matter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/front-matter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"front-matter",displayed_sidebar:"tev2SideBar",term:"front-matter",termType:"concept",isa:null,glossaryTerm:"Front Matter",glossaryText:"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",glossaryNotes:["Front matter is also commonly used by various static site generators (not just by [TEv2](@)).","The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."],status:"proposed",created:20240121,updated:20240121,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"TEv2 use of front matter",id:"tev2-use-of-front-matter",level:2},{value:"Front matter use in static site generators",id:"front-matter-use-in-static-site-generators",level:2}],d={toc:l};function u(t){let{components:e,...a}=t;return(0,n.kt)("wrapper",(0,r.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"front-matter"},"Front Matter"),(0,n.kt)("p",null,"Front-matter is a section at the top of a file that contains YAML, TOML, or JSON-formatted metadata. This metadata can include information such as title, description, date, tags, and more. It is used in static site generators like Docusaurus, Hugo and Jekyll to add additional information to the content files, which can then be used in generating the site. The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."),(0,n.kt)("h2",{id:"tev2-use-of-front-matter"},"TEv2 use of front matter"),(0,n.kt)("p",null,"TEv2 uses front-matter for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and expects it to be in YAML format. This m akes TEv2 useable with, e.g., static site generators that also use YAML-formatted front matter."),(0,n.kt)("h2",{id:"front-matter-use-in-static-site-generators"},"Front matter use in static site generators"),(0,n.kt)("p",null,"Various static site generators use front matter to provide metadata:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/create-a-doc"},"Docusaurus, front matter")," is used to provide additional metadata for documentation pages, enhancing the management and presentation of content. It is specified at the top of Markdown files, enclosed by triple-dashed lines, and parsed as YAML. The front matter is optional, as Docusaurus can infer essential metadata automatically. However, it's beneficial for defining specific attributes like document ID (",(0,n.kt)("inlineCode",{parentName:"p"},"id"),"), title (",(0,n.kt)("inlineCode",{parentName:"p"},"title"),"), tags (",(0,n.kt)("inlineCode",{parentName:"p"},"tags"),"), and custom URL paths (",(0,n.kt)("inlineCode",{parentName:"p"},"slug"),"). This flexibility allows for rich content creation and precise control over documentation structure and presentation. Additionally, Docusaurus supports custom front matter fields, enabling developers to tailor their documentation to specific needs, making it a powerful tool for creating structured, informative, and interactive documentation sites.")),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://gohugo.io/content-management/front-matter/"},"Hugo, front-matter")," can be written in YAML, TOML, or JSON format, and it allows you to keep metadata attached to an instance of a content type. This feature provides Hugo with its strength, making it possible to manage content efficiently. For example, front-matter in Hugo can be used to define predefined variables like date, title, or draft status, or you can create custom variables according to your needs.")),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://jekyllrb.com/docs/front-matter/"},"Jekyll"),", any file containing a YAML front-matter block will be processed as a special file. The front-matter must be the first thing in the file and must be in the form of valid YAML set between triple-dashed lines. The variables defined within these lines will be available to access using Liquid tags throughout the file and any layouts or includes the page or post relies on."))),(0,n.kt)("p",null,"For more detailed information, you can visit:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://docusaurus.io/docs/create-a-doc"},"Docusaurus Front Matter Documentation"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://gohugo.io/content-management/front-matter/"},"Hugo Front Matter Documentation")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://jekyllrb.com/docs/front-matter/"},"Jekyll Front Matter Documentation"))))}u.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6595],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>f});var r=a(7294);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function o(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,r)}return a}function i(t){for(var e=1;e=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(t);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var c=r.createContext({}),l=function(t){var e=r.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):i(i({},e),t)),a},d=function(t){var e=l(t.components);return r.createElement(c.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return r.createElement(r.Fragment,{},e)}},m=r.forwardRef((function(t,e){var a=t.components,n=t.mdxType,o=t.originalType,c=t.parentName,d=s(t,["components","mdxType","originalType","parentName"]),m=l(a),f=n,p=m["".concat(c,".").concat(f)]||m[f]||u[f]||o;return a?r.createElement(p,i(i({ref:e},d),{},{components:a})):r.createElement(p,i({ref:e},d))}));function f(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var o=a.length,i=new Array(o);i[0]=m;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:n,i[1]=s;for(var l=2;l{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>s,toc:()=>l});var r=a(3117),n=(a(7294),a(3905));const o={id:"front-matter",displayed_sidebar:"tev2SideBar",term:"front-matter",termType:"concept",isa:null,glossaryTerm:"Front Matter",glossaryText:"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",glossaryNotes:["Front matter is also commonly used by various static site generators (not just by [TEv2](@)).","The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."],status:"proposed",created:20240121,updated:20240121,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Front Matter",s={unversionedId:"terms/front-matter",id:"terms/front-matter",title:"Front Matter",description:"Front-matter is a section at the top of a file that contains YAML, TOML, or JSON-formatted metadata. This metadata can include information such as title, description, date, tags, and more. It is used in static site generators like Docusaurus, Hugo and Jekyll to add additional information to the content files, which can then be used in generating the site. The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.",source:"@site/docs/terms/front-matter.md",sourceDirName:"terms",slug:"/terms/front-matter",permalink:"/tev2-specifications/docs/terms/front-matter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/front-matter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"front-matter",displayed_sidebar:"tev2SideBar",term:"front-matter",termType:"concept",isa:null,glossaryTerm:"Front Matter",glossaryText:"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",glossaryNotes:["Front matter is also commonly used by various static site generators (not just by [TEv2](@)).","The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."],status:"proposed",created:20240121,updated:20240121,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"TEv2 use of front matter",id:"tev2-use-of-front-matter",level:2},{value:"Front matter use in static site generators",id:"front-matter-use-in-static-site-generators",level:2}],d={toc:l};function u(t){let{components:e,...a}=t;return(0,n.kt)("wrapper",(0,r.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"front-matter"},"Front Matter"),(0,n.kt)("p",null,"Front-matter is a section at the top of a file that contains YAML, TOML, or JSON-formatted metadata. This metadata can include information such as title, description, date, tags, and more. It is used in static site generators like Docusaurus, Hugo and Jekyll to add additional information to the content files, which can then be used in generating the site. The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."),(0,n.kt)("h2",{id:"tev2-use-of-front-matter"},"TEv2 use of front matter"),(0,n.kt)("p",null,"TEv2 uses front-matter for the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and expects it to be in YAML format. This m akes TEv2 useable with, e.g., static site generators that also use YAML-formatted front matter."),(0,n.kt)("h2",{id:"front-matter-use-in-static-site-generators"},"Front matter use in static site generators"),(0,n.kt)("p",null,"Various static site generators use front matter to provide metadata:"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://docusaurus.io/docs/create-a-doc"},"Docusaurus, front matter")," is used to provide additional metadata for documentation pages, enhancing the management and presentation of content. It is specified at the top of Markdown files, enclosed by triple-dashed lines, and parsed as YAML. The front matter is optional, as Docusaurus can infer essential metadata automatically. However, it's beneficial for defining specific attributes like document ID (",(0,n.kt)("inlineCode",{parentName:"p"},"id"),"), title (",(0,n.kt)("inlineCode",{parentName:"p"},"title"),"), tags (",(0,n.kt)("inlineCode",{parentName:"p"},"tags"),"), and custom URL paths (",(0,n.kt)("inlineCode",{parentName:"p"},"slug"),"). This flexibility allows for rich content creation and precise control over documentation structure and presentation. Additionally, Docusaurus supports custom front matter fields, enabling developers to tailor their documentation to specific needs, making it a powerful tool for creating structured, informative, and interactive documentation sites.")),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://gohugo.io/content-management/front-matter/"},"Hugo, front-matter")," can be written in YAML, TOML, or JSON format, and it allows you to keep metadata attached to an instance of a content type. This feature provides Hugo with its strength, making it possible to manage content efficiently. For example, front-matter in Hugo can be used to define predefined variables like date, title, or draft status, or you can create custom variables according to your needs.")),(0,n.kt)("li",{parentName:"ol"},(0,n.kt)("p",{parentName:"li"},"In ",(0,n.kt)("a",{parentName:"p",href:"https://jekyllrb.com/docs/front-matter/"},"Jekyll"),", any file containing a YAML front-matter block will be processed as a special file. The front-matter must be the first thing in the file and must be in the form of valid YAML set between triple-dashed lines. The variables defined within these lines will be available to access using Liquid tags throughout the file and any layouts or includes the page or post relies on."))),(0,n.kt)("p",null,"For more detailed information, you can visit:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://docusaurus.io/docs/create-a-doc"},"Docusaurus Front Matter Documentation"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://gohugo.io/content-management/front-matter/"},"Hugo Front Matter Documentation")),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("a",{parentName:"li",href:"https://jekyllrb.com/docs/front-matter/"},"Jekyll Front Matter Documentation"))))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/573e4296.914cc493.js b/assets/js/573e4296.7a0b7671.js similarity index 99% rename from assets/js/573e4296.914cc493.js rename to assets/js/573e4296.7a0b7671.js index ade88bfa4..5849afa94 100644 --- a/assets/js/573e4296.914cc493.js +++ b/assets/js/573e4296.7a0b7671.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4492],{3905:(e,t,a)=>{a.d(t,{Zo:()=>f,kt:()=>l});var r=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function o(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=r.createContext({}),h=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},f=function(e){var t=h(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,i=e.mdxType,s=e.originalType,c=e.parentName,f=n(e,["components","mdxType","originalType","parentName"]),p=h(a),l=i,m=p["".concat(c,".").concat(l)]||p[l]||d[l]||s;return a?r.createElement(m,o(o({ref:t},f),{},{components:a})):r.createElement(m,o({ref:t},f))}));function l(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=a.length,o=new Array(s);o[0]=p;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:i,o[1]=n;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>d,frontMatter:()=>s,metadata:()=>n,toc:()=>h});var r=a(3117),i=(a(7294),a(3905));const s={id:"regularized-form-phrase",displayed_sidebar:"tev2SideBar",term:"regularized-form-phrase",termType:"concept",isa:null,glossaryTerm:"Regularized Form Phrase",glossaryText:"a [regularized text](@) that is derived from, and represents a [form phrase](@). They typically appear in the `formPhrases` field of an [MRG entry](@).",formPhrases:["regularized-formphrase{ss}","regularized-form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Regularized Form Phrase",n={unversionedId:"terms/regularized-form-phrase",id:"terms/regularized-form-phrase",title:"Regularized Form Phrase",description:"A Regularized Form Phrase is a regularized text that is derived from, and represents a form phrase. They typically appear in the formPhrases field of an MRG entry.",source:"@site/docs/terms/regularized-form-phrase.md",sourceDirName:"terms",slug:"/terms/regularized-form-phrase",permalink:"/tev2-specifications/docs/terms/regularized-form-phrase",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/regularized-form-phrase.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"regularized-form-phrase",displayed_sidebar:"tev2SideBar",term:"regularized-form-phrase",termType:"concept",isa:null,glossaryTerm:"Regularized Form Phrase",glossaryText:"a [regularized text](@) that is derived from, and represents a [form phrase](@). They typically appear in the `formPhrases` field of an [MRG entry](@).",formPhrases:["regularized-formphrase{ss}","regularized-form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Need for Regularizing Form Phrases",id:"need-for-regularizing-form-phrases",level:2},{value:"Regularizing Form Phrases",id:"regularization-process",level:2}],f={toc:h};function d(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"regularized-form-phrase"},"Regularized Form Phrase"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"Regularized Form Phrase")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,i.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,i.kt)("h2",{id:"purpose"},"Purpose"),(0,i.kt)("p",null,"The purpose of having ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," is that they"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"facilitate machine lookups of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," in an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", and"),(0,i.kt)("li",{parentName:"ol"},"can be used as part of a ",(0,i.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/#links"},"markdown link"),", particularly as a part of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," that is used in ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term refs"),".")),(0,i.kt)("h2",{id:"need-for-regularizing-form-phrases"},"Need for Regularizing Form Phrases"),(0,i.kt)("p",null,"There are two situation in which a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," needs to be converted into a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," (i.e., a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrase"),"):"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"When constructing an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". In this case, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," thjat are the elements of the ",(0,i.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," must be converted into ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," that before putting them into the ",(0,i.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". Details are given in ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#constructing-provisional-mrg",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"Constructing a Provisional MRG"),"."),(0,i.kt)("li",{parentName:"ol"},"When resolving a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref"),". In this case, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing group")," ",(0,i.kt)("inlineCode",{parentName:"li"},"term")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"showtext")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref")," are expected to be ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that need to be converted into ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," so that they can be used as search key to find the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," to which the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref")," refers.")),(0,i.kt)("h2",{id:"regularization-process"},"Regularizing Form Phrases"),(0,i.kt)("p",null,"The process of regularizing ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," is capable of handling both ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),", and texts that contain ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," (that can be considered 'shorthand' for a set of related ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),"):"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"any ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that are present are processed, thereby expanding the set of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),";"),(0,i.kt)("li",{parentName:"ol"},"the resulting texts are ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text#regularization-process",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"converted")," into a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text"))),(0,i.kt)("p",null,"The result is a (expanded) set of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that represent the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". The ",(0,i.kt)("inlineCode",{parentName:"p"},"formPhrases")," field in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is then made as an array of these ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4492],{3905:(e,t,a)=>{a.d(t,{Zo:()=>f,kt:()=>l});var r=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function o(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=r.createContext({}),h=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},f=function(e){var t=h(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,i=e.mdxType,s=e.originalType,c=e.parentName,f=n(e,["components","mdxType","originalType","parentName"]),p=h(a),l=i,m=p["".concat(c,".").concat(l)]||p[l]||d[l]||s;return a?r.createElement(m,o(o({ref:t},f),{},{components:a})):r.createElement(m,o({ref:t},f))}));function l(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=a.length,o=new Array(s);o[0]=p;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:i,o[1]=n;for(var h=2;h{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>d,frontMatter:()=>s,metadata:()=>n,toc:()=>h});var r=a(3117),i=(a(7294),a(3905));const s={id:"regularized-form-phrase",displayed_sidebar:"tev2SideBar",term:"regularized-form-phrase",termType:"concept",isa:null,glossaryTerm:"Regularized Form Phrase",glossaryText:"a [regularized text](@) that is derived from, and represents a [form phrase](@). They typically appear in the `formPhrases` field of an [MRG entry](@).",formPhrases:["regularized-formphrase{ss}","regularized-form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Regularized Form Phrase",n={unversionedId:"terms/regularized-form-phrase",id:"terms/regularized-form-phrase",title:"Regularized Form Phrase",description:"A Regularized Form Phrase is a regularized text that is derived from, and represents a form phrase. They typically appear in the formPhrases field of an MRG entry.",source:"@site/docs/terms/regularized-form-phrase.md",sourceDirName:"terms",slug:"/terms/regularized-form-phrase",permalink:"/tev2-specifications/docs/terms/regularized-form-phrase",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/regularized-form-phrase.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"regularized-form-phrase",displayed_sidebar:"tev2SideBar",term:"regularized-form-phrase",termType:"concept",isa:null,glossaryTerm:"Regularized Form Phrase",glossaryText:"a [regularized text](@) that is derived from, and represents a [form phrase](@). They typically appear in the `formPhrases` field of an [MRG entry](@).",formPhrases:["regularized-formphrase{ss}","regularized-form-phrase{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},h=[{value:"Purpose",id:"purpose",level:2},{value:"Need for Regularizing Form Phrases",id:"need-for-regularizing-form-phrases",level:2},{value:"Regularizing Form Phrases",id:"regularization-process",level:2}],f={toc:h};function d(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,r.Z)({},f,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"regularized-form-phrase"},"Regularized Form Phrase"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"Regularized Form Phrase")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,i.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,i.kt)("h2",{id:"purpose"},"Purpose"),(0,i.kt)("p",null,"The purpose of having ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," is that they"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"facilitate machine lookups of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," in an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),", and"),(0,i.kt)("li",{parentName:"ol"},"can be used as part of a ",(0,i.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/#links"},"markdown link"),", particularly as a part of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," that is used in ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term refs"),".")),(0,i.kt)("h2",{id:"need-for-regularizing-form-phrases"},"Need for Regularizing Form Phrases"),(0,i.kt)("p",null,"There are two situation in which a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase")," needs to be converted into a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," (i.e., a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrase"),"):"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"When constructing an ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," from a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". In this case, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," thjat are the elements of the ",(0,i.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," must be converted into ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," that before putting them into the ",(0,i.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),". Details are given in ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#constructing-provisional-mrg",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"Constructing a Provisional MRG"),"."),(0,i.kt)("li",{parentName:"ol"},"When resolving a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref"),". In this case, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing group")," ",(0,i.kt)("inlineCode",{parentName:"li"},"term")," or ",(0,i.kt)("inlineCode",{parentName:"li"},"showtext")," of the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref")," are expected to be ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that need to be converted into ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-form-phrase",title:"Regularized Form Phrase: a Regularized Text that is derived from, and represents a Form Phrase. They typically appear in the `formPhrases` field of an MRG Entry."},"regularized form phrases")," so that they can be used as search key to find the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," to which the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"term ref")," refers.")),(0,i.kt)("h2",{id:"regularization-process"},"Regularizing Form Phrases"),(0,i.kt)("p",null,"The process of regularizing ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," is capable of handling both ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),", and texts that contain ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," (that can be considered 'shorthand' for a set of related ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),"):"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"any ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that are present are processed, thereby expanding the set of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases"),";"),(0,i.kt)("li",{parentName:"ol"},"the resulting texts are ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text#regularization-process",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"converted")," into a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text"))),(0,i.kt)("p",null,"The result is a (expanded) set of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that represent the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". The ",(0,i.kt)("inlineCode",{parentName:"p"},"formPhrases")," field in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," is then made as an array of these ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/59f1a610.4b2c4706.js b/assets/js/59f1a610.5e901275.js similarity index 99% rename from assets/js/59f1a610.4b2c4706.js rename to assets/js/59f1a610.5e901275.js index b3ec282f0..2de82990d 100644 --- a/assets/js/59f1a610.4b2c4706.js +++ b/assets/js/59f1a610.5e901275.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7644],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>p});var a=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function o(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):o(o({},t),e)),i},h=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var i=e.components,n=e.mdxType,s=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),d=m(i),p=n,f=d["".concat(c,".").concat(p)]||d[p]||l[p]||s;return i?a.createElement(f,o(o({ref:t},h),{},{components:i})):a.createElement(f,o({ref:t},h))}));function p(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=i.length,o=new Array(s);o[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:n,o[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>l,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var a=i(3117),n=(i(7294),i(3905));const s={id:"semantic-unit",displayed_sidebar:"tev2SideBar",term:"semantic-unit",termType:"concept",isa:null,glossaryTerm:"Semantic Unit",glossaryText:"a basic building block of meaning or representation that exists within the 'mind' of a [party](@) (i.e., in its [knowledge](@essif-lab)).",glossaryNotes:["Examples include ideas, or [concepts](@), [properties](@) of [concepts](@), [relations](@) between [concepts](@), constraints over such [concepts](@) and [relations](@), etc."],grouptags:[],formPhrases:["semantic-unit{ss}"],status:"proposed",created:20220727,updated:20220727,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Semantic Unit",r={unversionedId:"terms/semantic-unit",id:"terms/semantic-unit",title:"Semantic Unit",description:"Summary",source:"@site/docs/terms/semantic-unit.md",sourceDirName:"terms",slug:"/terms/semantic-unit",permalink:"/tev2-specifications/docs/terms/semantic-unit",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/semantic-unit.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"semantic-unit",displayed_sidebar:"tev2SideBar",term:"semantic-unit",termType:"concept",isa:null,glossaryTerm:"Semantic Unit",glossaryText:"a basic building block of meaning or representation that exists within the 'mind' of a [party](@) (i.e., in its [knowledge](@essif-lab)).",glossaryNotes:["Examples include ideas, or [concepts](@), [properties](@) of [concepts](@), [relations](@) between [concepts](@), constraints over such [concepts](@) and [relations](@), etc."],grouptags:[],formPhrases:["semantic-unit{ss}"],status:"proposed",created:20220727,updated:20220727,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:2},{value:"Purpose",id:"purpose",level:2},{value:"Criteria",id:"criteria",level:2}],h={toc:m};function l(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"semantic-unit"},"Semantic Unit"),(0,n.kt)("h2",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Semantic Unit")," is a basic building block of meaning or representation that exists within the 'mind' of a ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,n.kt)("p",null,"Examples include ideas, or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,n.kt)("p",null,"In the context of cognitive science, a semantic unit represents a distinct and well-defined element of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", such as a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation"),", a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"property"),", or any other fundamental building block that contributes to the structure and understanding of a specialized domain or subject."),(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"Parties")," use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," to refer to such building blocks, and as such they are relevant to know about in the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation"),". Also, ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," can be grouped into ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),".",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"Parties")," may create a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," by associating the criterion with the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that it uses to determine what is, and what is not, an instance (or example) of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),".",(0,n.kt)("p",null,"Within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," can be ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"defined")," in, and described by ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that belong to a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". They can be clustered to form ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", for which ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," (both ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") can be generated"),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"Semantic units")," exist because they are somehow relevant for realizing ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has this ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". Since ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," rarely realize their ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," all by themselves, they will need to find ways to communicate them (their meanings) to other ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and/or ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actors")," that work for/with them, such that the lot of them have something we might call a 'common understanding'. To realize this 'common understanding', the ",(0,n.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of (the ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," that contains) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," must actively (consciously) understand and distinguish between each of them, specify names (",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),") that represent them, and create and maintain ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and perhaps other stuff.",(0,n.kt)("h2",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Semantic unit")," is something that can be thought of as a basic building block of meaning or representation that exists within the 'mind' of a ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),"). Typically, ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," have (at least) one ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that they use to refer to that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7644],{3905:(e,t,i)=>{i.d(t,{Zo:()=>h,kt:()=>p});var a=i(7294);function n(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function o(e){for(var t=1;t=0||(n[i]=e[i]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(n[i]=e[i])}return n}var c=a.createContext({}),m=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):o(o({},t),e)),i},h=function(e){var t=m(e.components);return a.createElement(c.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var i=e.components,n=e.mdxType,s=e.originalType,c=e.parentName,h=r(e,["components","mdxType","originalType","parentName"]),d=m(i),p=n,f=d["".concat(c,".").concat(p)]||d[p]||l[p]||s;return i?a.createElement(f,o(o({ref:t},h),{},{components:i})):a.createElement(f,o({ref:t},h))}));function p(e,t){var i=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=i.length,o=new Array(s);o[0]=d;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:n,o[1]=r;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>l,frontMatter:()=>s,metadata:()=>r,toc:()=>m});var a=i(3117),n=(i(7294),i(3905));const s={id:"semantic-unit",displayed_sidebar:"tev2SideBar",term:"semantic-unit",termType:"concept",isa:null,glossaryTerm:"Semantic Unit",glossaryText:"a basic building block of meaning or representation that exists within the 'mind' of a [party](@) (i.e., in its [knowledge](@essif-lab)).",glossaryNotes:["Examples include ideas, or [concepts](@), [properties](@) of [concepts](@), [relations](@) between [concepts](@), constraints over such [concepts](@) and [relations](@), etc."],grouptags:[],formPhrases:["semantic-unit{ss}"],status:"proposed",created:20220727,updated:20220727,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Semantic Unit",r={unversionedId:"terms/semantic-unit",id:"terms/semantic-unit",title:"Semantic Unit",description:"Summary",source:"@site/docs/terms/semantic-unit.md",sourceDirName:"terms",slug:"/terms/semantic-unit",permalink:"/tev2-specifications/docs/terms/semantic-unit",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/semantic-unit.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"semantic-unit",displayed_sidebar:"tev2SideBar",term:"semantic-unit",termType:"concept",isa:null,glossaryTerm:"Semantic Unit",glossaryText:"a basic building block of meaning or representation that exists within the 'mind' of a [party](@) (i.e., in its [knowledge](@essif-lab)).",glossaryNotes:["Examples include ideas, or [concepts](@), [properties](@) of [concepts](@), [relations](@) between [concepts](@), constraints over such [concepts](@) and [relations](@), etc."],grouptags:[],formPhrases:["semantic-unit{ss}"],status:"proposed",created:20220727,updated:20220727,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Summary",id:"summary",level:2},{value:"Purpose",id:"purpose",level:2},{value:"Criteria",id:"criteria",level:2}],h={toc:m};function l(e){let{components:t,...i}=e;return(0,n.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"semantic-unit"},"Semantic Unit"),(0,n.kt)("h2",{id:"summary"},"Summary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Semantic Unit")," is a basic building block of meaning or representation that exists within the 'mind' of a ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,n.kt)("p",null,"Examples include ideas, or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,n.kt)("p",null,"In the context of cognitive science, a semantic unit represents a distinct and well-defined element of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", such as a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relation"),", a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"property"),", or any other fundamental building block that contributes to the structure and understanding of a specialized domain or subject."),(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"Parties")," use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," to refer to such building blocks, and as such they are relevant to know about in the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation"),". Also, ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," can be grouped into ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),".",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"Parties")," may create a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," by associating the criterion with the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that it uses to determine what is, and what is not, an instance (or example) of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),".",(0,n.kt)("p",null,"Within ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," can be ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/define",title:"Define: to provide a criterion and a Term, where the criterion can be used by people to determine whether or not something is an instance/example of a Concept (or other Semantic Unit), and the Term is used to refer to that Concept, or an arbitrary instance thereof."},"defined")," in, and described by ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that belong to a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". They can be clustered to form ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", for which ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," (both ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") can be generated"),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"Semantic units")," exist because they are somehow relevant for realizing ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has this ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),". Since ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," rarely realize their ",(0,n.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," all by themselves, they will need to find ways to communicate them (their meanings) to other ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and/or ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actors")," that work for/with them, such that the lot of them have something we might call a 'common understanding'. To realize this 'common understanding', the ",(0,n.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of (the ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," that contains) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," must actively (consciously) understand and distinguish between each of them, specify names (",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),") that represent them, and create and maintain ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and perhaps other stuff.",(0,n.kt)("h2",{id:"criteria"},"Criteria"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Semantic unit")," is something that can be thought of as a basic building block of meaning or representation that exists within the 'mind' of a ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,n.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),"). Typically, ",(0,n.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," have (at least) one ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that they use to refer to that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5a2bb67b.6f8bb325.js b/assets/js/5a2bb67b.8e293003.js similarity index 99% rename from assets/js/5a2bb67b.6f8bb325.js rename to assets/js/5a2bb67b.8e293003.js index 43e69862a..64d89d873 100644 --- a/assets/js/5a2bb67b.6f8bb325.js +++ b/assets/js/5a2bb67b.8e293003.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9381],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>u});var i=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function n(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=i.createContext({}),m=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):n(n({},t),e)),a},l=function(e){var t=m(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var a=e.components,o=e.mdxType,r=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=m(a),u=o,f=d["".concat(c,".").concat(u)]||d[u]||h[u]||r;return a?i.createElement(f,n(n({ref:t},l),{},{components:a})):i.createElement(f,n({ref:t},l))}));function u(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=a.length,n=new Array(r);n[0]=d;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,n[1]=s;for(var m=2;m{a.r(t),a.d(t,{assets:()=>m,contentTitle:()=>s,default:()=>d,frontMatter:()=>n,metadata:()=>c,toc:()=>l});var i=a(3117),o=(a(7294),a(3905)),r=a(4996);const n={id:"curator-overview",sidebar_label:"Curator Overview",date:20220513},s="Curators Manual - Overview",c={unversionedId:"manuals/curator/curator-overview",id:"manuals/curator/curator-overview",title:"Curators Manual - Overview",description:"{a.d(t,{Zo:()=>l,kt:()=>u});var i=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function n(e){for(var t=1;t=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var c=i.createContext({}),m=function(e){var t=i.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):n(n({},t),e)),a},l=function(e){var t=m(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var a=e.components,o=e.mdxType,r=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=m(a),u=o,f=d["".concat(c,".").concat(u)]||d[u]||h[u]||r;return a?i.createElement(f,n(n({ref:t},l),{},{components:a})):i.createElement(f,n({ref:t},l))}));function u(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=a.length,n=new Array(r);n[0]=d;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,n[1]=s;for(var m=2;m{a.r(t),a.d(t,{assets:()=>m,contentTitle:()=>s,default:()=>d,frontMatter:()=>n,metadata:()=>c,toc:()=>l});var i=a(3117),o=(a(7294),a(3905)),r=a(4996);const n={id:"curator-overview",sidebar_label:"Curator Overview",date:20220513},s="Curators Manual - Overview",c={unversionedId:"manuals/curator/curator-overview",id:"manuals/curator/curator-overview",title:"Curators Manual - Overview",description:"{a.d(e,{Zo:()=>l,kt:()=>p});var i=a(7294);function s(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function r(t){for(var e=1;e=0||(s[a]=t[a]);return s}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(s[a]=t[a])}return s}var c=i.createContext({}),h=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):r(r({},e),t)),a},l=function(t){var e=h(t.components);return i.createElement(c.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},m=i.forwardRef((function(t,e){var a=t.components,s=t.mdxType,n=t.originalType,c=t.parentName,l=o(t,["components","mdxType","originalType","parentName"]),m=h(a),p=s,f=m["".concat(c,".").concat(p)]||m[p]||d[p]||n;return a?i.createElement(f,r(r({ref:e},l),{},{components:a})):i.createElement(f,r({ref:e},l))}));function p(t,e){var a=arguments,s=e&&e.mdxType;if("string"==typeof t||s){var n=a.length,r=new Array(n);r[0]=m;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:s,r[1]=o;for(var h=2;h{a.d(e,{Z:()=>r});var i=a(7294),s=a(6010);const n="tabItem_Ymn6";function r(t){let{children:e,hidden:a,className:r}=t;return i.createElement("div",{role:"tabpanel",className:(0,s.Z)(n,r),hidden:a},e)}},4866:(t,e,a)=>{a.d(e,{Z:()=>x});var i=a(3117),s=a(7294),n=a(6010),r=a(2466),o=a(6775),c=a(1980),h=a(7392),l=a(12);function d(t){return function(t){return s.Children.map(t,(t=>{if(!t||(0,s.isValidElement)(t)&&function(t){const{props:e}=t;return!!e&&"object"==typeof e&&"value"in e}(t))return t;throw new Error(`Docusaurus error: Bad child <${"string"==typeof t.type?t.type:t.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(t).map((t=>{let{props:{value:e,label:a,attributes:i,default:s}}=t;return{value:e,label:a,attributes:i,default:s}}))}function m(t){const{values:e,children:a}=t;return(0,s.useMemo)((()=>{const t=e??d(a);return function(t){const e=(0,h.l)(t,((t,e)=>t.value===e.value));if(e.length>0)throw new Error(`Docusaurus error: Duplicate values "${e.map((t=>t.value)).join(", ")}" found in . Every value needs to be unique.`)}(t),t}),[e,a])}function p(t){let{value:e,tabValues:a}=t;return a.some((t=>t.value===e))}function f(t){let{queryString:e=!1,groupId:a}=t;const i=(0,o.k6)(),n=function(t){let{queryString:e=!1,groupId:a}=t;if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:e,groupId:a});return[(0,c._X)(n),(0,s.useCallback)((t=>{if(!n)return;const e=new URLSearchParams(i.location.search);e.set(n,t),i.replace({...i.location,search:e.toString()})}),[n,i])]}function u(t){const{defaultValue:e,queryString:a=!1,groupId:i}=t,n=m(t),[r,o]=(0,s.useState)((()=>function(t){let{defaultValue:e,tabValues:a}=t;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(e){if(!p({value:e,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${a.map((t=>t.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}const i=a.find((t=>t.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:e,tabValues:n}))),[c,h]=f({queryString:a,groupId:i}),[d,u]=function(t){let{groupId:e}=t;const a=function(t){return t?`docusaurus.tab.${t}`:null}(e),[i,n]=(0,l.Nk)(a);return[i,(0,s.useCallback)((t=>{a&&n.set(t)}),[a,n])]}({groupId:i}),g=(()=>{const t=c??d;return p({value:t,tabValues:n})?t:null})();(0,s.useLayoutEffect)((()=>{g&&o(g)}),[g]);return{selectedValue:r,selectValue:(0,s.useCallback)((t=>{if(!p({value:t,tabValues:n}))throw new Error(`Can't select invalid tab value=${t}`);o(t),h(t),u(t)}),[h,u,n]),tabValues:n}}var g=a(2389);const k="tabList__CuJ",v="tabItem_LNqP";function b(t){let{className:e,block:a,selectedValue:o,selectValue:c,tabValues:h}=t;const l=[],{blockElementScrollPositionUntilNextRender:d}=(0,r.o5)(),m=t=>{const e=t.currentTarget,a=l.indexOf(e),i=h[a].value;i!==o&&(d(e),c(i))},p=t=>{let e=null;switch(t.key){case"Enter":m(t);break;case"ArrowRight":{const a=l.indexOf(t.currentTarget)+1;e=l[a]??l[0];break}case"ArrowLeft":{const a=l.indexOf(t.currentTarget)-1;e=l[a]??l[l.length-1];break}}e?.focus()};return s.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,n.Z)("tabs",{"tabs--block":a},e)},h.map((t=>{let{value:e,label:a,attributes:r}=t;return s.createElement("li",(0,i.Z)({role:"tab",tabIndex:o===e?0:-1,"aria-selected":o===e,key:e,ref:t=>l.push(t),onKeyDown:p,onClick:m},r,{className:(0,n.Z)("tabs__item",v,r?.className,{"tabs__item--active":o===e})}),a??e)})))}function y(t){let{lazy:e,children:a,selectedValue:i}=t;const n=(Array.isArray(a)?a:[a]).filter(Boolean);if(e){const t=n.find((t=>t.props.value===i));return t?(0,s.cloneElement)(t,{className:"margin-top--md"}):null}return s.createElement("div",{className:"margin-top--md"},n.map(((t,e)=>(0,s.cloneElement)(t,{key:e,hidden:t.props.value!==i}))))}function w(t){const e=u(t);return s.createElement("div",{className:(0,n.Z)("tabs-container",k)},s.createElement(b,(0,i.Z)({},t,e)),s.createElement(y,(0,i.Z)({},t,e)))}function x(t){const e=(0,g.Z)();return s.createElement(w,(0,i.Z)({key:String(e)},t))}},2300:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>l,contentTitle:()=>c,default:()=>p,frontMatter:()=>o,metadata:()=>h,toc:()=>d});var i=a(3117),s=(a(7294),a(3905)),n=(a(4996),a(4866)),r=a(5162);const o={id:"tev2-glossaries-demo",toc_min_heading_level:6,toc_max_heading_level:6,date:20231205},c="Glossary Generation Demo",h={unversionedId:"tev2-glossaries-demo",id:"tev2-glossaries-demo",title:"Glossary Generation Demo",description:"This page is evidence that an HRG can be generated for every MRG that is available within the scope. It also shows that HRGs can be generated in different formats.",source:"@site/docs/tev2-glossaries-demo.md",sourceDirName:".",slug:"/tev2-glossaries-demo",permalink:"/tev2-specifications/docs/tev2-glossaries-demo",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/tev2-glossaries-demo.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-glossaries-demo",toc_min_heading_level:6,toc_max_heading_level:6,date:20231205},sidebar:"tev2SideBar",previous:{title:"Glossary",permalink:"/tev2-specifications/docs/tev2-glossary"},next:{title:"Miscellaneous",permalink:"/tev2-specifications/docs/categories/miscellaneous"}},l={},d=[{value:"Action",id:"action",level:2},{value:"Actor",id:"actor",level:2},{value:"Author",id:"author",level:2},{value:"Body File",id:"body-file",level:2},{value:"Notes",id:"notes",level:3},{value:"Body (of a Curated Text)",id:"body-of-a-curated-text",level:2},{value:"Notes",id:"notes-1",level:3},{value:"Community",id:"community",level:2},{value:"Concept",id:"concept",level:2},{value:"Conceptualization",id:"conceptualization",level:2},{value:"Converter Profile",id:"converter-profile",level:2},{value:"Notes",id:"notes-2",level:3},{value:"Converter",id:"converter",level:2},{value:"Notes",id:"notes-3",level:3},{value:"Corpus",id:"corpus",level:2},{value:"Curate",id:"curate",level:2},{value:"Curated File",id:"curated-file",level:2},{value:"Curated Text File",id:"curated-text-file",level:2},{value:"Curated Text",id:"curated-text",level:2},{value:"Curatedir",id:"curatedir",level:2},{value:"Curator (of a Scope)",id:"curator-of-a-scope",level:2},{value:"Current Scope",id:"current-scope",level:2},{value:"Define",id:"define",level:2},{value:"Definition",id:"definition",level:2},{value:"Definition Pattern",id:"definition-pattern",level:2},{value:"Dictionary",id:"dictionary",level:2},{value:"Entity",id:"entity",level:2},{value:"Macro Map",id:"macro-map",level:2},{value:"Form Phrase Macro Map",id:"form-phrase-macro-map",level:2},{value:"Notes",id:"notes-4",level:3},{value:"Form Phrase Macro",id:"form-phrase-macro",level:2},{value:"Form Phrase (for a Semantic Unit)",id:"form-phrase-for-a-semantic-unit",level:2},{value:"Notes",id:"notes-5",level:3},{value:"Formatted Text",id:"formatted-text",level:2},{value:"Front Matter",id:"front-matter",level:2},{value:"Notes",id:"notes-6",level:3},{value:"Glossary",id:"glossary",level:2},{value:"Glossarydir",id:"glossarydir",level:2},{value:"Glossary Term",id:"glossary-term",level:2},{value:"Notes",id:"notes-7",level:3},{value:"Glossary Text",id:"glossary-text",level:2},{value:"Notes",id:"notes-8",level:3},{value:"Grouptag",id:"grouptag",level:2},{value:"Handlebars Helper Function",id:"handlebars-helper-function",level:2},{value:"Notes",id:"notes-9",level:3},{value:"Handlebars Object",id:"handlebars-object",level:2},{value:"Notes",id:"notes-10",level:3},{value:"Handlebars Template",id:"handlebars-template",level:2},{value:"Notes",id:"notes-11",level:3},{value:"Header (of a Curated Text)",id:"header-of-a-curated-text",level:2},{value:"Notes",id:"notes-12",level:3},{value:"HRD",id:"hrd",level:2},{value:"Human Readable Dictionary",id:"human-readable-dictionary",level:2},{value:"HRDT",id:"hrdt",level:2},{value:"Human Readable Dictionary Tool",id:"human-readable-dictionary-tool",level:2},{value:"HRG Entry",id:"hrg-entry",level:2},{value:"HRG List",id:"hrg-list",level:2},{value:"HRG",id:"hrg",level:2},{value:"Human Readable Glossary",id:"human-readable-glossary",level:2},{value:"HRGT",id:"hrgt",level:2},{value:"Human Readable Glossary Tool",id:"human-readable-glossary-tool",level:2},{value:"ICT",id:"ict",level:2},{value:"Integrity Checker Tool",id:"integrity-checker-tool",level:2},{value:"Ingestion Profile",id:"ingestion-profile",level:2},{value:"Ingestion (Process)",id:"ingestion-process",level:2},{value:"Interpreter Profile",id:"interpreter-profile",level:2},{value:"Interpreter",id:"interpreter",level:2},{value:"Legal Entity",id:"legal-entity",level:2},{value:"Mental Model",id:"mental-model",level:2},{value:"Moustache Variable",id:"moustache-variable",level:2},{value:"MRD",id:"mrd",level:2},{value:"Machine Readable Dictionary",id:"machine-readable-dictionary",level:2},{value:"MRDT",id:"mrdt",level:2},{value:"Machine Readable Dictionary Tool",id:"machine-readable-dictionary-tool",level:2},{value:"MRG Entry",id:"mrg-entry",level:2},{value:"MRG Import (Tool)",id:"mrg-import-tool",level:2},{value:"MRGRef",id:"mrgref",level:2},{value:"MRG",id:"mrg",level:2},{value:"Machine Readable Glossary",id:"machine-readable-glossary",level:2},{value:"MRGT",id:"mrgt",level:2},{value:"Machine Readable Glossary Tool",id:"machine-readable-glossary-tool",level:2},{value:"Notes",id:"notes-13",level:3},{value:"Named Capturing Group",id:"named-capturing-group",level:2},{value:"Navpath",id:"navpath",level:2},{value:"Notes",id:"notes-14",level:3},{value:"Organization",id:"organization",level:2},{value:"Party",id:"party",level:2},{value:"Property (of a Concept)",id:"property-of-a-concept",level:2},{value:"Provisional MRG Entry",id:"provisional-mrg-entry",level:2},{value:"Provisional MRG",id:"provisional-mrg",level:2},{value:"Reader",id:"reader",level:2},{value:"Regex",id:"regex",level:2},{value:"Regular Expression",id:"regular-expression",level:2},{value:"Notes",id:"notes-15",level:3},{value:"Regularized Form Phrase",id:"regularized-form-phrase",level:2},{value:"Regularized Text",id:"regularized-text",level:2},{value:"Notes",id:"notes-16",level:3},{value:"Relation (between Concepts)",id:"relation-between-concepts",level:2},{value:"Notes",id:"notes-17",level:3},{value:"Renderable Ref",id:"renderable-ref",level:2},{value:"SAF",id:"saf",level:2},{value:"Scope Administration File",id:"scope-administration-file",level:2},{value:"Scope",id:"scope",level:2},{value:"Scoped Term",id:"scoped-term",level:2},{value:"Scopedir",id:"scopedir",level:2},{value:"Scopetag",id:"scopetag",level:2},{value:"Semantic Unit",id:"semantic-unit",level:2},{value:"Notes",id:"notes-18",level:3},{value:"Semantics",id:"semantics",level:2},{value:"Sorter",id:"sorter",level:2},{value:"Synonym (of a [term](@))",id:"synonym-of-a-term",level:2},{value:"Tag",id:"tag",level:2},{value:"Term Identifier",id:"term-identifier",level:2},{value:"Notes",id:"notes-19",level:3},{value:"TermRef",id:"termref",level:2},{value:"Term Selection Instruction",id:"term-selection-instruction",level:2},{value:"Term Type",id:"term-type",level:2},{value:"Term",id:"term",level:2},{value:"Notes",id:"notes-20",level:3},{value:"Termid",id:"termid",level:2},{value:"Terminology Identifier",id:"terminology-identifier",level:2},{value:"Notes",id:"notes-21",level:3},{value:"Terminology Process",id:"terminology-process",level:2},{value:"Terminology",id:"terminology",level:2},{value:"Terminology Pattern",id:"terminology-pattern",level:2},{value:"Terms Community",id:"terms-community",level:2},{value:"TEv2 Text Conversion Tool",id:"tev2-text-conversion-tool",level:2},{value:"TEv2 Toolbox",id:"tev2-toolbox",level:2},{value:"Notes",id:"notes-22",level:3},{value:"TEv2 Tool",id:"tev2-tool",level:2},{value:"TEv2",id:"tev2",level:2},{value:"TRRT",id:"trrt",level:2},{value:"TermRef Rendering Tool",id:"termref-rendering-tool",level:2},{value:"Use-Case",id:"use-case",level:2},{value:"Versiontag",id:"versiontag",level:2},{value:"Vocabulary",id:"vocabulary",level:2},{value:"Writer",id:"writer",level:2},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern",level:2},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern",level:2},{value:"Decision Making Pattern",id:"decision-making-pattern",level:2},{value:"Definition Pattern",id:"definition-pattern-1",level:2},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern",level:2},{value:"Governance and Management Pattern",id:"governance-and-management-pattern",level:2},{value:"Guardianship Pattern",id:"guardianship-pattern",level:2},{value:"Identification Pattern",id:"identification-pattern",level:2},{value:"Identifier Pattern",id:"identifier-pattern",level:2},{value:"Identity Pattern",id:"identity-pattern",level:2},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern",level:2},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern",level:2},{value:"Mental Model Pattern",id:"mental-model-pattern",level:2},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern",level:2},{value:"Party Representation Pattern",id:"party-representation-pattern",level:2},{value:"Semantics Pattern",id:"semantics-pattern",level:2},{value:"Terminology Pattern",id:"terminology-pattern-1",level:2},{value:"Trust Pattern",id:"trust-pattern",level:2},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model",level:2},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern-1",level:2},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern-1",level:2},{value:"Decision Making Pattern",id:"decision-making-pattern-1",level:2},{value:"Definition Pattern",id:"definition-pattern-2",level:2},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern-1",level:2},{value:"Governance and Management Pattern",id:"governance-and-management-pattern-1",level:2},{value:"Guardianship Pattern",id:"guardianship-pattern-1",level:2},{value:"Identification Pattern",id:"identification-pattern-1",level:2},{value:"Identifier Pattern",id:"identifier-pattern-1",level:2},{value:"Identity Pattern",id:"identity-pattern-1",level:2},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern-1",level:2},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern-1",level:2},{value:"Mental Model Pattern",id:"mental-model-pattern-1",level:2},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern-1",level:2},{value:"Party Representation Pattern",id:"party-representation-pattern-1",level:2},{value:"Semantics Pattern",id:"semantics-pattern-1",level:2},{value:"Terminology Pattern",id:"terminology-pattern-2",level:2},{value:"Trust Pattern",id:"trust-pattern-1",level:2},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model-1",level:2},{value:"Qualified Data",id:"qualified-data",level:3},{value:"Attribute",id:"attribute",level:3},{value:"Communication Channel",id:"communication-channel",level:3},{value:"Employee",id:"employee",level:3},{value:"Policy",id:"policy",level:3},{value:"Presentation",id:"presentation",level:3},{value:"Presentation Request",id:"presentation-request",level:3},{value:"Relation (between Concepts)",id:"relation-between-concepts-1",level:3},{value:"Terms Community",id:"terms-community-1",level:3},{value:"SSI Assurance Community (SSI-AC)",id:"ssi-assurance-community-ssi-ac",level:3},{value:"SSI Agent",id:"ssi-agent",level:3},{value:"Holder Policy",id:"holder-policy",level:3},{value:"Isuer Policy",id:"isuer-policy",level:3},{value:"Revocation Policy",id:"revocation-policy",level:3},{value:"Validator Policy",id:"validator-policy",level:3},{value:"Verifier Policy",id:"verifier-policy",level:3},{value:"Wallet Policy",id:"wallet-policy",level:3},{value:"Legal Jurisdiction",id:"legal-jurisdiction",level:3},{value:"Participant",id:"participant",level:3},{value:"Authority (Centralized or Decentralized)",id:"authority-centralized-or-decentralized",level:3},{value:"Employer",id:"employer",level:3},{value:"Peer Party",id:"peer-party",level:3},{value:"Guardian",id:"guardian",level:3},{value:"Organization",id:"organization-1",level:3},{value:"Community",id:"community-1",level:3},{value:"Governor",id:"governor",level:3},{value:"Term (Scoped)",id:"term-scoped",level:3},{value:"Transaction Proposal",id:"transaction-proposal",level:3},{value:"Semantic Unit",id:"semantic-unit-1",level:3},{value:"Identifier",id:"identifier",level:3},{value:"Guardianship-type",id:"guardianship-type",level:3},{value:"Information Process",id:"information-process",level:3},{value:"Revocation component",id:"revocation-component",level:3},{value:"Issuer",id:"issuer",level:3},{value:"Validator",id:"validator",level:3},{value:"Holder",id:"holder",level:3},{value:"Verifier",id:"verifier",level:3},{value:"Wallet",id:"wallet",level:3},{value:"Property (of a Concept)",id:"property-of-a-concept-1",level:3},{value:"Assertion",id:"assertion",level:3},{value:"Role",id:"role",level:3},{value:"Mental Model",id:"mental-model-1",level:3},{value:"Pattern",id:"pattern",level:3},{value:"Credential Catalogue",id:"credential-catalogue",level:3},{value:"Semantics",id:"semantics-1",level:3},{value:"Compliance level",id:"compliance-level",level:3},{value:"Risk level",id:"risk-level",level:3},{value:"Control level",id:"control-level",level:3},{value:"Transaction Request",id:"transaction-request",level:3},{value:"Terminology Process",id:"terminology-process-1",level:3},{value:"Human Being",id:"human-being",level:3},{value:"Risk management",id:"risk-management",level:3},{value:"Onboarding",id:"onboarding",level:3},{value:"Control Process",id:"control-process",level:3},{value:"Ownership",id:"ownership",level:3},{value:"Mandate",id:"mandate",level:3},{value:"Identity Pattern",id:"identity-pattern-2",level:3},{value:"Identifier Pattern",id:"identifier-pattern-2",level:3},{value:"Party Representation Pattern",id:"party-representation-pattern-2",level:3},{value:"Governance and Management Pattern",id:"governance-and-management-pattern-2",level:3},{value:"Decision Making Pattern",id:"decision-making-pattern-2",level:3},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern-2",level:3},{value:"Trust Pattern",id:"trust-pattern-2",level:3},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern-2",level:3},{value:"Mental Model Pattern",id:"mental-model-pattern-2",level:3},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern-2",level:3},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern-2",level:3},{value:"Identification Pattern",id:"identification-pattern-2",level:3},{value:"Semantics Pattern",id:"semantics-pattern-2",level:3},{value:"Guardianship Pattern",id:"guardianship-pattern-2",level:3},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern-2",level:3},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern-2",level:3},{value:"Terminology Pattern",id:"terminology-pattern-3",level:3},{value:"Framework (Conceptual)",id:"framework-conceptual",level:3},{value:"Ecosystem",id:"ecosystem",level:3},{value:"Normative framework",id:"normative-framework",level:3},{value:"Legal System",id:"legal-system",level:3},{value:"Definition",id:"definition-1",level:3},{value:"Communication Session",id:"communication-session",level:3},{value:"Term",id:"term-1",level:3},{value:"Partial identity",id:"partial-identity",level:3},{value:"Identify",id:"identify",level:3},{value:"Agent",id:"agent",level:3},{value:"Dependent",id:"dependent",level:3},{value:"Owned",id:"owned",level:3},{value:"Legal Entity",id:"legal-entity-1",level:3},{value:"Party",id:"party-1",level:3},{value:"Mission",id:"mission",level:3},{value:"Expectation",id:"expectation",level:3},{value:"Obligation",id:"obligation",level:3},{value:"Control Objective",id:"control-objective",level:3},{value:"Compliance Objective",id:"compliance-objective",level:3},{value:"Risk Objective",id:"risk-objective",level:3},{value:"Employment Contract",id:"employment-contract",level:3},{value:"Glossary",id:"glossary-1",level:3},{value:"Dictionary",id:"dictionary-1",level:3},{value:"Tag",id:"tag-1",level:3},{value:"Advertisement",id:"advertisement",level:3},{value:"Transaction Id",id:"transaction-id",level:3},{value:"Credential",id:"credential",level:3},{value:"Actor",id:"actor-1",level:3},{value:"Guardianship Arrangement",id:"guardianship-arrangement",level:3},{value:"Role name",id:"role-name",level:3},{value:"Self-Sovereign Identity (SSI)",id:"self-sovereign-identity-ssi",level:3},{value:"Entity",id:"entity-1",level:3},{value:"Data",id:"data",level:3},{value:"Action",id:"action-1",level:3},{value:"Objective",id:"objective",level:3},{value:"Scope: essifLabTerminology",id:"scope-essiflabterminology",level:3},{value:"SSI (Self-Sovereign Identity)",id:"ssi-self-sovereign-identity",level:3},{value:"Knowledge",id:"knowledge",level:3},{value:"Capability (of a Party)",id:"capability-of-a-party",level:3},{value:"Subject",id:"subject",level:3},{value:"Trust level",id:"trust-level",level:3},{value:"Trust",id:"trust",level:3},{value:"Governance",id:"governance",level:3},{value:"Management",id:"management",level:3},{value:"Peer Actor",id:"peer-actor",level:3},{value:"Peer-agent",id:"peer-agent",level:3},{value:"Controllership",id:"controllership",level:3},{value:"Principal",id:"principal",level:3},{value:"Risk Owner",id:"risk-owner",level:3},{value:"Validate",id:"validate",level:3},{value:"Verify",id:"verify",level:3},{value:"Revoke/Revocation",id:"revokerevocation",level:3},{value:"Self-Sovereignty",id:"self-sovereignty",level:3},{value:"Assessment Framework",id:"assessment-framework",level:3},{value:"Control",id:"control",level:3},{value:"Identity",id:"identity",level:3},{value:"Jurisdiction",id:"jurisdiction",level:3},{value:"Decision",id:"decision",level:3},{value:"Commitment Decision",id:"commitment-decision",level:3},{value:"Corpus of Terminology",id:"corpus-of-terminology",level:3},{value:"Risk",id:"risk",level:3},{value:"Transaction",id:"transaction",level:3},{value:"Scope",id:"scope-1",level:3},{value:"Scope of Control",id:"scope-of-control",level:3},{value:"Concept",id:"concept-1",level:3},{value:"Capability (of an Actor)",id:"capability-of-an-actor",level:3},{value:"Compliance management",id:"compliance-management",level:3},{value:"Documentation Interoperability",id:"documentation-interoperability",level:3},{value:"Owner",id:"owner",level:3},{value:"Controller",id:"controller",level:3},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model-2",level:3},{value:"Terminology",id:"terminology-1",level:3},{value:"Transaction Agreement",id:"transaction-agreement",level:3},{value:"Guardianship (in a Jurisdiction)",id:"guardianship-in-a-jurisdiction",level:3},{value:"Credential Type",id:"credential-type",level:3},{value:"Transaction Form",id:"transaction-form",level:3},{value:"Outsourcing",id:"outsourcing",level:3},{value:"Compliance",id:"compliance",level:3},{value:"Vocabulary",id:"vocabulary-1",level:3},{value:"SSI Infrastructure",id:"ssi-infrastructure",level:3},{value:"Delegate",id:"delegate",level:3},{value:"Define",id:"define-1",level:3},{value:"Colleague",id:"colleague",level:3},{value:"Glossary (Markdown style)",id:"glossary-markdown-style",level:2},{value:"Body File",id:"body-file-1",level:3},{value:"Notes",id:"notes-23",level:4},{value:"Body (of a Curated Text)",id:"body-of-a-curated-text-1",level:3},{value:"Notes",id:"notes-24",level:4},{value:"Converter Profile",id:"converter-profile-1",level:3},{value:"Notes",id:"notes-25",level:4},{value:"Converter",id:"converter-1",level:3},{value:"Notes",id:"notes-26",level:4},{value:"Form Phrase Macro Map",id:"form-phrase-macro-map-1",level:3},{value:"Notes",id:"notes-27",level:4},{value:"Form Phrase (for a Semantic Unit)",id:"form-phrase-for-a-semantic-unit-1",level:3},{value:"Notes",id:"notes-28",level:4},{value:"Front Matter",id:"front-matter-1",level:3},{value:"Notes",id:"notes-29",level:4},{value:"Glossary Term",id:"glossary-term-1",level:3},{value:"Notes",id:"notes-30",level:4},{value:"Glossary Text",id:"glossary-text-1",level:3},{value:"Notes",id:"notes-31",level:4},{value:"Handlebars Helper Function",id:"handlebars-helper-function-1",level:3},{value:"Notes",id:"notes-32",level:4},{value:"Handlebars Object",id:"handlebars-object-1",level:3},{value:"Notes",id:"notes-33",level:4},{value:"Handlebars Template",id:"handlebars-template-1",level:3},{value:"Notes",id:"notes-34",level:4},{value:"Header (of a Curated Text)",id:"header-of-a-curated-text-1",level:3},{value:"Notes",id:"notes-35",level:4},{value:"Machine Readable Glossary Tool",id:"machine-readable-glossary-tool-1",level:3},{value:"Notes",id:"notes-36",level:4},{value:"Notes",id:"notes-37",level:4},{value:"Regular Expression",id:"regular-expression-1",level:3},{value:"Notes",id:"notes-38",level:4},{value:"Regularized Text",id:"regularized-text-1",level:3},{value:"Notes",id:"notes-39",level:4},{value:"Relation (between Concepts)",id:"relation-between-concepts-2",level:3},{value:"Notes",id:"notes-40",level:4},{value:"Semantic Unit",id:"semantic-unit-2",level:3},{value:"Notes",id:"notes-41",level:4},{value:"Term Identifier",id:"term-identifier-1",level:3},{value:"Notes",id:"notes-42",level:4},{value:"Notes",id:"notes-43",level:4},{value:"Terminology Identifier",id:"terminology-identifier-1",level:3},{value:"Notes",id:"notes-44",level:4},{value:"TEv2 Toolbox",id:"tev2-toolbox-1",level:3},{value:"Notes",id:"notes-45",level:4},{value:"Glossary (Table style)",id:"glossary-table-style",level:2}],m={toc:d};function p(t){let{components:e,...a}=t;return(0,s.kt)("wrapper",(0,i.Z)({},m,a,{components:e,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"glossary-generation-demo"},"Glossary Generation Demo"),(0,s.kt)("p",null,"This page is evidence that an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," can be generated for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that is available within the scope. It also shows that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," can be generated in different formats."),(0,s.kt)(n.Z,{defaultValue:"default",values:[{label:"TEv2 glossary",value:"default"},{label:"Curated Terms glossary",value:"terms"},{label:"Recent changes glossary",value:"recent-changes"},{label:"Mental Model glossary",value:"patterns"},{label:"Latest eSSIF-Lab glossary",value:"latest"},{label:"Glossary and Abbrs (inline)",value:"glossary-and-abbrs"},{label:"Glossary with Notes",value:"glossary-with-notes"}],mdxType:"Tabs"},(0,s.kt)(r.Z,{value:"default",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in the format as defined in file ",(0,s.kt)("inlineCode",{parentName:"p"},"terminology-config.yaml"),", which holds the default configurations for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," within the this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="tev2"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"action"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/action"},"Action")),(0,s.kt)("p",null,"something that is actually done (a 'unit of work' that is executed) by a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (on behalf of a given ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"), as a single operation, in a specific context."),(0,s.kt)("h2",{id:"actor"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/actor"},"Actor")),(0,s.kt)("p",null,"entity that can act (do things/execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"), e.g. people, machines, but not ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization"),"."),(0,s.kt)("h2",{id:"author"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("p",null,"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("h2",{id:"body-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("p",null,"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"li"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("h2",{id:"body-of-a-curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("h3",{id:"notes-1"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),".")),(0,s.kt)("h2",{id:"community"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/community"},"Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", consisting of at least two different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") that seek to collaborate with each other so that each of them can achieve its individual ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," more efficiently and/or effectively."),(0,s.kt)("h2",{id:"concept"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("h2",{id:"conceptualization"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("p",null,"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,s.kt)("h2",{id:"converter-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("p",null,"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("h3",{id:"notes-2"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",{parentName:"ul"},"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments.")),(0,s.kt)("h2",{id:"converter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("p",null,"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("h3",{id:"notes-3"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),".")),(0,s.kt)("h2",{id:"corpus"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("p",null,"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h2",{id:"curate"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("p",null,"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"curated-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("p",null,"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"curated-text-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("p",null,"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),"."),(0,s.kt)("h2",{id:"curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("p",null,"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,s.kt)("h2",{id:"curatedir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("p",null,"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"curator-of-a-scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("p",null,"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"current-scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called."),(0,s.kt)("h2",{id:"define"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("p",null,"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("h2",{id:"definition"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("p",null,"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h2",{id:"definition-pattern"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts."),(0,s.kt)("h2",{id:"entity"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/entity"},"Entity")),(0,s.kt)("p",null,"someone or something that is known to exist."),(0,s.kt)("h2",{id:"macro-map"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Macro Map")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"Form Phrase Macro Map")),(0,s.kt)("h2",{id:"form-phrase-macro-map"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("p",null,"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("h3",{id:"notes-4"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"li"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"li"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"li",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,s.kt)("h2",{id:"form-phrase-macro"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("p",null,"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc."),(0,s.kt)("h2",{id:"form-phrase-for-a-semantic-unit"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("p",null,"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("h3",{id:"notes-5"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("h2",{id:"formatted-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("p",null,"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,s.kt)("h2",{id:"front-matter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("p",null,"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("h3",{id:"notes-6"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",{parentName:"ul"},"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.")),(0,s.kt)("h2",{id:"glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("h2",{id:"glossarydir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("p",null,"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained."),(0,s.kt)("h2",{id:"glossary-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h3",{id:"notes-7"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",{parentName:"ul"},"if the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"li"},"{{capFirst term}}"))),(0,s.kt)("h2",{id:"glossary-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h3",{id:"notes-8"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),".")),(0,s.kt)("h2",{id:"grouptag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"handlebars-helper-function"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("p",null,"a function that can be used in a ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("h3",{id:"notes-9"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences.")),(0,s.kt)("h2",{id:"handlebars-object"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("p",null,"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("h3",{id:"notes-10"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"))),(0,s.kt)("h2",{id:"handlebars-template"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("p",null,"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("h3",{id:"notes-11"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates.")),(0,s.kt)("h2",{id:"header-of-a-curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("h3",{id:"notes-12"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),".")),(0,s.kt)("h2",{id:"hrd"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrd"},"HRD")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionary")),(0,s.kt)("h2",{id:"human-readable-dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,s.kt)("h2",{id:"hrdt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrdt"},"HRDT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrdt",title:"Human Readable Dictionary Tool: a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs)."},"Human Readable Dictionary Tool")),(0,s.kt)("h2",{id:"human-readable-dictionary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,s.kt)("h2",{id:"hrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("p",null,"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("h2",{id:"hrg-list"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("p",null,"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,s.kt)("h2",{id:"hrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg"},"HRG")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossary")),(0,s.kt)("h2",{id:"human-readable-glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."),(0,s.kt)("h2",{id:"hrgt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/hrgt"},"HRGT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"Human Readable Glossary Tool")),(0,s.kt)("h2",{id:"human-readable-glossary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("h2",{id:"ict"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"ICT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools-envisaged/ict",title:"Integrity Checker Tool: a software tool designed to check the integrity and conformity of various files used in the curation and management of Glossaries, Dictionaries, Curated Texts, and other data within a terminology project. The ICT verifies that the files adhere to the TEv2 File Specifications, ensuring the consistency and accuracy of the terminology data."},"Integrity Checker Tool")),(0,s.kt)("h2",{id:"integrity-checker-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("p",null,"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data."),(0,s.kt)("h2",{id:"ingestion-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("p",null,"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h2",{id:"ingestion-process"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("p",null,"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"p",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("h2",{id:"interpreter-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),")."),(0,s.kt)("h2",{id:"interpreter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,s.kt)("h2",{id:"legal-entity"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/legal-entity"},"Legal Entity")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is known by, recognized to exist, and registered in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h2",{id:"mental-model"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."),(0,s.kt)("h2",{id:"moustache-variable"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("p",null,"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"p"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"p",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html")),(0,s.kt)("h2",{id:"mrd"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrd"},"MRD")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionary")),(0,s.kt)("h2",{id:"machine-readable-dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("p",null,"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,s.kt)("h2",{id:"mrdt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrdt"},"MRDT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrdt",title:"Machine Readable Dictionary Tool: a software tool designed to create, manage, and process Machine Readable Dictionaries (MRDs)."},"Machine Readable Dictionary Tool")),(0,s.kt)("h2",{id:"machine-readable-dictionary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,s.kt)("h2",{id:"mrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("p",null,"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("h2",{id:"mrg-import-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("p",null,"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),"."),(0,s.kt)("h2",{id:"mrgref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("p",null,"a text that is ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h2",{id:"mrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/mrg"},"MRG")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossary")),(0,s.kt)("h2",{id:"machine-readable-glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems."),(0,s.kt)("h2",{id:"mrgt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrgt"},"MRGT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"Machine Readable Glossary Tool")),(0,s.kt)("h2",{id:"machine-readable-glossary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("h3",{id:"notes-13"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("h2",{id:"named-capturing-group"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("p",null,"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern."),(0,s.kt)("h2",{id:"navpath"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("p",null,"the (name of the field in the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("h3",{id:"notes-14"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves.")),(0,s.kt)("h2",{id:"organization"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/organization"},"Organization")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is capable of setting ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," and making sure these are realized by ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that it has ",(0,s.kt)("a",{parentName:"p",href:"onboarding@"},"onboarded")," and/or by (vetted) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that are committed to contribute to these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h2",{id:"party"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/party"},"Party")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that sets its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", maintains its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and uses that ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," to pursue its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," in an autonomous (sovereign) manner. Humans and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization")," are the typical examples."),(0,s.kt)("h2",{id:"property-of-a-concept"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("p",null,"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("h2",{id:"provisional-mrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"provisional-mrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"reader"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("p",null,"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended."),(0,s.kt)("h2",{id:"regex"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regex"},"Regex")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"Regular Expression")),(0,s.kt)("h2",{id:"regular-expression"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("p",null,"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("h3",{id:"notes-15"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"li",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),".")),(0,s.kt)("h2",{id:"regularized-form-phrase"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("h2",{id:"regularized-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("p",null,"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"p"},"-")," character."),(0,s.kt)("h3",{id:"notes-16"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"li"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text.")),(0,s.kt)("h2",{id:"relation-between-concepts"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h3",{id:"notes-17"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other.")),(0,s.kt)("h2",{id:"renderable-ref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("p",null,"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("h2",{id:"saf"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/saf"},"SAF")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"Scope Administration File")),(0,s.kt)("h2",{id:"scope-administration-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("p",null,"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("h2",{id:"scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("p",null,"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"scoped-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("h2",{id:"scopedir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("p",null,"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"scopetag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")),(0,s.kt)("h2",{id:"semantic-unit"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("h3",{id:"notes-18"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc.")),(0,s.kt)("h2",{id:"semantics"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("p",null,"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning."),(0,s.kt)("h2",{id:"sorter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("p",null,"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("h2",{id:"synonym-of-a-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,s.kt)("h2",{id:"tag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("p",null,"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"term-identifier"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"notes-19"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed.")),(0,s.kt)("h2",{id:"termref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("p",null,"a word or phrase that is ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("h2",{id:"term-selection-instruction"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("p",null,"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"term-type"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"p"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"p"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"p"},"mental-model"),")."),(0,s.kt)("h2",{id:"term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("h3",{id:"notes-20"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",{parentName:"ul"},"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",{parentName:"ul"},"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term.")),(0,s.kt)("h2",{id:"termid"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("p",null,"a text of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"terminology-identifier"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"notes-21"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"li"},":")," is omitted, their values are taken be the current (or default) ones.")),(0,s.kt)("h2",{id:"terminology-process"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("p",null,"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them."),(0,s.kt)("h2",{id:"terminology"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("h2",{id:"terminology-pattern"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("h2",{id:"terms-community"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("h2",{id:"tev2-text-conversion-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("h2",{id:"tev2-toolbox"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("p",null,"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("h3",{id:"notes-22"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets.")),(0,s.kt)("h2",{id:"tev2-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("p",null,"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."),(0,s.kt)("h2",{id:"tev2"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("p",null,"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("h2",{id:"trrt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/trrt"},"TRRT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TermRef Rendering Tool")),(0,s.kt)("h2",{id:"termref-rendering-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,s.kt)("h2",{id:"use-case"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used."),(0,s.kt)("h2",{id:"versiontag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"vocabulary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("p",null,"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("h2",{id:"writer"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("p",null,"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.")),(0,s.kt)(r.Z,{value:"terms",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are curated within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". It is formatted as a ",(0,s.kt)("inlineCode",{parentName:"p"},"markdowntable"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":terms" converter="markdown-table-row"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Term"),(0,s.kt)("th",{parentName:"tr",align:null},"Definition"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same').")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("td",{parentName:"tr",align:null},"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("td",{parentName:"tr",align:null},"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("td",{parentName:"tr",align:null},"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("td",{parentName:"tr",align:null},"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("td",{parentName:"tr",align:null},"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("td",{parentName:"tr",align:null},"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("td",{parentName:"tr",align:null},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("td",{parentName:"tr",align:null},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("td",{parentName:"tr",align:null},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("td",{parentName:"tr",align:null},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("td",{parentName:"tr",align:null},"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"td",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("td",{parentName:"tr",align:null},"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"td"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"td",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html"))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.).")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("td",{parentName:"tr",align:null},"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("td",{parentName:"tr",align:null},"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("td",{parentName:"tr",align:null},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("td",{parentName:"tr",align:null},"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("td",{parentName:"tr",align:null},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("td",{parentName:"tr",align:null},"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("td",{parentName:"tr",align:null},"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("td",{parentName:"tr",align:null},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("td",{parentName:"tr",align:null},"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("td",{parentName:"tr",align:null},"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"td"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"td"},"mental-model"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("td",{parentName:"tr",align:null},"a text of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("td",{parentName:"tr",align:null},"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("td",{parentName:"tr",align:null},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("td",{parentName:"tr",align:null},"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."))))),(0,s.kt)(r.Z,{value:"recent-changes",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are curated within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". It has a custom format, and is sorted according to the date of last change, as it appears in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRGEntry"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":terms" converter="| [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}}) | {{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}} | {{updated}} |\\n" sorter="{{updated}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Term"),(0,s.kt)("th",{parentName:"tr",align:null},"Definition"),(0,s.kt)("th",{parentName:"tr",align:null},"Updated"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("td",{parentName:"tr",align:null},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("td",{parentName:"tr",align:null},"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("td",{parentName:"tr",align:null},"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("td",{parentName:"tr",align:null},"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("td",{parentName:"tr",align:null},"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."),(0,s.kt)("td",{parentName:"tr",align:null},"20220607")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("td",{parentName:"tr",align:null},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20220727")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("td",{parentName:"tr",align:null},"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220809")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("td",{parentName:"tr",align:null},"a text of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220809")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("td",{parentName:"tr",align:null},"20220811")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("td",{parentName:"tr",align:null},"20220811")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220817")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220919")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("td",{parentName:"tr",align:null},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("td",{parentName:"tr",align:null},"20221006")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20221127")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("td",{parentName:"tr",align:null},"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("td",{parentName:"tr",align:null},"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("td",{parentName:"tr",align:null},"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("td",{parentName:"tr",align:null},"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("td",{parentName:"tr",align:null},"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("td",{parentName:"tr",align:null},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("td",{parentName:"tr",align:null},"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"td",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("td",{parentName:"tr",align:null},"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("td",{parentName:"tr",align:null},"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("td",{parentName:"tr",align:null},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("td",{parentName:"tr",align:null},"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("td",{parentName:"tr",align:null},"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("td",{parentName:"tr",align:null},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"td"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"td"},"mental-model"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20230801")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230929")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231010")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231010")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231124")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231127")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("td",{parentName:"tr",align:null},"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern."),(0,s.kt)("td",{parentName:"tr",align:null},"20231220")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("td",{parentName:"tr",align:null},"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"td"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"td",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html")),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("td",{parentName:"tr",align:null},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("td",{parentName:"tr",align:null},"20240121")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used."),(0,s.kt)("td",{parentName:"tr",align:null},"20240130")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240228")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("td",{parentName:"tr",align:null},"20240301")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240316")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("td",{parentName:"tr",align:null},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240318"))))),(0,s.kt)(r.Z,{value:"patterns",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," lists the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models")," (or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns"),") that are known within this (TEv2) scope. It is formatted in a custom format (specified by a handlebars template)."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":patterns" converter="## [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n\n{{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"decentralized-grc-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h2",{id:"decentralized-risk-management-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h2",{id:"decision-making-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h2",{id:"definition-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"duties-and-rights-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"governance-and-management-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h2",{id:"guardianship-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h2",{id:"identification-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h2",{id:"identifier-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h2",{id:"identity-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h2",{id:"jurisdiction-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"mandates-delegation-and-hiring-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h2",{id:"mental-model-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h2",{id:"party-actor-and-actions-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h2",{id:"party-representation-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h2",{id:"semantics-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h2",{id:"terminology-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h2",{id:"trust-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h2",{id:"essif-lab-world-model"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking)."),(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"The same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," can be constructed from any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for each of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", simply by generating empty strings for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that do not have ",(0,s.kt)("inlineCode",{parentName:"p"},"termtype: pattern"),". To do this, we use the following ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref"),":"),(0,s.kt)("p",{parentName:"admonition"},(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":patterns" converter="{{#ifValue termType equals=\'pattern\'}}## [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n{{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n{{/ifValue}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"decentralized-grc-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h2",{id:"decentralized-risk-management-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h2",{id:"decision-making-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h2",{id:"definition-pattern-2"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"duties-and-rights-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"governance-and-management-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h2",{id:"guardianship-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h2",{id:"identification-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h2",{id:"identifier-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h2",{id:"identity-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h2",{id:"jurisdiction-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"mandates-delegation-and-hiring-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h2",{id:"mental-model-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h2",{id:"party-actor-and-actions-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h2",{id:"party-representation-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h2",{id:"semantics-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h2",{id:"terminology-pattern-2"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h2",{id:"trust-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h2",{id:"essif-lab-world-model-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking).")),(0,s.kt)(r.Z,{value:"latest",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the ",(0,s.kt)("inlineCode",{parentName:"p"},"latest")," version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that we know as ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab"),". It is formatted using ",(0,s.kt)("inlineCode",{parentName:"p"},"markdown-section-3"),"."),(0,s.kt)("p",{parentName:"admonition"},"NOTE that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are sorted by the value of their ",(0,s.kt)("inlineCode",{parentName:"p"},"glossaryText"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="essif-lab:latest" converter="### [{{#if glossaryTerm}}{{noRefs glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n\\n{{#if glossaryText}}{{noRefs glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n\\n" sorter="{{noRefs glossaryText}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h3",{id:"qualified-data"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/qualified-data"},"Qualified Data")),(0,s.kt)("p",null,(0,s.kt)("a",{parentName:"p",href:"@"},"data")," that comes with assurances, at least regarding its provenance and integrity (immutability), that make this data valid to be used for specific purposes of individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"attribute"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/attribute"},"Attribute")),(0,s.kt)("p",null,(0,s.kt)("a",{parentName:"p",href:"@"},"data"),", that represents a characteristic that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"attribute"),") has attributed to an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (which is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject")," of that attribute)."),(0,s.kt)("h3",{id:"communication-channel"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/communication-channel"},"Communication Channel")),(0,s.kt)("p",null,"a (digital or non-digital) means by which two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," can exchange messages with one another."),(0,s.kt)("h3",{id:"employee"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employee"},"Employee")),(0,s.kt)("p",null,"a (human or non-human (digital)) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," for whom/which it is realistic that it might execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"employer")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),")."),(0,s.kt)("h3",{id:"policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/policy"},"Policy")),(0,s.kt)("p",null,"a (set of) rules, working-instructions, preferences and other guidance for the execution of one or more kinds of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),", that ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governs")," the policy have access to and can interpret such that this results in these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," being executed as intended by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"presentation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/presentation"},"Presentation")),(0,s.kt)("p",null,"a (signed) digital message that a ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component may send to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component that contains data derived from one or more ",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verifiable")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," (that (a ",(0,s.kt)("a",{parentName:"p",href:"@"},"colleague")," component of) the ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component has received from ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer")," components of one or more ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"), as a response to a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"presentation request")," of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Verifier")," component."),(0,s.kt)("h3",{id:"presentation-request"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/presentation-request"},"Presentation Request")),(0,s.kt)("p",null,"a (signed) digital message that a ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component sends to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component asking for specific data from one or more ",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verifiable")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that are issued by specific Parties."),(0,s.kt)("h3",{id:"relation-between-concepts-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,s.kt)("h3",{id:"terms-community-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("h3",{id:"ssi-assurance-community-ssi-ac"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-assurance-community"},"SSI Assurance Community (SSI-AC)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that supports its members as they seek to increase their confidence in the ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI infrastructure")," and/or (specific) ",(0,s.kt)("a",{parentName:"p",href:"qualified-data@"},"qualifications")," of the data exchanged through that infrastructure."),(0,s.kt)("h3",{id:"ssi-agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-agent"},"SSI Agent")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"agent@"},"digital agent")," that provides one or more of the ",(0,s.kt)("a",{parentName:"p",href:"ssi-agent@"},"ssi functionalities")," (",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet"),") to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"holder-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/holder-policy"},"Holder Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"isuer-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/issuer-policy"},"Isuer Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"revocation-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revocation-policy"},"Revocation Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"revocation component")," to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"validator-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validator-policy"},"Validator Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"validator")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"verifier-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verifier-policy"},"Verifier Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"wallet-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/wallet-policy"},"Wallet Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"legal-jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-jurisdiction"},"Legal Jurisdiction")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that is governed/operated by a governmental body."),(0,s.kt)("h3",{id:"participant"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/participant"},"Participant")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," is negotiating (or has negotiated) a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement"),"."),(0,s.kt)("h3",{id:"authority-centralized-or-decentralized"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/authority"},"Authority (Centralized or Decentralized)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," of which certain decisions, ideas, rules etc. are followed by other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"employer"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employer"},"Employer")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," on whose behalf a (human or non-human) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (called an ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),") might execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"."),(0,s.kt)("h3",{id:"peer-party"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-party"},"Peer Party")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that also participates in that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"guardian"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardian"},"Guardian")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has been assigned rights and duties in a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Guardianship Arrangement")," for the purpose of caring for and/or protecting/guarding/defending the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependent")," in that Guardianship Arrangement."),(0,s.kt)("h3",{id:"organization-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/organization"},"Organization")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is capable of setting ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," and making sure these are realized by ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that it has ",(0,s.kt)("a",{parentName:"p",href:"onboarding@"},"onboarded")," and/or by (vetted) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that are committed to contribute to these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"community-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/community"},"Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", consisting of at least two different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") that seek to collaborate with each other so that each of them can achieve its individual ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," more efficiently and/or effectively."),(0,s.kt)("h3",{id:"governor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/governor"},"Governor")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"role")," that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (better: ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),") performs as it ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governs")," a (coherent) set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", within a particular focus."),(0,s.kt)("h3",{id:"term-scoped"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scoped-term"},"Term (Scoped)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", the meaning of which is determined by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," to which it refers in a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context."),(0,s.kt)("h3",{id:"transaction-proposal"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-proposal"},"Transaction Proposal")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," that is 'in-the-making' (ranging from an empty document to a document that would be a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," if it were signed by all ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant"),")."),(0,s.kt)("h3",{id:"semantic-unit-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),"). Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,s.kt)("h3",{id:"identifier"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identifier"},"Identifier")),(0,s.kt)("p",null,"a character string that is being used for the identification of some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (yet may refer to 0, 1, or more ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", depending on the context within which it is being used)."),(0,s.kt)("h3",{id:"guardianship-type"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-type"},"Guardianship-type")),(0,s.kt)("p",null,"a class of ",(0,s.kt)("a",{parentName:"p",href:"guardianship-arrangement@"},"guardianship arrangements")," within the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that governs and manages them."),(0,s.kt)("h3",{id:"information-process"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/information-process"},"Information Process")),(0,s.kt)("p",null,"a coherent set of ","[actions@]"," that are (to be) performed by a single ","[party@]",", in which ",(0,s.kt)("a",{parentName:"p",href:"@"},"data")," (that is controlled by this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," is created, read, updated and/or deleted."),(0,s.kt)("h3",{id:"revocation-component"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revocation-component"},"Revocation component")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to ",(0,s.kt)("a",{parentName:"p",href:"@"},"revoke")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that are issued by its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),", according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"revocation policy"),"."),(0,s.kt)("h3",{id:"issuer"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/issuer"},"Issuer")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to construct ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," from data objects, according to the content of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer"),"-Policy (specifically regarding the way in which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," is to be digitally signed), and pass it to the ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet"),"-component of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," allowing it to be issued."),(0,s.kt)("h3",{id:"validator"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validator"},"Validator")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to determine whether or not (",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verified"),") data is valid to be used for some specific purpose(s)."),(0,s.kt)("h3",{id:"holder"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/holder"},"Holder")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to handle ",(0,s.kt)("a",{parentName:"p",href:"presentation-request@"},"presentation requests")," from a ",(0,s.kt)("a",{parentName:"p",href:"@"},"peer agent"),", produce the requested data (a presentation) according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder-policy"),", and send that in response to the request."),(0,s.kt)("h3",{id:"verifier"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verifier"},"Verifier")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to request ",(0,s.kt)("a",{parentName:"p",href:"peer-agent@"},"peer agents")," to present (provide) data from credentials (of a specified kind, issued by specified ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"), and to verify such responses (check structure, signatures, dates), according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier policy"),"."),(0,s.kt)("h3",{id:"wallet"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/wallet"},"Wallet")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to securely store data as requested by ",(0,s.kt)("a",{parentName:"p",href:"colleague@"},"colleague agents"),", and to provide stored data to ",(0,s.kt)("a",{parentName:"p",href:"colleague@"},"colleague agents")," or ",(0,s.kt)("a",{parentName:"p",href:"peer-agent@"},"peer agents"),", all in ",(0,s.kt)("a",{parentName:"p",href:"@"},"compliance")," with the rules of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet policy"),"."),(0,s.kt)("h3",{id:"property-of-a-concept-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("p",null,"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("h3",{id:"assertion"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/assertion"},"Assertion")),(0,s.kt)("p",null,"a declaration/statement, made by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that something is the case."),(0,s.kt)("h3",{id:"role"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/role"},"Role")),(0,s.kt)("p",null,"a defined set of characteristics that an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," has in some context, such as ",(0,s.kt)("a",{parentName:"p",href:"obligation@"},"responsibilities")," it may have, ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (behaviors) it may execute, or pieces of ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," that it is expected to have in that context, which are referenced to by a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"role name"),"."),(0,s.kt)("h3",{id:"mental-model-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("p",null,"a description, both casual and formal, of a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (ideas), relations between them, and constraints, that together form a coherent and consistent 'viewpoint', or 'way of thinking' about a certain topic."),(0,s.kt)("h3",{id:"pattern"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern"},"Pattern")),(0,s.kt)("p",null,"a description, both casual and formal, of a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (ideas), relations between them, and constraints, that together form a coherent and consistent 'viewpoint', or 'way of thinking' about a certain topic."),(0,s.kt)("h3",{id:"credential-catalogue"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential-catalogue"},"Credential Catalogue")),(0,s.kt)("p",null,"a functional component that has the ",(0,s.kt)("a",{parentName:"p",href:"capability-of-an-actor@"},"capability")," to register and advertise the information about ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential types")," that their respective ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governing parties")," have decided to disclose so as to enable other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to decide whether or not it is beneficial for them to use ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," of such types."),(0,s.kt)("h3",{id:"semantics-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/semantics"},"Semantics")),(0,s.kt)("p",null,"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," - their meaning."),(0,s.kt)("h3",{id:"compliance-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-level"},"Compliance level")),(0,s.kt)("p",null,"a measure for stating how well an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," conforms with a stated (set of) requirement(s)."),(0,s.kt)("h3",{id:"risk-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-level"},"Risk level")),(0,s.kt)("p",null,"a measure for the deviation of the intended realization (results) of a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," uses to represent the priority with which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," of that ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," should be reckoned with."),(0,s.kt)("h3",{id:"control-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-level"},"Control level")),(0,s.kt)("p",null,"a measure for the efficiency and effectiveness in which a ",(0,s.kt)("a",{parentName:"p",href:"controller@"},"control")," produces the results specified by its ",(0,s.kt)("a",{parentName:"p",href:"@"},"control objective")),(0,s.kt)("h3",{id:"transaction-request"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-request"},"Transaction Request")),(0,s.kt)("p",null,"a message, send by a requesting ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to a providing ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that initiates the negotiation of a new ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," between these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," for the provisioning of a specific product or service."),(0,s.kt)("h3",{id:"terminology-process-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("p",null,"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," that resolve them."),(0,s.kt)("h3",{id:"human-being"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/human-being"},"Human Being")),(0,s.kt)("p",null,"a person of flesh and blood (homo sapiens), that we classify both as a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),",an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),", and a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h3",{id:"risk-management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-management"},"Risk management")),(0,s.kt)("p",null,"a process that is run by (or on behalf of) a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for the purpose of ",(0,s.kt)("a",{parentName:"p",href:"management@"},"managing")," the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," that it ",(0,s.kt)("a",{parentName:"p",href:"@"},"owns")," (thereby realizing specific ",(0,s.kt)("a",{parentName:"p",href:"risk-objective@"},"risk objectives"),")."),(0,s.kt)("h3",{id:"onboarding"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/onboarding"},"Onboarding")),(0,s.kt)("p",null,"a process that is run for a specific (set of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," on behalf of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that terminates successfully if and only if the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has (a) established the suitability of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," for executing certain kinds of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on its behalf, (b) ensured that their mutual rights and duties are properly specified and will be appropriately enforced, and (c) provided the circumstances/contexts within which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is enabled to do so."),(0,s.kt)("h3",{id:"control-process"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-process"},"Control Process")),(0,s.kt)("p",null,"a process, ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," and run by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", to ensure that a specific subset of its control ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," are realized."),(0,s.kt)("h3",{id:"ownership"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ownership"},"Ownership")),(0,s.kt)("p",null,"a relationship between two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that exists within the ",(0,s.kt)("a",{parentName:"p",href:"@"},"scope of control")," of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),", in which one of them (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") has legal, rightful or natural rights and/or duties to enjoy, dispose of, and control the other (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned"),")."),(0,s.kt)("h3",{id:"mandate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mandate"},"Mandate")),(0,s.kt)("p",null,"a right or duty that one ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"mandate@"},"mandator"),") has granted to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," or ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," (the ",(0,s.kt)("a",{parentName:"p",href:"mandate@"},"mandatee"),") for executing a specific (set of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," in the name of, and under responsibility/accountability of, this (first) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"identity-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h3",{id:"identifier-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h3",{id:"party-representation-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h3",{id:"governance-and-management-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h3",{id:"decision-making-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h3",{id:"decentralized-risk-management-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h3",{id:"trust-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h3",{id:"party-actor-and-actions-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h3",{id:"mental-model-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h3",{id:"decentralized-grc-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h3",{id:"mandates-delegation-and-hiring-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h3",{id:"identification-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h3",{id:"semantics-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h3",{id:"guardianship-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h3",{id:"jurisdiction-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h3",{id:"duties-and-rights-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h3",{id:"terminology-pattern-3"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h3",{id:"framework-conceptual"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/framework"},"Framework (Conceptual)")),(0,s.kt)("p",null,"a set of assumptions, concepts, values, and practices that constitutes a way of viewing reality."),(0,s.kt)("h3",{id:"ecosystem"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ecosystem"},"Ecosystem")),(0,s.kt)("p",null,"a set of at least two (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (its 'members') whose individual work complements that of other members, and is of benefit to the set as a whole."),(0,s.kt)("h3",{id:"normative-framework"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/normative-framework"},"Normative framework")),(0,s.kt)("p",null,"a set of rules that are followed and/or criteria that remain fulfilled by (a specific kind of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," whose behavior and/or properties are characterized as 'normal'."),(0,s.kt)("h3",{id:"legal-system"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-system"},"Legal System")),(0,s.kt)("p",null,"a system in which rules are defined, and mechanisms for their enforcement and conflict resolution are (implicitly or explicitly) specified."),(0,s.kt)("h3",{id:"definition-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/definition"},"Definition")),(0,s.kt)("p",null,"a text that helps ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about the meaning of (and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," behind) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", ideally in such a way that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can determine whether or not they make the same distinction."),(0,s.kt)("h3",{id:"communication-session"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/communication-session"},"Communication Session")),(0,s.kt)("p",null,"a time interval during which two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," have an established ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication channel")," that does not exist outside of that time interval."),(0,s.kt)("h3",{id:"term-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/term"},"Term")),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used in at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context to represent a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h3",{id:"partial-identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/partial-identity"},"Partial identity")),(0,s.kt)("p",null,"all ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," that a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (= the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the partial identity) has about that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (= the '",(0,s.kt)("a",{parentName:"p",href:"@"},"subject"),"' of the partial identity)."),(0,s.kt)("h3",{id:"identify"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identify"},"Identify")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act"),", by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that results in the selection of either"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{parentName:"li",href:"@"},"partial identity")," that the party ",(0,s.kt)("a",{parentName:"li",href:"@"},"owns"),", given some (observed or received) data, or"),(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," from a given set of entities that is the ",(0,s.kt)("a",{parentName:"li",href:"@"},"subject")," of a specified ",(0,s.kt)("a",{parentName:"li",href:"@"},"partial identity")," that the party ",(0,s.kt)("a",{parentName:"li",href:"@"},"owns"),".")),(0,s.kt)("h3",{id:"agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/agent"},"Agent")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that is executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),")."),(0,s.kt)("h3",{id:"dependent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/dependent"},"Dependent")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the caring for and/or protecting/guarding/defending of which a ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship arrangement")," has been established."),(0,s.kt)("h3",{id:"owned"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/owned"},"Owned")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," over which another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") has the power (duty, right) to enjoy it, dispose of it and control it; that power is limited to (the scope of) that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),", and by its rules."),(0,s.kt)("h3",{id:"legal-entity-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-entity"},"Legal Entity")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is known by, recognized to exist, and registered in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h3",{id:"party-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/party"},"Party")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that sets its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", maintains its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and uses that ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," to pursue its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," in an autonomous (sovereign) manner. Humans and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization")," are the typical examples."),(0,s.kt)("h3",{id:"mission"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mission"},"Mission")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that provides an answer to the question why that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," exists - i.e. its 'raison d'\xeatre'."),(0,s.kt)("h3",{id:"expectation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/expectation"},"Expectation")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that is ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for having a specific (set of) result(s) produced, where the actual production thereof is (going to be) outsourced to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"obligation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/obligation"},"Obligation")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that is ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," by the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for producing a specific (set of) result(s) that are to be used (consumed) by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," and/or other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"control-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-objective"},"Control Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to contribute to the realization of another (set of) ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", by producing results that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," needs to realize these other ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"compliance-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-objective"},"Compliance Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to reach and maintain a state of affairs in which a specific set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," controls are in accordance with a specific set of requirements (e.g., laws, regulations, standards, etc.)."),(0,s.kt)("h3",{id:"risk-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-objective"},"Risk Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to reach and maintain a state of affairs in which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," associated with a specific set of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," become, and/or remain, acceptable."),(0,s.kt)("h3",{id:"employment-contract"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employment-contract"},"Employment Contract")),(0,s.kt)("p",null,"an agreement/contract between two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", one of which controls a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject")," of the contract), that states (or refers to) all (sets of) rights and duties under which these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," can and/or must work for the other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"glossary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/glossary"},"Glossary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("h3",{id:"dictionary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," with various meanings they may have in different contexts."),(0,s.kt)("h3",{id:"tag-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/tag"},"Tag")),(0,s.kt)("p",null,"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"advertisement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/advertisement"},"Advertisement")),(0,s.kt)("p",null,"an offer by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to provide a (type of) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", where the offer includes (a reference to) the syntax and semantics specifications of that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", and also lists various other characteristics that enable other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to decide whether or not a ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that the advertising ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has issued under this offer, is ",(0,s.kt)("a",{parentName:"p",href:"validate@"},"valid")," to be processed in one or more of its ",(0,s.kt)("a",{parentName:"p",href:"information-process@"},"information processes"),"."),(0,s.kt)("h3",{id:"transaction-id"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-id"},"Transaction Id")),(0,s.kt)("p",null,"character string that this ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," uses to identify, and refer to, that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"credential"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential"},"Credential")),(0,s.kt)("p",null,"data, representing a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"assertion")," (claims, statements), authored and signed by, or on behalf of, a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"actor-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/actor"},"Actor")),(0,s.kt)("p",null,"entity that can act (do things/execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"), e.g. people, machines, but not ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization"),"."),(0,s.kt)("h3",{id:"guardianship-arrangement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-arrangement"},"Guardianship Arrangement")),(0,s.kt)("p",null,"guardianship Arrangement (in a Jurisdiction): the specification of a set of rights and duties between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that enforces these rights and duties, for the purpose of caring for and/or protecting/guarding/defending one or more of these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"entities"),"."),(0,s.kt)("h3",{id:"role-name"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/role-name"},"Role name")),(0,s.kt)("p",null,"name (text) that refers to (and identifies) a ",(0,s.kt)("a",{parentName:"p",href:"@"},"role")," in a specific context."),(0,s.kt)("h3",{id:"self-sovereign-identity-ssi"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/self-sovereign-identity"},"Self-Sovereign Identity (SSI)")),(0,s.kt)("p",null,"self-Sovereign Identity (SSI) is a term that has many different interpretations, and that we use to refer to concepts/ideas, architectures, processes and technologies that aim to support (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they negotiate and execute electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction")," with one another."),(0,s.kt)("h3",{id:"entity-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/entity"},"Entity")),(0,s.kt)("p",null,"someone or something that is known to exist."),(0,s.kt)("h3",{id:"data"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/data"},"Data")),(0,s.kt)("p",null,"something (tangible) that can be used to communicate a meaning (which is intangible/information)."),(0,s.kt)("h3",{id:"action-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/action"},"Action")),(0,s.kt)("p",null,"something that is actually done (a 'unit of work' that is executed) by a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (on behalf of a given ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"), as a single operation, in a specific context."),(0,s.kt)("h3",{id:"objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/objective"},"Objective")),(0,s.kt)("p",null,"something toward which a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") directs effort (an aim, goal, or end of action)."),(0,s.kt)("h3",{id:"scope-essiflabterminology"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/eSSIFLab-scope"},"Scope: essifLabTerminology")),(0,s.kt)("p",null,"specification of the eSSIF-Lab scope."),(0,s.kt)("h3",{id:"ssi-self-sovereign-identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi"},"SSI (Self-Sovereign Identity)")),(0,s.kt)("p",null,"sSI (Self-Sovereign Identity) is a term that has many different interpretations, and that we use to refer to concepts/ideas, architectures, processes and technologies that aim to support (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they negotiate and execute electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction")," with one another."),(0,s.kt)("h3",{id:"knowledge"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/knowledge"},"Knowledge")),(0,s.kt)("p",null,"the (intangible) sum of what is known by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", as well as the familiarity, awareness or understanding of someone or something by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"capability-of-a-party"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/capability"},"Capability (of a Party)")),(0,s.kt)("p",null,"the (named) combination of (a) the means of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to get something done, (b) the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"governance")," process that ensures that its (business) ",(0,s.kt)("a",{parentName:"p",href:"@"},"policies")," for getting that something done are being created and maintained, and (c) the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"management")," process that creates and maintains the (operational) ",(0,s.kt)("a",{parentName:"p",href:"@"},"policies"),", such that every ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," that has a task in getting this something done can find and interpret a ",(0,s.kt)("a",{parentName:"p",href:"@"},"policy")," and use it as it executes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," in such tasks."),(0,s.kt)("h3",{id:"subject"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/subject"},"Subject")),(0,s.kt)("p",null,"the (single) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," to which a given set of coherent data relates/pertains. Examples of such sets include attributes, ",(0,s.kt)("a",{parentName:"p",href:"assertion@"},"Claims/Assertions"),", files/dossiers, ",(0,s.kt)("a",{parentName:"p",href:"credential@"},"(verifiable) credentials"),", ",(0,s.kt)("a",{parentName:"p",href:"partial-identity@"},"(partial) identities"),", ",(0,s.kt)("a",{parentName:"p",href:"employment-contract@"},"employment contracts"),", etc."),(0,s.kt)("h3",{id:"trust-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/trust-level"},"Trust level")),(0,s.kt)("p",null,"the (subjective) degree of belief or confidence that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has in X (someone, something, ...)."),(0,s.kt)("h3",{id:"trust"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/trust"},"Trust")),(0,s.kt)("p",null,"the (un)conscious decision by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to believe that X is in fact the case."),(0,s.kt)("h3",{id:"governance"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/governance"},"Governance")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act")," or process of governing or overseeing the realization of (the results associated with) a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," by the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", in order to ensure they will be fit for the purposes that this ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," intends to use them for."),(0,s.kt)("h3",{id:"management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/management"},"Management")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act")," or process of managing or actually realizing of (the results associated with) a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," by the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"peer-actor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-actor"},"Peer Actor")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," with whom/which this other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is communicating in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication session"),"."),(0,s.kt)("h3",{id:"peer-agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-agent"},"Peer-agent")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," with whom/which this other ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," is communicating in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication session"),"."),(0,s.kt)("h3",{id:"controllership"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/controllership"},"Controllership")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," of an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," to execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the purpose of ensuring that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," will act/behave, or be used, in a particular way."),(0,s.kt)("h3",{id:"principal"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/principal"},"Principal")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for whom, or on behalf of whom, the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is then called an ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("h3",{id:"risk-owner"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-owner"},"Risk Owner")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," to which a ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," is associated."),(0,s.kt)("h3",{id:"validate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validate"},"Validate")),(0,s.kt)("p",null,"the act, by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", of determining whether or not that data is valid to be used for some specific purpose(s) of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"verify"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verify"},"Verify")),(0,s.kt)("p",null,"the act, by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", of determining whether that data is authentic (i.e. originates from the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that authored it), timely (i.e. has not expired), and conforms to other specifications that apply to its structure."),(0,s.kt)("h3",{id:"revokerevocation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revoke"},"Revoke/Revocation")),(0,s.kt)("p",null,"the act, by or on behalf of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has issued the ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", of no longer vouching for the correctness or any other qualification of (arbitrary parts of) that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),"."),(0,s.kt)("h3",{id:"self-sovereignty"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/self-sovereignty"},"Self-Sovereignty")),(0,s.kt)("p",null,"the characteristic of every ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that it is autonomous in managing and operating its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owns")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", particularly in making decisions and deciding how to decide."),(0,s.kt)("h3",{id:"assessment-framework"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/assessment-framework"},"Assessment Framework")),(0,s.kt)("p",null,"the combination of a set of criteria that an auditor can assess by applying them to an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (of a specific kind), and the procedures that this auditor will follow for doing so, for the purpose of establishing the extent in which that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," conforms to a stated set of requirements."),(0,s.kt)("h3",{id:"control"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control"},"Control")),(0,s.kt)("p",null,"the combination of resources (e.g. people, tools, budgets, time) and processes that are tasked to realize a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"control objective")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identity"},"Identity")),(0,s.kt)("p",null,"the combined ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," about that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," of all ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", i.e. the union of all ",(0,s.kt)("a",{parentName:"p",href:"partial-identity@"},"partial identities")," of which that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject"),"."),(0,s.kt)("h3",{id:"jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/jurisdiction"},"Jurisdiction")),(0,s.kt)("p",null,"the composition of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," (legislation, enforcement thereof, and conflict resolution), a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that governs that ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system"),", a scope within which that ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," is operational, and one or more ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," for the purpose of which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," is operated. See also the ",(0,s.kt)("a",{parentName:"p",href:"pattern:jurisdiction@"},"Jurisdictions pattern"),"."),(0,s.kt)("h3",{id:"decision"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/decision"},"Decision")),(0,s.kt)("p",null,"the conclusion that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," inferences from a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"data")," that it considers to be facts."),(0,s.kt)("h3",{id:"commitment-decision"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/commitment-decision"},"Commitment Decision")),(0,s.kt)("p",null,"the decision of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," whether or not to commit to that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),", i.e. (promise) to fulfill the ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," that the associated ",(0,s.kt)("a",{parentName:"p",href:"transaction-proposal@"},"transaction agreement proposal")," would impose on that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," once it were signed."),(0,s.kt)("h3",{id:"corpus-of-terminology"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/corpus"},"Corpus of Terminology")),(0,s.kt)("p",null,"the documentation that describes the ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h3",{id:"risk"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk"},"Risk")),(0,s.kt)("p",null,"the effects that uncertainty (i.e. a lack of information, understanding or ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," of events, their consequences or likelihoods) can have on the intended realization of an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"transaction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction"},"Transaction")),(0,s.kt)("p",null,"the exchange of goods, services, funds, or data between some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (called ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction"),")."),(0,s.kt)("h3",{id:"scope-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scope"},"Scope")),(0,s.kt)("p",null,"the extent of the area or subject matter (which we use, e.g., to define ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," in, but it serves other purposes as well)."),(0,s.kt)("h3",{id:"scope-of-control"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scope-of-control"},"Scope of Control")),(0,s.kt)("p",null,"the extent of the area or subject matter that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"controller@"},"controls"),"."),(0,s.kt)("h3",{id:"concept-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/concept"},"Concept")),(0,s.kt)("p",null,"the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("h3",{id:"capability-of-an-actor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/capability-of-an-actor"},"Capability (of an Actor)")),(0,s.kt)("p",null,"the potential of an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," to execute a (named) coherent set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (a 'function', or 'task') on behalf of some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"compliance-management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-management"},"Compliance management")),(0,s.kt)("p",null,"the process that is run by (or on behalf of) a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for the purpose of ",(0,s.kt)("a",{parentName:"p",href:"management@"},"managing")," its ",(0,s.kt)("a",{parentName:"p",href:"compliance-objective@"},"compliance objectives"),"."),(0,s.kt)("h3",{id:"documentation-interoperability"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/documentation-interop"},"Documentation Interoperability")),(0,s.kt)("p",null,"the property that a documentation system of making its content comprehensible for a variety of people that come from different backgrounds."),(0,s.kt)("h3",{id:"owner"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/owner"},"Owner")),(0,s.kt)("p",null,"the role that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," performs when it is exercising its legal, rightful or natural title to control that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h3",{id:"controller"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/controller"},"Controller")),(0,s.kt)("p",null,"the role that an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," performs as it is executing actions on that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the purpose of ensuring that the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," will act/behave, or be used, in a particular way."),(0,s.kt)("h3",{id:"essif-lab-world-model-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking)."),(0,s.kt)("h3",{id:"terminology-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terminology"},"Terminology")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("h3",{id:"transaction-agreement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-agreement"},"Transaction Agreement")),(0,s.kt)("p",null,"the set of rules that specify the rights (",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation"),") and duties (",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation"),") of ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," towards one another in the context of a specific ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"guardianship-in-a-jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-arrangement"},"Guardianship (in a Jurisdiction)")),(0,s.kt)("p",null,"the specification of a set of rights and duties between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that enforces these rights and duties, for the purpose of caring for and/or protecting/guarding/defending one or more of these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"entities"),". (Synonym of ",(0,s.kt)("a",{parentName:"p",href:"@"},"Guardianship Arrangement"),")"),(0,s.kt)("h3",{id:"credential-type"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential-type"},"Credential Type")),(0,s.kt)("p",null,"the specification of the contents, properties, constraints etc. that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," of this type must have/comply with."),(0,s.kt)("h3",{id:"transaction-form"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-form"},"Transaction Form")),(0,s.kt)("p",null,"the specification of the set of data that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," needs to (a) commit to a (proposed) ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction")," of that kind, (b) fulfill its duties/",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," and (c) escalate if necessary."),(0,s.kt)("h3",{id:"outsourcing"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/outsourcing"},"Outsourcing")),(0,s.kt)("p",null,"the state of affairs in which a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," (better: an ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation"),") for the realization of a (set of) result(s), where the actual production of these results is expected to be done by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," other than itself."),(0,s.kt)("h3",{id:"compliance"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance"},"Compliance")),(0,s.kt)("p",null,"the state of realization of a set of conformance criteria or normative framework of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"vocabulary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("p",null,"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("h3",{id:"ssi-infrastructure"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-infrastructure"},"SSI Infrastructure")),(0,s.kt)("p",null,"the technological components that are (envisaged to be) all over the world for the purpose of providing, requesting and obtaining ",(0,s.kt)("a",{parentName:"p",href:"@"},"qualified data"),", for the purpose of negotiating and/or executing electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction"),"."),(0,s.kt)("h3",{id:"delegate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/delegate"},"Delegate")),(0,s.kt)("p",null,"the transferral of ",(0,s.kt)("a",{parentName:"p",href:"@"},"ownership")," of one or more ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegator"),"), including the associated accountability, to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegatee"),")), which implies that the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegatee")," can realize such ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," as it sees fit."),(0,s.kt)("h3",{id:"define-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("p",null,"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("h3",{id:"colleague"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/colleague"},"Colleague")),(0,s.kt)("p",null,"two or more (digital or non-digital) ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," that have the same ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," (i.e. ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," on whose behalf they are executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),").")),(0,s.kt)(r.Z,{value:"glossary-and-abbrs",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in the same format as defined in file ",(0,s.kt)("inlineCode",{parentName:"p"},"terminology-config.yaml"),", but now with the specification of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," placed inline."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" con[1]="markdown-table-row" con[2]="markdown-abbr-table-row"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Abbreviation"),(0,s.kt)("th",{parentName:"tr",align:null},"Refers to")))),(0,s.kt)("p",null,'{% hrg="" con',"[1]",'="markdown-table-row" con',"[2]",'="markdown-abbr-table-row" %}')),(0,s.kt)(r.Z,{value:"glossary-with-notes",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that shows that you can add notes to a glossary entry.\nFor this purpose, we use a custom converter that"),(0,s.kt)("ol",{parentName:"admonition"},(0,s.kt)("li",{parentName:"ol"},"only creates an entry for MRG entries that have an existing, non-empty ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryNotes")," field"),(0,s.kt)("li",{parentName:"ol"},"shows the notes.")),(0,s.kt)("p",{parentName:"admonition"},"We have simplified the handlebars template so that it becomes easier for readers to focus on what we have been trying to do here."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" converter="{{#if glossaryNotes}}## {{noRefs glossaryTerm}}\\n\\n{{glossaryText}}\\n\\n### Notes\\n\\n{{#each glossaryNotes}}- {{this}}\\n{{/each}}\\n{{/if}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"glossary-markdown-style"},"Glossary (Markdown style)"),(0,s.kt)("h3",{id:"body-file-1"},"Body File"),(0,s.kt)("p",null,"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h4",{id:"notes-23"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"li"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("h3",{id:"body-of-a-curated-text-1"},"Body (of a Curated Text)"),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("h4",{id:"notes-24"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),".")),(0,s.kt)("h3",{id:"converter-profile-1"},"Converter Profile"),(0,s.kt)("p",null,"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("h4",{id:"notes-25"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",{parentName:"ul"},"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments.")),(0,s.kt)("h3",{id:"converter-1"},"Converter"),(0,s.kt)("p",null,"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("h4",{id:"notes-26"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),".")),(0,s.kt)("h3",{id:"form-phrase-macro-map-1"},"Form Phrase Macro Map"),(0,s.kt)("p",null,"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("h4",{id:"notes-27"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"li"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"li"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"li",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,s.kt)("h3",{id:"form-phrase-for-a-semantic-unit-1"},"Form Phrase (for a Semantic Unit)"),(0,s.kt)("p",null,"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("h4",{id:"notes-28"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("h3",{id:"front-matter-1"},"Front Matter"),(0,s.kt)("p",null,"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("h4",{id:"notes-29"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",{parentName:"ul"},"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.")),(0,s.kt)("h3",{id:"glossary-term-1"},"Glossary Term"),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h4",{id:"notes-30"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",{parentName:"ul"},"if the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"li"},"{{capFirst term}}"))),(0,s.kt)("h3",{id:"glossary-text-1"},"Glossary Text"),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h4",{id:"notes-31"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),".")),(0,s.kt)("h3",{id:"handlebars-helper-function-1"},"Handlebars Helper Function"),(0,s.kt)("p",null,"a function that can be used in a ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("h4",{id:"notes-32"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences.")),(0,s.kt)("h3",{id:"handlebars-object-1"},"Handlebars Object"),(0,s.kt)("p",null,"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("h4",{id:"notes-33"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"))),(0,s.kt)("h3",{id:"handlebars-template-1"},"Handlebars Template"),(0,s.kt)("p",null,"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("h4",{id:"notes-34"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates.")),(0,s.kt)("h3",{id:"header-of-a-curated-text-1"},"Header (of a Curated Text)"),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("h4",{id:"notes-35"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),".")),(0,s.kt)("h3",{id:"machine-readable-glossary-tool-1"},"Machine Readable Glossary Tool"),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("h4",{id:"notes-36"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("h3",{id:""}),(0,s.kt)("p",null,"the (name of the field in the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("h4",{id:"notes-37"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves.")),(0,s.kt)("h3",{id:"regular-expression-1"},"Regular Expression"),(0,s.kt)("p",null,"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("h4",{id:"notes-38"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"li",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),".")),(0,s.kt)("h3",{id:"regularized-text-1"},"Regularized Text"),(0,s.kt)("p",null,"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"p"},"-")," character."),(0,s.kt)("h4",{id:"notes-39"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"li"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text.")),(0,s.kt)("h3",{id:"relation-between-concepts-2"},"Relation (between Concepts)"),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h4",{id:"notes-40"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other.")),(0,s.kt)("h3",{id:"semantic-unit-2"},"Semantic Unit"),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("h4",{id:"notes-41"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc.")),(0,s.kt)("h3",{id:"term-identifier-1"},"Term Identifier"),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h4",{id:"notes-42"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed.")),(0,s.kt)("h3",{id:"-1"}),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("h4",{id:"notes-43"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",{parentName:"ul"},"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",{parentName:"ul"},"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term.")),(0,s.kt)("h3",{id:"terminology-identifier-1"},"Terminology Identifier"),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h4",{id:"notes-44"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"li"},":")," is omitted, their values are taken be the current (or default) ones.")),(0,s.kt)("h3",{id:"tev2-toolbox-1"},"TEv2 Toolbox"),(0,s.kt)("p",null,"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("h4",{id:"notes-45"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets.")),(0,s.kt)("h2",{id:"glossary-table-style"},"Glossary (Table style)"),(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"The same, but now generating the glossary in a table format. We use the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),":"),(0,s.kt)("p",{parentName:"admonition"},(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" converter="{{#if glossaryNotes}}## {{noRefs glossaryTerm}}\\n\\n{{glossaryText}}\\n\\n### Notes\\n\\n{{#each glossaryNotes}}- {{this}}\\n{{/each}}\\n{{/if}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:"left"},"Term"),(0,s.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Body File"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"td"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Body (of a Curated Text)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Converter Profile"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",null,"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Converter"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Form Phrase Macro Map"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"td"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",null,"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"td"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Form Phrase (for a Semantic Unit)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",null,"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Front Matter"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",null,"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Glossary Term"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",null,"if the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"td"},"{{capFirst term}}")),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Glossary Text"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Helper Function"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Object"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Template"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",null,"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",null,"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Header (of a Curated Text)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Machine Readable Glossary Tool"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"}),(0,s.kt)("td",{parentName:"tr",align:"left"},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Regular Expression"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Regularized Text"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Relation (between Concepts)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Semantic Unit"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),").",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Term Identifier"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"If ",(0,s.kt)("inlineCode",{parentName:"td"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"}),(0,s.kt)("td",{parentName:"tr",align:"left"},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",null,"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",null,"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Terminology Identifier"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"If ",(0,s.kt)("inlineCode",{parentName:"td"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"td"},":")," is omitted, their values are taken be the current (or default) ones."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"TEv2 Toolbox"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets."),(0,s.kt)("br",null)))))))))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3113],{3905:(t,e,a)=>{a.d(e,{Zo:()=>l,kt:()=>p});var i=a(7294);function s(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function n(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function r(t){for(var e=1;e=0||(s[a]=t[a]);return s}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(s[a]=t[a])}return s}var c=i.createContext({}),h=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):r(r({},e),t)),a},l=function(t){var e=h(t.components);return i.createElement(c.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},m=i.forwardRef((function(t,e){var a=t.components,s=t.mdxType,n=t.originalType,c=t.parentName,l=o(t,["components","mdxType","originalType","parentName"]),m=h(a),p=s,f=m["".concat(c,".").concat(p)]||m[p]||d[p]||n;return a?i.createElement(f,r(r({ref:e},l),{},{components:a})):i.createElement(f,r({ref:e},l))}));function p(t,e){var a=arguments,s=e&&e.mdxType;if("string"==typeof t||s){var n=a.length,r=new Array(n);r[0]=m;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:s,r[1]=o;for(var h=2;h{a.d(e,{Z:()=>r});var i=a(7294),s=a(6010);const n="tabItem_Ymn6";function r(t){let{children:e,hidden:a,className:r}=t;return i.createElement("div",{role:"tabpanel",className:(0,s.Z)(n,r),hidden:a},e)}},4866:(t,e,a)=>{a.d(e,{Z:()=>x});var i=a(3117),s=a(7294),n=a(6010),r=a(2466),o=a(6775),c=a(1980),h=a(7392),l=a(12);function d(t){return function(t){return s.Children.map(t,(t=>{if(!t||(0,s.isValidElement)(t)&&function(t){const{props:e}=t;return!!e&&"object"==typeof e&&"value"in e}(t))return t;throw new Error(`Docusaurus error: Bad child <${"string"==typeof t.type?t.type:t.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(t).map((t=>{let{props:{value:e,label:a,attributes:i,default:s}}=t;return{value:e,label:a,attributes:i,default:s}}))}function m(t){const{values:e,children:a}=t;return(0,s.useMemo)((()=>{const t=e??d(a);return function(t){const e=(0,h.l)(t,((t,e)=>t.value===e.value));if(e.length>0)throw new Error(`Docusaurus error: Duplicate values "${e.map((t=>t.value)).join(", ")}" found in . Every value needs to be unique.`)}(t),t}),[e,a])}function p(t){let{value:e,tabValues:a}=t;return a.some((t=>t.value===e))}function f(t){let{queryString:e=!1,groupId:a}=t;const i=(0,o.k6)(),n=function(t){let{queryString:e=!1,groupId:a}=t;if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:e,groupId:a});return[(0,c._X)(n),(0,s.useCallback)((t=>{if(!n)return;const e=new URLSearchParams(i.location.search);e.set(n,t),i.replace({...i.location,search:e.toString()})}),[n,i])]}function u(t){const{defaultValue:e,queryString:a=!1,groupId:i}=t,n=m(t),[r,o]=(0,s.useState)((()=>function(t){let{defaultValue:e,tabValues:a}=t;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(e){if(!p({value:e,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${a.map((t=>t.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}const i=a.find((t=>t.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:e,tabValues:n}))),[c,h]=f({queryString:a,groupId:i}),[d,u]=function(t){let{groupId:e}=t;const a=function(t){return t?`docusaurus.tab.${t}`:null}(e),[i,n]=(0,l.Nk)(a);return[i,(0,s.useCallback)((t=>{a&&n.set(t)}),[a,n])]}({groupId:i}),g=(()=>{const t=c??d;return p({value:t,tabValues:n})?t:null})();(0,s.useLayoutEffect)((()=>{g&&o(g)}),[g]);return{selectedValue:r,selectValue:(0,s.useCallback)((t=>{if(!p({value:t,tabValues:n}))throw new Error(`Can't select invalid tab value=${t}`);o(t),h(t),u(t)}),[h,u,n]),tabValues:n}}var g=a(2389);const k="tabList__CuJ",v="tabItem_LNqP";function b(t){let{className:e,block:a,selectedValue:o,selectValue:c,tabValues:h}=t;const l=[],{blockElementScrollPositionUntilNextRender:d}=(0,r.o5)(),m=t=>{const e=t.currentTarget,a=l.indexOf(e),i=h[a].value;i!==o&&(d(e),c(i))},p=t=>{let e=null;switch(t.key){case"Enter":m(t);break;case"ArrowRight":{const a=l.indexOf(t.currentTarget)+1;e=l[a]??l[0];break}case"ArrowLeft":{const a=l.indexOf(t.currentTarget)-1;e=l[a]??l[l.length-1];break}}e?.focus()};return s.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,n.Z)("tabs",{"tabs--block":a},e)},h.map((t=>{let{value:e,label:a,attributes:r}=t;return s.createElement("li",(0,i.Z)({role:"tab",tabIndex:o===e?0:-1,"aria-selected":o===e,key:e,ref:t=>l.push(t),onKeyDown:p,onClick:m},r,{className:(0,n.Z)("tabs__item",v,r?.className,{"tabs__item--active":o===e})}),a??e)})))}function y(t){let{lazy:e,children:a,selectedValue:i}=t;const n=(Array.isArray(a)?a:[a]).filter(Boolean);if(e){const t=n.find((t=>t.props.value===i));return t?(0,s.cloneElement)(t,{className:"margin-top--md"}):null}return s.createElement("div",{className:"margin-top--md"},n.map(((t,e)=>(0,s.cloneElement)(t,{key:e,hidden:t.props.value!==i}))))}function w(t){const e=u(t);return s.createElement("div",{className:(0,n.Z)("tabs-container",k)},s.createElement(b,(0,i.Z)({},t,e)),s.createElement(y,(0,i.Z)({},t,e)))}function x(t){const e=(0,g.Z)();return s.createElement(w,(0,i.Z)({key:String(e)},t))}},2300:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>l,contentTitle:()=>c,default:()=>p,frontMatter:()=>o,metadata:()=>h,toc:()=>d});var i=a(3117),s=(a(7294),a(3905)),n=(a(4996),a(4866)),r=a(5162);const o={id:"tev2-glossaries-demo",toc_min_heading_level:6,toc_max_heading_level:6,date:20231205},c="Glossary Generation Demo",h={unversionedId:"tev2-glossaries-demo",id:"tev2-glossaries-demo",title:"Glossary Generation Demo",description:"This page is evidence that an HRG can be generated for every MRG that is available within the scope. It also shows that HRGs can be generated in different formats.",source:"@site/docs/tev2-glossaries-demo.md",sourceDirName:".",slug:"/tev2-glossaries-demo",permalink:"/tev2-specifications/docs/tev2-glossaries-demo",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/tev2-glossaries-demo.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"tev2-glossaries-demo",toc_min_heading_level:6,toc_max_heading_level:6,date:20231205},sidebar:"tev2SideBar",previous:{title:"Glossary",permalink:"/tev2-specifications/docs/tev2-glossary"},next:{title:"Miscellaneous",permalink:"/tev2-specifications/docs/categories/miscellaneous"}},l={},d=[{value:"Action",id:"action",level:2},{value:"Actor",id:"actor",level:2},{value:"Author",id:"author",level:2},{value:"Body File",id:"body-file",level:2},{value:"Notes",id:"notes",level:3},{value:"Body (of a Curated Text)",id:"body-of-a-curated-text",level:2},{value:"Notes",id:"notes-1",level:3},{value:"Community",id:"community",level:2},{value:"Concept",id:"concept",level:2},{value:"Conceptualization",id:"conceptualization",level:2},{value:"Converter Profile",id:"converter-profile",level:2},{value:"Notes",id:"notes-2",level:3},{value:"Converter",id:"converter",level:2},{value:"Notes",id:"notes-3",level:3},{value:"Corpus",id:"corpus",level:2},{value:"Curate",id:"curate",level:2},{value:"Curated File",id:"curated-file",level:2},{value:"Curated Text File",id:"curated-text-file",level:2},{value:"Curated Text",id:"curated-text",level:2},{value:"Curatedir",id:"curatedir",level:2},{value:"Curator (of a Scope)",id:"curator-of-a-scope",level:2},{value:"Current Scope",id:"current-scope",level:2},{value:"Define",id:"define",level:2},{value:"Definition",id:"definition",level:2},{value:"Definition Pattern",id:"definition-pattern",level:2},{value:"Dictionary",id:"dictionary",level:2},{value:"Entity",id:"entity",level:2},{value:"Macro Map",id:"macro-map",level:2},{value:"Form Phrase Macro Map",id:"form-phrase-macro-map",level:2},{value:"Notes",id:"notes-4",level:3},{value:"Form Phrase Macro",id:"form-phrase-macro",level:2},{value:"Form Phrase (for a Semantic Unit)",id:"form-phrase-for-a-semantic-unit",level:2},{value:"Notes",id:"notes-5",level:3},{value:"Formatted Text",id:"formatted-text",level:2},{value:"Front Matter",id:"front-matter",level:2},{value:"Notes",id:"notes-6",level:3},{value:"Glossary",id:"glossary",level:2},{value:"Glossarydir",id:"glossarydir",level:2},{value:"Glossary Term",id:"glossary-term",level:2},{value:"Notes",id:"notes-7",level:3},{value:"Glossary Text",id:"glossary-text",level:2},{value:"Notes",id:"notes-8",level:3},{value:"Grouptag",id:"grouptag",level:2},{value:"Handlebars Helper Function",id:"handlebars-helper-function",level:2},{value:"Notes",id:"notes-9",level:3},{value:"Handlebars Object",id:"handlebars-object",level:2},{value:"Notes",id:"notes-10",level:3},{value:"Handlebars Template",id:"handlebars-template",level:2},{value:"Notes",id:"notes-11",level:3},{value:"Header (of a Curated Text)",id:"header-of-a-curated-text",level:2},{value:"Notes",id:"notes-12",level:3},{value:"HRD",id:"hrd",level:2},{value:"Human Readable Dictionary",id:"human-readable-dictionary",level:2},{value:"HRDT",id:"hrdt",level:2},{value:"Human Readable Dictionary Tool",id:"human-readable-dictionary-tool",level:2},{value:"HRG Entry",id:"hrg-entry",level:2},{value:"HRG List",id:"hrg-list",level:2},{value:"HRG",id:"hrg",level:2},{value:"Human Readable Glossary",id:"human-readable-glossary",level:2},{value:"HRGT",id:"hrgt",level:2},{value:"Human Readable Glossary Tool",id:"human-readable-glossary-tool",level:2},{value:"ICT",id:"ict",level:2},{value:"Integrity Checker Tool",id:"integrity-checker-tool",level:2},{value:"Ingestion Profile",id:"ingestion-profile",level:2},{value:"Ingestion (Process)",id:"ingestion-process",level:2},{value:"Interpreter Profile",id:"interpreter-profile",level:2},{value:"Interpreter",id:"interpreter",level:2},{value:"Legal Entity",id:"legal-entity",level:2},{value:"Mental Model",id:"mental-model",level:2},{value:"Moustache Variable",id:"moustache-variable",level:2},{value:"MRD",id:"mrd",level:2},{value:"Machine Readable Dictionary",id:"machine-readable-dictionary",level:2},{value:"MRDT",id:"mrdt",level:2},{value:"Machine Readable Dictionary Tool",id:"machine-readable-dictionary-tool",level:2},{value:"MRG Entry",id:"mrg-entry",level:2},{value:"MRG Import (Tool)",id:"mrg-import-tool",level:2},{value:"MRGRef",id:"mrgref",level:2},{value:"MRG",id:"mrg",level:2},{value:"Machine Readable Glossary",id:"machine-readable-glossary",level:2},{value:"MRGT",id:"mrgt",level:2},{value:"Machine Readable Glossary Tool",id:"machine-readable-glossary-tool",level:2},{value:"Notes",id:"notes-13",level:3},{value:"Named Capturing Group",id:"named-capturing-group",level:2},{value:"Navpath",id:"navpath",level:2},{value:"Notes",id:"notes-14",level:3},{value:"Organization",id:"organization",level:2},{value:"Party",id:"party",level:2},{value:"Property (of a Concept)",id:"property-of-a-concept",level:2},{value:"Provisional MRG Entry",id:"provisional-mrg-entry",level:2},{value:"Provisional MRG",id:"provisional-mrg",level:2},{value:"Reader",id:"reader",level:2},{value:"Regex",id:"regex",level:2},{value:"Regular Expression",id:"regular-expression",level:2},{value:"Notes",id:"notes-15",level:3},{value:"Regularized Form Phrase",id:"regularized-form-phrase",level:2},{value:"Regularized Text",id:"regularized-text",level:2},{value:"Notes",id:"notes-16",level:3},{value:"Relation (between Concepts)",id:"relation-between-concepts",level:2},{value:"Notes",id:"notes-17",level:3},{value:"Renderable Ref",id:"renderable-ref",level:2},{value:"SAF",id:"saf",level:2},{value:"Scope Administration File",id:"scope-administration-file",level:2},{value:"Scope",id:"scope",level:2},{value:"Scoped Term",id:"scoped-term",level:2},{value:"Scopedir",id:"scopedir",level:2},{value:"Scopetag",id:"scopetag",level:2},{value:"Semantic Unit",id:"semantic-unit",level:2},{value:"Notes",id:"notes-18",level:3},{value:"Semantics",id:"semantics",level:2},{value:"Sorter",id:"sorter",level:2},{value:"Synonym (of a [term](@))",id:"synonym-of-a-term",level:2},{value:"Tag",id:"tag",level:2},{value:"Term Identifier",id:"term-identifier",level:2},{value:"Notes",id:"notes-19",level:3},{value:"TermRef",id:"termref",level:2},{value:"Term Selection Instruction",id:"term-selection-instruction",level:2},{value:"Term Type",id:"term-type",level:2},{value:"Term",id:"term",level:2},{value:"Notes",id:"notes-20",level:3},{value:"Termid",id:"termid",level:2},{value:"Terminology Identifier",id:"terminology-identifier",level:2},{value:"Notes",id:"notes-21",level:3},{value:"Terminology Process",id:"terminology-process",level:2},{value:"Terminology",id:"terminology",level:2},{value:"Terminology Pattern",id:"terminology-pattern",level:2},{value:"Terms Community",id:"terms-community",level:2},{value:"TEv2 Text Conversion Tool",id:"tev2-text-conversion-tool",level:2},{value:"TEv2 Toolbox",id:"tev2-toolbox",level:2},{value:"Notes",id:"notes-22",level:3},{value:"TEv2 Tool",id:"tev2-tool",level:2},{value:"TEv2",id:"tev2",level:2},{value:"TRRT",id:"trrt",level:2},{value:"TermRef Rendering Tool",id:"termref-rendering-tool",level:2},{value:"Use-Case",id:"use-case",level:2},{value:"Versiontag",id:"versiontag",level:2},{value:"Vocabulary",id:"vocabulary",level:2},{value:"Writer",id:"writer",level:2},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern",level:2},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern",level:2},{value:"Decision Making Pattern",id:"decision-making-pattern",level:2},{value:"Definition Pattern",id:"definition-pattern-1",level:2},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern",level:2},{value:"Governance and Management Pattern",id:"governance-and-management-pattern",level:2},{value:"Guardianship Pattern",id:"guardianship-pattern",level:2},{value:"Identification Pattern",id:"identification-pattern",level:2},{value:"Identifier Pattern",id:"identifier-pattern",level:2},{value:"Identity Pattern",id:"identity-pattern",level:2},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern",level:2},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern",level:2},{value:"Mental Model Pattern",id:"mental-model-pattern",level:2},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern",level:2},{value:"Party Representation Pattern",id:"party-representation-pattern",level:2},{value:"Semantics Pattern",id:"semantics-pattern",level:2},{value:"Terminology Pattern",id:"terminology-pattern-1",level:2},{value:"Trust Pattern",id:"trust-pattern",level:2},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model",level:2},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern-1",level:2},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern-1",level:2},{value:"Decision Making Pattern",id:"decision-making-pattern-1",level:2},{value:"Definition Pattern",id:"definition-pattern-2",level:2},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern-1",level:2},{value:"Governance and Management Pattern",id:"governance-and-management-pattern-1",level:2},{value:"Guardianship Pattern",id:"guardianship-pattern-1",level:2},{value:"Identification Pattern",id:"identification-pattern-1",level:2},{value:"Identifier Pattern",id:"identifier-pattern-1",level:2},{value:"Identity Pattern",id:"identity-pattern-1",level:2},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern-1",level:2},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern-1",level:2},{value:"Mental Model Pattern",id:"mental-model-pattern-1",level:2},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern-1",level:2},{value:"Party Representation Pattern",id:"party-representation-pattern-1",level:2},{value:"Semantics Pattern",id:"semantics-pattern-1",level:2},{value:"Terminology Pattern",id:"terminology-pattern-2",level:2},{value:"Trust Pattern",id:"trust-pattern-1",level:2},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model-1",level:2},{value:"Qualified Data",id:"qualified-data",level:3},{value:"Attribute",id:"attribute",level:3},{value:"Communication Channel",id:"communication-channel",level:3},{value:"Employee",id:"employee",level:3},{value:"Policy",id:"policy",level:3},{value:"Presentation",id:"presentation",level:3},{value:"Presentation Request",id:"presentation-request",level:3},{value:"Relation (between Concepts)",id:"relation-between-concepts-1",level:3},{value:"Terms Community",id:"terms-community-1",level:3},{value:"SSI Assurance Community (SSI-AC)",id:"ssi-assurance-community-ssi-ac",level:3},{value:"SSI Agent",id:"ssi-agent",level:3},{value:"Holder Policy",id:"holder-policy",level:3},{value:"Isuer Policy",id:"isuer-policy",level:3},{value:"Revocation Policy",id:"revocation-policy",level:3},{value:"Validator Policy",id:"validator-policy",level:3},{value:"Verifier Policy",id:"verifier-policy",level:3},{value:"Wallet Policy",id:"wallet-policy",level:3},{value:"Legal Jurisdiction",id:"legal-jurisdiction",level:3},{value:"Participant",id:"participant",level:3},{value:"Authority (Centralized or Decentralized)",id:"authority-centralized-or-decentralized",level:3},{value:"Employer",id:"employer",level:3},{value:"Peer Party",id:"peer-party",level:3},{value:"Guardian",id:"guardian",level:3},{value:"Organization",id:"organization-1",level:3},{value:"Community",id:"community-1",level:3},{value:"Governor",id:"governor",level:3},{value:"Term (Scoped)",id:"term-scoped",level:3},{value:"Transaction Proposal",id:"transaction-proposal",level:3},{value:"Semantic Unit",id:"semantic-unit-1",level:3},{value:"Identifier",id:"identifier",level:3},{value:"Guardianship-type",id:"guardianship-type",level:3},{value:"Information Process",id:"information-process",level:3},{value:"Revocation component",id:"revocation-component",level:3},{value:"Issuer",id:"issuer",level:3},{value:"Validator",id:"validator",level:3},{value:"Holder",id:"holder",level:3},{value:"Verifier",id:"verifier",level:3},{value:"Wallet",id:"wallet",level:3},{value:"Property (of a Concept)",id:"property-of-a-concept-1",level:3},{value:"Assertion",id:"assertion",level:3},{value:"Role",id:"role",level:3},{value:"Mental Model",id:"mental-model-1",level:3},{value:"Pattern",id:"pattern",level:3},{value:"Credential Catalogue",id:"credential-catalogue",level:3},{value:"Semantics",id:"semantics-1",level:3},{value:"Compliance level",id:"compliance-level",level:3},{value:"Risk level",id:"risk-level",level:3},{value:"Control level",id:"control-level",level:3},{value:"Transaction Request",id:"transaction-request",level:3},{value:"Terminology Process",id:"terminology-process-1",level:3},{value:"Human Being",id:"human-being",level:3},{value:"Risk management",id:"risk-management",level:3},{value:"Onboarding",id:"onboarding",level:3},{value:"Control Process",id:"control-process",level:3},{value:"Ownership",id:"ownership",level:3},{value:"Mandate",id:"mandate",level:3},{value:"Identity Pattern",id:"identity-pattern-2",level:3},{value:"Identifier Pattern",id:"identifier-pattern-2",level:3},{value:"Party Representation Pattern",id:"party-representation-pattern-2",level:3},{value:"Governance and Management Pattern",id:"governance-and-management-pattern-2",level:3},{value:"Decision Making Pattern",id:"decision-making-pattern-2",level:3},{value:"Decentralized Risk Management Pattern",id:"decentralized-risk-management-pattern-2",level:3},{value:"Trust Pattern",id:"trust-pattern-2",level:3},{value:"Party, Actor and Actions Pattern",id:"party-actor-and-actions-pattern-2",level:3},{value:"Mental Model Pattern",id:"mental-model-pattern-2",level:3},{value:"Decentralized GRC Pattern",id:"decentralized-grc-pattern-2",level:3},{value:"Mandates, Delegation and Hiring Pattern",id:"mandates-delegation-and-hiring-pattern-2",level:3},{value:"Identification Pattern",id:"identification-pattern-2",level:3},{value:"Semantics Pattern",id:"semantics-pattern-2",level:3},{value:"Guardianship Pattern",id:"guardianship-pattern-2",level:3},{value:"Jurisdiction Pattern",id:"jurisdiction-pattern-2",level:3},{value:"Duties and Rights Pattern",id:"duties-and-rights-pattern-2",level:3},{value:"Terminology Pattern",id:"terminology-pattern-3",level:3},{value:"Framework (Conceptual)",id:"framework-conceptual",level:3},{value:"Ecosystem",id:"ecosystem",level:3},{value:"Normative framework",id:"normative-framework",level:3},{value:"Legal System",id:"legal-system",level:3},{value:"Definition",id:"definition-1",level:3},{value:"Communication Session",id:"communication-session",level:3},{value:"Term",id:"term-1",level:3},{value:"Partial identity",id:"partial-identity",level:3},{value:"Identify",id:"identify",level:3},{value:"Agent",id:"agent",level:3},{value:"Dependent",id:"dependent",level:3},{value:"Owned",id:"owned",level:3},{value:"Legal Entity",id:"legal-entity-1",level:3},{value:"Party",id:"party-1",level:3},{value:"Mission",id:"mission",level:3},{value:"Expectation",id:"expectation",level:3},{value:"Obligation",id:"obligation",level:3},{value:"Control Objective",id:"control-objective",level:3},{value:"Compliance Objective",id:"compliance-objective",level:3},{value:"Risk Objective",id:"risk-objective",level:3},{value:"Employment Contract",id:"employment-contract",level:3},{value:"Glossary",id:"glossary-1",level:3},{value:"Dictionary",id:"dictionary-1",level:3},{value:"Tag",id:"tag-1",level:3},{value:"Advertisement",id:"advertisement",level:3},{value:"Transaction Id",id:"transaction-id",level:3},{value:"Credential",id:"credential",level:3},{value:"Actor",id:"actor-1",level:3},{value:"Guardianship Arrangement",id:"guardianship-arrangement",level:3},{value:"Role name",id:"role-name",level:3},{value:"Self-Sovereign Identity (SSI)",id:"self-sovereign-identity-ssi",level:3},{value:"Entity",id:"entity-1",level:3},{value:"Data",id:"data",level:3},{value:"Action",id:"action-1",level:3},{value:"Objective",id:"objective",level:3},{value:"Scope: essifLabTerminology",id:"scope-essiflabterminology",level:3},{value:"SSI (Self-Sovereign Identity)",id:"ssi-self-sovereign-identity",level:3},{value:"Knowledge",id:"knowledge",level:3},{value:"Capability (of a Party)",id:"capability-of-a-party",level:3},{value:"Subject",id:"subject",level:3},{value:"Trust level",id:"trust-level",level:3},{value:"Trust",id:"trust",level:3},{value:"Governance",id:"governance",level:3},{value:"Management",id:"management",level:3},{value:"Peer Actor",id:"peer-actor",level:3},{value:"Peer-agent",id:"peer-agent",level:3},{value:"Controllership",id:"controllership",level:3},{value:"Principal",id:"principal",level:3},{value:"Risk Owner",id:"risk-owner",level:3},{value:"Validate",id:"validate",level:3},{value:"Verify",id:"verify",level:3},{value:"Revoke/Revocation",id:"revokerevocation",level:3},{value:"Self-Sovereignty",id:"self-sovereignty",level:3},{value:"Assessment Framework",id:"assessment-framework",level:3},{value:"Control",id:"control",level:3},{value:"Identity",id:"identity",level:3},{value:"Jurisdiction",id:"jurisdiction",level:3},{value:"Decision",id:"decision",level:3},{value:"Commitment Decision",id:"commitment-decision",level:3},{value:"Corpus of Terminology",id:"corpus-of-terminology",level:3},{value:"Risk",id:"risk",level:3},{value:"Transaction",id:"transaction",level:3},{value:"Scope",id:"scope-1",level:3},{value:"Scope of Control",id:"scope-of-control",level:3},{value:"Concept",id:"concept-1",level:3},{value:"Capability (of an Actor)",id:"capability-of-an-actor",level:3},{value:"Compliance management",id:"compliance-management",level:3},{value:"Documentation Interoperability",id:"documentation-interoperability",level:3},{value:"Owner",id:"owner",level:3},{value:"Controller",id:"controller",level:3},{value:"eSSIF-Lab World Model",id:"essif-lab-world-model-2",level:3},{value:"Terminology",id:"terminology-1",level:3},{value:"Transaction Agreement",id:"transaction-agreement",level:3},{value:"Guardianship (in a Jurisdiction)",id:"guardianship-in-a-jurisdiction",level:3},{value:"Credential Type",id:"credential-type",level:3},{value:"Transaction Form",id:"transaction-form",level:3},{value:"Outsourcing",id:"outsourcing",level:3},{value:"Compliance",id:"compliance",level:3},{value:"Vocabulary",id:"vocabulary-1",level:3},{value:"SSI Infrastructure",id:"ssi-infrastructure",level:3},{value:"Delegate",id:"delegate",level:3},{value:"Define",id:"define-1",level:3},{value:"Colleague",id:"colleague",level:3},{value:"Glossary (Markdown style)",id:"glossary-markdown-style",level:2},{value:"Body File",id:"body-file-1",level:3},{value:"Notes",id:"notes-23",level:4},{value:"Body (of a Curated Text)",id:"body-of-a-curated-text-1",level:3},{value:"Notes",id:"notes-24",level:4},{value:"Converter Profile",id:"converter-profile-1",level:3},{value:"Notes",id:"notes-25",level:4},{value:"Converter",id:"converter-1",level:3},{value:"Notes",id:"notes-26",level:4},{value:"Form Phrase Macro Map",id:"form-phrase-macro-map-1",level:3},{value:"Notes",id:"notes-27",level:4},{value:"Form Phrase (for a Semantic Unit)",id:"form-phrase-for-a-semantic-unit-1",level:3},{value:"Notes",id:"notes-28",level:4},{value:"Front Matter",id:"front-matter-1",level:3},{value:"Notes",id:"notes-29",level:4},{value:"Glossary Term",id:"glossary-term-1",level:3},{value:"Notes",id:"notes-30",level:4},{value:"Glossary Text",id:"glossary-text-1",level:3},{value:"Notes",id:"notes-31",level:4},{value:"Handlebars Helper Function",id:"handlebars-helper-function-1",level:3},{value:"Notes",id:"notes-32",level:4},{value:"Handlebars Object",id:"handlebars-object-1",level:3},{value:"Notes",id:"notes-33",level:4},{value:"Handlebars Template",id:"handlebars-template-1",level:3},{value:"Notes",id:"notes-34",level:4},{value:"Header (of a Curated Text)",id:"header-of-a-curated-text-1",level:3},{value:"Notes",id:"notes-35",level:4},{value:"Machine Readable Glossary Tool",id:"machine-readable-glossary-tool-1",level:3},{value:"Notes",id:"notes-36",level:4},{value:"Notes",id:"notes-37",level:4},{value:"Regular Expression",id:"regular-expression-1",level:3},{value:"Notes",id:"notes-38",level:4},{value:"Regularized Text",id:"regularized-text-1",level:3},{value:"Notes",id:"notes-39",level:4},{value:"Relation (between Concepts)",id:"relation-between-concepts-2",level:3},{value:"Notes",id:"notes-40",level:4},{value:"Semantic Unit",id:"semantic-unit-2",level:3},{value:"Notes",id:"notes-41",level:4},{value:"Term Identifier",id:"term-identifier-1",level:3},{value:"Notes",id:"notes-42",level:4},{value:"Notes",id:"notes-43",level:4},{value:"Terminology Identifier",id:"terminology-identifier-1",level:3},{value:"Notes",id:"notes-44",level:4},{value:"TEv2 Toolbox",id:"tev2-toolbox-1",level:3},{value:"Notes",id:"notes-45",level:4},{value:"Glossary (Table style)",id:"glossary-table-style",level:2}],m={toc:d};function p(t){let{components:e,...a}=t;return(0,s.kt)("wrapper",(0,i.Z)({},m,a,{components:e,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"glossary-generation-demo"},"Glossary Generation Demo"),(0,s.kt)("p",null,"This page is evidence that an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," can be generated for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that is available within the scope. It also shows that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," can be generated in different formats."),(0,s.kt)(n.Z,{defaultValue:"default",values:[{label:"TEv2 glossary",value:"default"},{label:"Curated Terms glossary",value:"terms"},{label:"Recent changes glossary",value:"recent-changes"},{label:"Mental Model glossary",value:"patterns"},{label:"Latest eSSIF-Lab glossary",value:"latest"},{label:"Glossary and Abbrs (inline)",value:"glossary-and-abbrs"},{label:"Glossary with Notes",value:"glossary-with-notes"}],mdxType:"Tabs"},(0,s.kt)(r.Z,{value:"default",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in the format as defined in file ",(0,s.kt)("inlineCode",{parentName:"p"},"terminology-config.yaml"),", which holds the default configurations for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," within the this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="tev2"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"action"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/action"},"Action")),(0,s.kt)("p",null,"something that is actually done (a 'unit of work' that is executed) by a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (on behalf of a given ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"), as a single operation, in a specific context."),(0,s.kt)("h2",{id:"actor"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/actor"},"Actor")),(0,s.kt)("p",null,"entity that can act (do things/execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"), e.g. people, machines, but not ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization"),"."),(0,s.kt)("h2",{id:"author"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("p",null,"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("h2",{id:"body-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("p",null,"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h3",{id:"notes"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"li"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("h2",{id:"body-of-a-curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("h3",{id:"notes-1"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),".")),(0,s.kt)("h2",{id:"community"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/community"},"Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", consisting of at least two different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") that seek to collaborate with each other so that each of them can achieve its individual ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," more efficiently and/or effectively."),(0,s.kt)("h2",{id:"concept"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("h2",{id:"conceptualization"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("p",null,"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,s.kt)("h2",{id:"converter-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("p",null,"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("h3",{id:"notes-2"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",{parentName:"ul"},"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments.")),(0,s.kt)("h2",{id:"converter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("p",null,"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("h3",{id:"notes-3"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),".")),(0,s.kt)("h2",{id:"corpus"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("p",null,"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h2",{id:"curate"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("p",null,"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"curated-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("p",null,"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"curated-text-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("p",null,"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),"."),(0,s.kt)("h2",{id:"curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("p",null,"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,s.kt)("h2",{id:"curatedir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("p",null,"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"curator-of-a-scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("p",null,"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"current-scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called."),(0,s.kt)("h2",{id:"define"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("p",null,"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("h2",{id:"definition"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("p",null,"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h2",{id:"definition-pattern"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts."),(0,s.kt)("h2",{id:"entity"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/entity"},"Entity")),(0,s.kt)("p",null,"someone or something that is known to exist."),(0,s.kt)("h2",{id:"macro-map"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Macro Map")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"Form Phrase Macro Map")),(0,s.kt)("h2",{id:"form-phrase-macro-map"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("p",null,"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("h3",{id:"notes-4"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"li"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"li"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"li",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,s.kt)("h2",{id:"form-phrase-macro"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("p",null,"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc."),(0,s.kt)("h2",{id:"form-phrase-for-a-semantic-unit"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("p",null,"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("h3",{id:"notes-5"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("h2",{id:"formatted-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("p",null,"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,s.kt)("h2",{id:"front-matter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("p",null,"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("h3",{id:"notes-6"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",{parentName:"ul"},"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.")),(0,s.kt)("h2",{id:"glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("h2",{id:"glossarydir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("p",null,"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained."),(0,s.kt)("h2",{id:"glossary-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h3",{id:"notes-7"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",{parentName:"ul"},"if the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"li"},"{{capFirst term}}"))),(0,s.kt)("h2",{id:"glossary-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h3",{id:"notes-8"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),".")),(0,s.kt)("h2",{id:"grouptag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"handlebars-helper-function"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("p",null,"a function that can be used in a ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("h3",{id:"notes-9"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences.")),(0,s.kt)("h2",{id:"handlebars-object"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("p",null,"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("h3",{id:"notes-10"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"))),(0,s.kt)("h2",{id:"handlebars-template"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("p",null,"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("h3",{id:"notes-11"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates.")),(0,s.kt)("h2",{id:"header-of-a-curated-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("h3",{id:"notes-12"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),".")),(0,s.kt)("h2",{id:"hrd"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrd"},"HRD")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionary")),(0,s.kt)("h2",{id:"human-readable-dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,s.kt)("h2",{id:"hrdt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrdt"},"HRDT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrdt",title:"Human Readable Dictionary Tool: a software tool designed to create, manage, and process Human Readable Dictionaries (HRDs)."},"Human Readable Dictionary Tool")),(0,s.kt)("h2",{id:"human-readable-dictionary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,s.kt)("h2",{id:"hrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("p",null,"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("h2",{id:"hrg-list"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("p",null,"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,s.kt)("h2",{id:"hrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg"},"HRG")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossary")),(0,s.kt)("h2",{id:"human-readable-glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."),(0,s.kt)("h2",{id:"hrgt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/hrgt"},"HRGT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"Human Readable Glossary Tool")),(0,s.kt)("h2",{id:"human-readable-glossary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("h2",{id:"ict"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"ICT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools-envisaged/ict",title:"Integrity Checker Tool: a software tool designed to check the integrity and conformity of various files used in the curation and management of Glossaries, Dictionaries, Curated Texts, and other data within a terminology project. The ICT verifies that the files adhere to the TEv2 File Specifications, ensuring the consistency and accuracy of the terminology data."},"Integrity Checker Tool")),(0,s.kt)("h2",{id:"integrity-checker-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("p",null,"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data."),(0,s.kt)("h2",{id:"ingestion-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("p",null,"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h2",{id:"ingestion-process"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("p",null,"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"p",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("h2",{id:"interpreter-profile"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),")."),(0,s.kt)("h2",{id:"interpreter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,s.kt)("h2",{id:"legal-entity"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/legal-entity"},"Legal Entity")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is known by, recognized to exist, and registered in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h2",{id:"mental-model"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."),(0,s.kt)("h2",{id:"moustache-variable"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("p",null,"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"p"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"p",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html")),(0,s.kt)("h2",{id:"mrd"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrd"},"MRD")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionary")),(0,s.kt)("h2",{id:"machine-readable-dictionary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("p",null,"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,s.kt)("h2",{id:"mrdt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrdt"},"MRDT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrdt",title:"Machine Readable Dictionary Tool: a software tool designed to create, manage, and process Machine Readable Dictionaries (MRDs)."},"Machine Readable Dictionary Tool")),(0,s.kt)("h2",{id:"machine-readable-dictionary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,s.kt)("h2",{id:"mrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("p",null,"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("h2",{id:"mrg-import-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("p",null,"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),"."),(0,s.kt)("h2",{id:"mrgref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("p",null,"a text that is ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h2",{id:"mrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/mrg"},"MRG")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossary")),(0,s.kt)("h2",{id:"machine-readable-glossary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems."),(0,s.kt)("h2",{id:"mrgt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrgt"},"MRGT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"Machine Readable Glossary Tool")),(0,s.kt)("h2",{id:"machine-readable-glossary-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("h3",{id:"notes-13"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("h2",{id:"named-capturing-group"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("p",null,"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"p",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern."),(0,s.kt)("h2",{id:"navpath"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("p",null,"the (name of the field in the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("h3",{id:"notes-14"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves.")),(0,s.kt)("h2",{id:"organization"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/organization"},"Organization")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is capable of setting ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," and making sure these are realized by ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that it has ",(0,s.kt)("a",{parentName:"p",href:"onboarding@"},"onboarded")," and/or by (vetted) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that are committed to contribute to these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h2",{id:"party"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/party"},"Party")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that sets its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", maintains its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and uses that ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," to pursue its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," in an autonomous (sovereign) manner. Humans and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization")," are the typical examples."),(0,s.kt)("h2",{id:"property-of-a-concept"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("p",null,"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("h2",{id:"provisional-mrg-entry"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"provisional-mrg"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"reader"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("p",null,"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended."),(0,s.kt)("h2",{id:"regex"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regex"},"Regex")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"Regular Expression")),(0,s.kt)("h2",{id:"regular-expression"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("p",null,"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("h3",{id:"notes-15"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"li",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),".")),(0,s.kt)("h2",{id:"regularized-form-phrase"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"p"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("h2",{id:"regularized-text"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("p",null,"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"p"},"-")," character."),(0,s.kt)("h3",{id:"notes-16"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"li"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text.")),(0,s.kt)("h2",{id:"relation-between-concepts"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h3",{id:"notes-17"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other.")),(0,s.kt)("h2",{id:"renderable-ref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("p",null,"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("h2",{id:"saf"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/saf"},"SAF")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"Scope Administration File")),(0,s.kt)("h2",{id:"scope-administration-file"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("p",null,"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("h2",{id:"scope"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("p",null,"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("h2",{id:"scoped-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("h2",{id:"scopedir"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("p",null,"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"scopetag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")),(0,s.kt)("h2",{id:"semantic-unit"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("h3",{id:"notes-18"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc.")),(0,s.kt)("h2",{id:"semantics"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("p",null,"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning."),(0,s.kt)("h2",{id:"sorter"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("p",null,"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("h2",{id:"synonym-of-a-term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,s.kt)("h2",{id:"tag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("p",null,"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"term-identifier"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"notes-19"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed.")),(0,s.kt)("h2",{id:"termref"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("p",null,"a word or phrase that is ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("h2",{id:"term-selection-instruction"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("p",null,"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("h2",{id:"term-type"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"p"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"p"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"p"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"p"},"mental-model"),")."),(0,s.kt)("h2",{id:"term"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("h3",{id:"notes-20"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",{parentName:"ul"},"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",{parentName:"ul"},"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term.")),(0,s.kt)("h2",{id:"termid"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("p",null,"a text of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"terminology-identifier"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"notes-21"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"li"},":")," is omitted, their values are taken be the current (or default) ones.")),(0,s.kt)("h2",{id:"terminology-process"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("p",null,"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them."),(0,s.kt)("h2",{id:"terminology"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("h2",{id:"terminology-pattern"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("h2",{id:"terms-community"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("h2",{id:"tev2-text-conversion-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("h2",{id:"tev2-toolbox"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("p",null,"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("h3",{id:"notes-22"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets.")),(0,s.kt)("h2",{id:"tev2-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("p",null,"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."),(0,s.kt)("h2",{id:"tev2"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("p",null,"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("h2",{id:"trrt"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/trrt"},"TRRT")),(0,s.kt)("p",null,"See: ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TermRef Rendering Tool")),(0,s.kt)("h2",{id:"termref-rendering-tool"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,s.kt)("h2",{id:"use-case"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used."),(0,s.kt)("h2",{id:"versiontag"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h2",{id:"vocabulary"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("p",null,"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("h2",{id:"writer"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("p",null,"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.")),(0,s.kt)(r.Z,{value:"terms",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are curated within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". It is formatted as a ",(0,s.kt)("inlineCode",{parentName:"p"},"markdowntable"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":terms" converter="markdown-table-row"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Term"),(0,s.kt)("th",{parentName:"tr",align:null},"Definition"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same').")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("td",{parentName:"tr",align:null},"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("td",{parentName:"tr",align:null},"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("td",{parentName:"tr",align:null},"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("td",{parentName:"tr",align:null},"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("td",{parentName:"tr",align:null},"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("td",{parentName:"tr",align:null},"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("td",{parentName:"tr",align:null},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("td",{parentName:"tr",align:null},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("td",{parentName:"tr",align:null},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("td",{parentName:"tr",align:null},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("td",{parentName:"tr",align:null},"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"td",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking').")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("td",{parentName:"tr",align:null},"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"td"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"td",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html"))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.).")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("td",{parentName:"tr",align:null},"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("td",{parentName:"tr",align:null},"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("td",{parentName:"tr",align:null},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("td",{parentName:"tr",align:null},"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("td",{parentName:"tr",align:null},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("td",{parentName:"tr",align:null},"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("td",{parentName:"tr",align:null},"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("td",{parentName:"tr",align:null},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("td",{parentName:"tr",align:null},"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("td",{parentName:"tr",align:null},"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"td"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"td"},"mental-model"),").")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("td",{parentName:"tr",align:null},"a text of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("td",{parentName:"tr",align:null},"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("td",{parentName:"tr",align:null},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("td",{parentName:"tr",align:null},"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge.")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."))))),(0,s.kt)(r.Z,{value:"recent-changes",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are curated within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". It has a custom format, and is sorted according to the date of last change, as it appears in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRGEntry"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":terms" converter="| [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}}) | {{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}} | {{updated}} |\\n" sorter="{{updated}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Term"),(0,s.kt)("th",{parentName:"tr",align:null},"Definition"),(0,s.kt)("th",{parentName:"tr",align:null},"Updated"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossaryterm"},"Glossary Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarytext"},"Glossary Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions"},"Handlebars Helper Function")),(0,s.kt)("td",{parentName:"tr",align:null},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("td",{parentName:"tr",align:null})),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/concept"},"Concept")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/corpus"},"Corpus")),(0,s.kt)("td",{parentName:"tr",align:null},"the documentation that describes the ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/definition"},"Definition")),(0,s.kt)("td",{parentName:"tr",align:null},"the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a descriptive text, where the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," refers to a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", and the descriptive text enables a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),". Ideally, the descriptive text is a criterion that such ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can use to determine what is, and what is not, an instance (or example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with various meanings that they may have in different contexts."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossary"},"Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantics"},"Semantics")),(0,s.kt)("td",{parentName:"tr",align:null},"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," - their meaning."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tag"},"Tag")),(0,s.kt)("td",{parentName:"tr",align:null},"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/terminology"},"Terminology Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),", its (intangible) ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", and the artifacts we use to document that ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),", such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("td",{parentName:"tr",align:null},"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("td",{parentName:"tr",align:null},"20220606")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that relates a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (ideas), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."),(0,s.kt)("td",{parentName:"tr",align:null},"20220607")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("td",{parentName:"tr",align:null},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20220727")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/grouptag"},"Grouptag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopetag"},"Scopetag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/versiontag"},"Versiontag")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220728")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curatedir"},"Curatedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/glossarydir"},"Glossarydir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which the different versions of its (",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"machine readable")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," are created and maintained."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scopedir"},"Scopedir")),(0,s.kt)("td",{parentName:"tr",align:null},"a directory in a computer file system that contains all files that are either being ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", or generated to serve some purpose within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220729")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-text"},"Curated Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that documents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", and specifies, e.g., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," by which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," refers thereto, its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", and any other relevant information."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/renderable-ref"},"Renderable Ref")),(0,s.kt)("td",{parentName:"tr",align:null},"a text with which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scope"},"Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the extent of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," and other documentation that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", which we call the ",(0,s.kt)("a",{href:"/framework/docs/terms/owner",title:"Owner (of an Entity): the role that a Party performs when it is exercising its legal, rightful or natural title to control that Entity."},"owner")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") needs to express, communicate and validate its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge")," as relevant to achieving a specific subset of its ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/scoped-term"},"Scoped Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that represents (and identifies) a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," (or ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-ref"},"TermRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), enabling it to be rendered in a variety of ways for the purpose of helping ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220804")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term"},"Term")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220809")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/termid"},"Termid")),(0,s.kt)("td",{parentName:"tr",align:null},"a text of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":")," that serves as an unambiguous identifier for a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," in some given ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220809")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrg-entry"},"MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("td",{parentName:"tr",align:null},"20220811")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology"},"Terminology")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," of a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (e.g. a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"), enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("td",{parentName:"tr",align:null},"20220811")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion-profile"},"Ingestion Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a method by which files that are in a particular place and format (e.g., wiki files) are turned into a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220817")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2"},"TEv2")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of specifications and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"tools")," that caters for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curation")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20220919")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/navpath"},"Navpath")),(0,s.kt)("td",{parentName:"tr",align:null},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("td",{parentName:"tr",align:null},"20221006")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/synonym"},"Synonym (of a [term](@))")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that has the same (or sufficiently similar) meaning as another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (i.e., the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," of which it is a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonym"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20221127")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Author")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/body"},"Body (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/body-file"},"Body File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/conceptualization"},"Conceptualization")),(0,s.kt)("td",{parentName:"tr",align:null},"a mental representation or abstract idea formed by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curate"},"Curate")),(0,s.kt)("td",{parentName:"tr",align:null},"to select, organize, and present ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curator"},"Curator (of a Scope)")),(0,s.kt)("td",{parentName:"tr",align:null},"a person responsible for curating, managing, and maintaining the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,s.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("td",{parentName:"tr",align:null},"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Header (of a Curated Text)")),(0,s.kt)("td",{parentName:"tr",align:null},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/reader"},"Reader")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that reads a text that is authored by another person (its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"), and that tries to understand the meaning of this text in the way its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("td",{parentName:"tr",align:null},"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/author"},"Writer")),(0,s.kt)("td",{parentName:"tr",align:null},"a person that creates a text that is meant to be read and understood by others - usually, a particular audience."),(0,s.kt)("td",{parentName:"tr",align:null},"20230723")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase"},"Form Phrase (for a Semantic Unit)")),(0,s.kt)("td",{parentName:"tr",align:null},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/formatted-text"},"Formatted Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that has been processed and arranged to have a specific layout, style, and presentation, making it visually appealing and easy to read."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-template"},"Handlebars Template")),(0,s.kt)("td",{parentName:"tr",align:null},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrd"},"Human Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrdt"},"Human Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrd",title:"Human Readable Dictionary: a Dictionary that presents terms and their meanings in a format that is easily understandable and accessible to humans, typically organized alphabetically."},"Human Readable Dictionaries (HRDs)"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg"},"Human Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-entry"},"HRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"A specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/hrg-list"},"HRG List")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of alphabetically sorted ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," that can be further processed by tools such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),", as well as rendering tools such as GitHub pages, Docusaurus, etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/hrgt"},"Human Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human Readable Glossaries (HRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"specified by TEv2"),". HRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools-envisaged/ict"},"Integrity Checker Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to check the integrity and conformity of various files used in the curation and management of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", and other data within a terminology project. The ICT verifies that the files adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files"},"TEv2 file specifications"),", ensuring the consistency and accuracy of the terminology data."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/ingestion"},"Ingestion (Process)")),(0,s.kt)("td",{parentName:"tr",align:null},"the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + ",(0,s.kt)("a",{parentName:"td",href:"@"},"criteria"),") that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrd"},"Machine Readable Dictionary")),(0,s.kt)("td",{parentName:"tr",align:null},"a type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionary")," that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/mrdt"},"Machine Readable Dictionary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrd",title:"Machine Readable Dictionary: a type of Dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the Terms and their meanings."},"Machine Readable Dictionaries (MRDs)"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/mrg"},"Machine Readable Glossary")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for a particular (version of a) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is formatted in YAML, according to the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/mrg"},"TEv2 MRG specifications"),", to enable automated processing and integration with software systems."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrg-import"},"MRG Import (Tool)")),(0,s.kt)("td",{parentName:"tr",align:null},"is a tool in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," toolbox that is run within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for the purpose of obtaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs")," from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),", and putting them in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/mrgt"},"Machine Readable Glossary Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("td",{parentName:"tr",align:null},"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-form-phrase"},"Regularized Form Phrase")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized text")," that is derived from, and represents a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),". They typically appear in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regularized-text"},"Regularized Text")),(0,s.kt)("td",{parentName:"tr",align:null},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("td",{parentName:"tr",align:null},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/saf"},"Scope Administration File")),(0,s.kt)("td",{parentName:"tr",align:null},"a YAML file that contains essential data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (e.g., specifying where its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live), the relationships this ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has with other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-selection-instruction"},"Term Selection Instruction")),(0,s.kt)("td",{parentName:"tr",align:null},"an instruction that is used to select one or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," for the purpose of processing their documentation, e.g., to create an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-tool"},"TEv2 Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-toolbox"},"TEv2 Toolbox")),(0,s.kt)("td",{parentName:"tr",align:null},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/tools/trrt"},"TermRef Rendering Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," that is designed to facilitate the visualization and rendering of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230731")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/term-type"},"Term Type")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text")," that identifies a particular ",(0,s.kt)("em",{parentName:"td"},"kind")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Examples include ",(0,s.kt)("inlineCode",{parentName:"td"},"concept"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"relation"),", ",(0,s.kt)("inlineCode",{parentName:"td"},"pattern")," (or ",(0,s.kt)("inlineCode",{parentName:"td"},"mental-model"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20230801")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers"},"Terminology Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20230929")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/curated-file"},"Curated File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that is located in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and is (therefore) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," by (one of) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/files/curated-text-file"},"Curated Text File")),(0,s.kt)("td",{parentName:"tr",align:null},"a file that contains either a (complete) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," and a reference to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"file")," that contains its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/current-scope"},"Current Scope")),(0,s.kt)("td",{parentName:"tr",align:null},"the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is the context within which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator")," is acting, or a tool is being called."),(0,s.kt)("td",{parentName:"tr",align:null},"20231009")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg"},"Provisional MRG")),(0,s.kt)("td",{parentName:"tr",align:null},"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"provisional MRG entries"),", to which such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg-entry",title:"Provisional MRG Entry: an MRG Entry that is part of a Provisional MRG (under construction); it contains 'raw' data that documents (the Semantic Unit referred to by) a Term, that is obtained either from (the Header of) a Curated Text, or from an MRG Entry of some existing MRG."},"entries")," can be added, removed or modified, as specified by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),", and that are ultimately ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#post-processing",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"further processed")," to result in a proper ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231010")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/provisional-mrg-entry"},"Provisional MRG Entry")),(0,s.kt)("td",{parentName:"tr",align:null},"an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," that is part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/provisional-mrg",title:"Provisional MRG: a set of Provisional MRG Entries, to which such Entries can be added, removed or modified, as specified by Term Selection Instructions, and that are ultimately Further Processed to result in a proper MRG."},"provisional MRG")," (under construction); it contains 'raw' data that documents (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," referred to by) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", that is obtained either from (the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", or from an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of some existing ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231010")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/term-identifiers"},"Term Identifier")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231124")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/specs/syntax/mrg-refs"},"MRGRef")),(0,s.kt)("td",{parentName:"tr",align:null},"a text that is ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/syntax/mrg-refs"},"marked up (in a specific way)")," so that it refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", as well as to a specific way for creating an associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20231127")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/named-capturing-group"},"Named Capturing Group")),(0,s.kt)("td",{parentName:"tr",align:null},"a sub-pattern within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," (called a '",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group"},"capturing group"),"') that has been given a name, allowing one to refer to that sub-pattern."),(0,s.kt)("td",{parentName:"tr",align:null},"20231220")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter"},"Converter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro"},"Form Phrase Macro")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrase"),", such as plural forms, possessie extensions, verb-conjugation forms, etc."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter"},"Interpreter")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/interpreter-profile"},"Interpreter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," that are an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," is expected to populate when it is used in the context of a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," (such as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),")."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/moustache-variable"},"Moustache Variable")),(0,s.kt)("td",{parentName:"tr",align:null},"a placeholder in the form of a 'moustache' tag, e.g.: ",(0,s.kt)("inlineCode",{parentName:"td"},"{{variable_name}}"),", that are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to produce a text by which a text construct that is located by an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," will be replaced. See also ",(0,s.kt)("a",{parentName:"td",href:"https://mustache.github.io/mustache.5.html"},"https://mustache.github.io/mustache.5.html")),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/regex"},"Regular Expression")),(0,s.kt)("td",{parentName:"tr",align:null},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/sorter"},"Sorter")),(0,s.kt)("td",{parentName:"tr",align:null},"a specification, in the form of a predefined value or a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", of the value that is to be used for sorting a list, e.g., for sorting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," within a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-list",title:"HRG List: a list of alphabetically sorted HRG Entries that can be further processed by tools such as the TRRT, as well as rendering tools such as GitHub pages, Docusaurus, etc."},"HRG list"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool"},"TEv2 Text Conversion Tool")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," whose purpose is to convert particular text constructs (such as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRefs"),") that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."),(0,s.kt)("td",{parentName:"tr",align:null},"20240108")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/front-matter"},"Front Matter")),(0,s.kt)("td",{parentName:"tr",align:null},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("td",{parentName:"tr",align:null},"20240121")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/use-case"},"Use-Case")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that captures a specific situation or example used to illustrate how a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") can be used."),(0,s.kt)("td",{parentName:"tr",align:null},"20240130")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/form-phrase-macro-map"},"Form Phrase Macro Map")),(0,s.kt)("td",{parentName:"tr",align:null},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240228")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/converter-profile"},"Converter Profile")),(0,s.kt)("td",{parentName:"tr",align:null},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("td",{parentName:"tr",align:null},"20240301")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("td",{parentName:"tr",align:null},"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240316")),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:null},(0,s.kt)("a",{parentName:"td",href:"/tev2-specifications/docs/terms/handlebars-object"},"Handlebars Object")),(0,s.kt)("td",{parentName:"tr",align:null},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("td",{parentName:"tr",align:null},"20240318"))))),(0,s.kt)(r.Z,{value:"patterns",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," lists the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models")," (or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"patterns"),") that are known within this (TEv2) scope. It is formatted in a custom format (specified by a handlebars template)."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":patterns" converter="## [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n\n{{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"decentralized-grc-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h2",{id:"decentralized-risk-management-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h2",{id:"decision-making-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h2",{id:"definition-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"duties-and-rights-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"governance-and-management-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h2",{id:"guardianship-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h2",{id:"identification-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h2",{id:"identifier-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h2",{id:"identity-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h2",{id:"jurisdiction-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"mandates-delegation-and-hiring-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h2",{id:"mental-model-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h2",{id:"party-actor-and-actions-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h2",{id:"party-representation-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h2",{id:"semantics-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h2",{id:"terminology-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h2",{id:"trust-pattern"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h2",{id:"essif-lab-world-model"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking)."),(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"The same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," can be constructed from any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for each of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental models"),", simply by generating empty strings for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that do not have ",(0,s.kt)("inlineCode",{parentName:"p"},"termtype: pattern"),". To do this, we use the following ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref"),":"),(0,s.kt)("p",{parentName:"admonition"},(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg=":patterns" converter="{{#ifValue termType equals=\'pattern\'}}## [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n{{#if glossaryText}}{{glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n{{/ifValue}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"decentralized-grc-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h2",{id:"decentralized-risk-management-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h2",{id:"decision-making-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h2",{id:"definition-pattern-2"},(0,s.kt)("a",{parentName:"h2",href:"/tev2-specifications/docs/terms/patterns/definition"},"Definition Pattern")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"mental model")," that describes the relations between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or any other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)")," that are used to refer to it, and the criteria to use for determining whether or not something is an instance (example) of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,s.kt)("h2",{id:"duties-and-rights-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"governance-and-management-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h2",{id:"guardianship-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h2",{id:"identification-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h2",{id:"identifier-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h2",{id:"identity-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h2",{id:"jurisdiction-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h2",{id:"mandates-delegation-and-hiring-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h2",{id:"mental-model-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h2",{id:"party-actor-and-actions-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h2",{id:"party-representation-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h2",{id:"semantics-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h2",{id:"terminology-pattern-2"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h2",{id:"trust-pattern-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h2",{id:"essif-lab-world-model-1"},(0,s.kt)("a",{parentName:"h2",href:"https://essif-lab.github.io/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking).")),(0,s.kt)(r.Z,{value:"latest",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the ",(0,s.kt)("inlineCode",{parentName:"p"},"latest")," version of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that we know as ",(0,s.kt)("inlineCode",{parentName:"p"},"essif-lab"),". It is formatted using ",(0,s.kt)("inlineCode",{parentName:"p"},"markdown-section-3"),"."),(0,s.kt)("p",{parentName:"admonition"},"NOTE that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are sorted by the value of their ",(0,s.kt)("inlineCode",{parentName:"p"},"glossaryText"),"."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGref")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="essif-lab:latest" converter="### [{{#if glossaryTerm}}{{noRefs glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\\n\\n{{#if glossaryText}}{{noRefs glossaryText}}{{else}}no '),"glossaryText",(0,s.kt)("inlineCode",{parentName:"p"},' was specified for this entry.{{/if}}\\n\\n" sorter="{{noRefs glossaryText}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h3",{id:"qualified-data"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/qualified-data"},"Qualified Data")),(0,s.kt)("p",null,(0,s.kt)("a",{parentName:"p",href:"@"},"data")," that comes with assurances, at least regarding its provenance and integrity (immutability), that make this data valid to be used for specific purposes of individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"attribute"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/attribute"},"Attribute")),(0,s.kt)("p",null,(0,s.kt)("a",{parentName:"p",href:"@"},"data"),", that represents a characteristic that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"attribute"),") has attributed to an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (which is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject")," of that attribute)."),(0,s.kt)("h3",{id:"communication-channel"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/communication-channel"},"Communication Channel")),(0,s.kt)("p",null,"a (digital or non-digital) means by which two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," can exchange messages with one another."),(0,s.kt)("h3",{id:"employee"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employee"},"Employee")),(0,s.kt)("p",null,"a (human or non-human (digital)) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," for whom/which it is realistic that it might execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"employer")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),")."),(0,s.kt)("h3",{id:"policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/policy"},"Policy")),(0,s.kt)("p",null,"a (set of) rules, working-instructions, preferences and other guidance for the execution of one or more kinds of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),", that ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governs")," the policy have access to and can interpret such that this results in these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," being executed as intended by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"presentation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/presentation"},"Presentation")),(0,s.kt)("p",null,"a (signed) digital message that a ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component may send to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component that contains data derived from one or more ",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verifiable")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," (that (a ",(0,s.kt)("a",{parentName:"p",href:"@"},"colleague")," component of) the ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component has received from ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer")," components of one or more ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"), as a response to a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"presentation request")," of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Verifier")," component."),(0,s.kt)("h3",{id:"presentation-request"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/presentation-request"},"Presentation Request")),(0,s.kt)("p",null,"a (signed) digital message that a ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component sends to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component asking for specific data from one or more ",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verifiable")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that are issued by specific Parties."),(0,s.kt)("h3",{id:"relation-between-concepts-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/relation"},"Relation (between Concepts)")),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,s.kt)("h3",{id:"terms-community-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terms-community"},"Terms Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that maintains a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for the purpose of avoiding misunderstandings between its members as they collaborate."),(0,s.kt)("h3",{id:"ssi-assurance-community-ssi-ac"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-assurance-community"},"SSI Assurance Community (SSI-AC)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," that supports its members as they seek to increase their confidence in the ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI infrastructure")," and/or (specific) ",(0,s.kt)("a",{parentName:"p",href:"qualified-data@"},"qualifications")," of the data exchanged through that infrastructure."),(0,s.kt)("h3",{id:"ssi-agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-agent"},"SSI Agent")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"agent@"},"digital agent")," that provides one or more of the ",(0,s.kt)("a",{parentName:"p",href:"ssi-agent@"},"ssi functionalities")," (",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet"),") to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"holder-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/holder-policy"},"Holder Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"isuer-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/issuer-policy"},"Isuer Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"revocation-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revocation-policy"},"Revocation Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"revocation component")," to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"validator-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validator-policy"},"Validator Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"validator")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"verifier-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verifier-policy"},"Verifier Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"wallet-policy"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/wallet-policy"},"Wallet Policy")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"policy@"},"digital policy")," that enables an operational ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet")," component to function in accordance with the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"."),(0,s.kt)("h3",{id:"legal-jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-jurisdiction"},"Legal Jurisdiction")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that is governed/operated by a governmental body."),(0,s.kt)("h3",{id:"participant"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/participant"},"Participant")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," is negotiating (or has negotiated) a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement"),"."),(0,s.kt)("h3",{id:"authority-centralized-or-decentralized"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/authority"},"Authority (Centralized or Decentralized)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," of which certain decisions, ideas, rules etc. are followed by other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"employer"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employer"},"Employer")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," on whose behalf a (human or non-human) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (called an ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),") might execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"."),(0,s.kt)("h3",{id:"peer-party"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-party"},"Peer Party")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that also participates in that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"guardian"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardian"},"Guardian")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has been assigned rights and duties in a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Guardianship Arrangement")," for the purpose of caring for and/or protecting/guarding/defending the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependent")," in that Guardianship Arrangement."),(0,s.kt)("h3",{id:"organization-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/organization"},"Organization")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is capable of setting ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," and making sure these are realized by ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that it has ",(0,s.kt)("a",{parentName:"p",href:"onboarding@"},"onboarded")," and/or by (vetted) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that are committed to contribute to these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"community-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/community"},"Community")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", consisting of at least two different ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (the members of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),") that seek to collaborate with each other so that each of them can achieve its individual ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," more efficiently and/or effectively."),(0,s.kt)("h3",{id:"governor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/governor"},"Governor")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"role")," that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (better: ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),") performs as it ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governs")," a (coherent) set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", within a particular focus."),(0,s.kt)("h3",{id:"term-scoped"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scoped-term"},"Term (Scoped)")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", the meaning of which is determined by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," to which it refers in a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context."),(0,s.kt)("h3",{id:"transaction-proposal"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-proposal"},"Transaction Proposal")),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," that is 'in-the-making' (ranging from an empty document to a document that would be a ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," if it were signed by all ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant"),")."),(0,s.kt)("h3",{id:"semantic-unit-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/semantic-unit"},"Semantic Unit")),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),"). Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,s.kt)("h3",{id:"identifier"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identifier"},"Identifier")),(0,s.kt)("p",null,"a character string that is being used for the identification of some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (yet may refer to 0, 1, or more ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", depending on the context within which it is being used)."),(0,s.kt)("h3",{id:"guardianship-type"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-type"},"Guardianship-type")),(0,s.kt)("p",null,"a class of ",(0,s.kt)("a",{parentName:"p",href:"guardianship-arrangement@"},"guardianship arrangements")," within the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that governs and manages them."),(0,s.kt)("h3",{id:"information-process"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/information-process"},"Information Process")),(0,s.kt)("p",null,"a coherent set of ","[actions@]"," that are (to be) performed by a single ","[party@]",", in which ",(0,s.kt)("a",{parentName:"p",href:"@"},"data")," (that is controlled by this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," is created, read, updated and/or deleted."),(0,s.kt)("h3",{id:"revocation-component"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revocation-component"},"Revocation component")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to ",(0,s.kt)("a",{parentName:"p",href:"@"},"revoke")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that are issued by its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),", according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"revocation policy"),"."),(0,s.kt)("h3",{id:"issuer"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/issuer"},"Issuer")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to construct ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," from data objects, according to the content of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"issuer"),"-Policy (specifically regarding the way in which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," is to be digitally signed), and pass it to the ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet"),"-component of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," allowing it to be issued."),(0,s.kt)("h3",{id:"validator"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validator"},"Validator")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to determine whether or not (",(0,s.kt)("a",{parentName:"p",href:"verify@"},"verified"),") data is valid to be used for some specific purpose(s)."),(0,s.kt)("h3",{id:"holder"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/holder"},"Holder")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to handle ",(0,s.kt)("a",{parentName:"p",href:"presentation-request@"},"presentation requests")," from a ",(0,s.kt)("a",{parentName:"p",href:"@"},"peer agent"),", produce the requested data (a presentation) according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"holder-policy"),", and send that in response to the request."),(0,s.kt)("h3",{id:"verifier"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verifier"},"Verifier")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to request ",(0,s.kt)("a",{parentName:"p",href:"peer-agent@"},"peer agents")," to present (provide) data from credentials (of a specified kind, issued by specified ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"), and to verify such responses (check structure, signatures, dates), according to its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"verifier policy"),"."),(0,s.kt)("h3",{id:"wallet"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/wallet"},"Wallet")),(0,s.kt)("p",null,"a component that implements the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," to securely store data as requested by ",(0,s.kt)("a",{parentName:"p",href:"colleague@"},"colleague agents"),", and to provide stored data to ",(0,s.kt)("a",{parentName:"p",href:"colleague@"},"colleague agents")," or ",(0,s.kt)("a",{parentName:"p",href:"peer-agent@"},"peer agents"),", all in ",(0,s.kt)("a",{parentName:"p",href:"@"},"compliance")," with the rules of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal"),"'s ",(0,s.kt)("a",{parentName:"p",href:"@"},"wallet policy"),"."),(0,s.kt)("h3",{id:"property-of-a-concept-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/property"},"Property (of a Concept)")),(0,s.kt)("p",null,"a connection or association between a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text or a number, that represents some characteristic that instances of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,s.kt)("h3",{id:"assertion"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/assertion"},"Assertion")),(0,s.kt)("p",null,"a declaration/statement, made by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that something is the case."),(0,s.kt)("h3",{id:"role"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/role"},"Role")),(0,s.kt)("p",null,"a defined set of characteristics that an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," has in some context, such as ",(0,s.kt)("a",{parentName:"p",href:"obligation@"},"responsibilities")," it may have, ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (behaviors) it may execute, or pieces of ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," that it is expected to have in that context, which are referenced to by a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"role name"),"."),(0,s.kt)("h3",{id:"mental-model-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mental-model"},"Mental Model")),(0,s.kt)("p",null,"a description, both casual and formal, of a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (ideas), relations between them, and constraints, that together form a coherent and consistent 'viewpoint', or 'way of thinking' about a certain topic."),(0,s.kt)("h3",{id:"pattern"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern"},"Pattern")),(0,s.kt)("p",null,"a description, both casual and formal, of a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (ideas), relations between them, and constraints, that together form a coherent and consistent 'viewpoint', or 'way of thinking' about a certain topic."),(0,s.kt)("h3",{id:"credential-catalogue"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential-catalogue"},"Credential Catalogue")),(0,s.kt)("p",null,"a functional component that has the ",(0,s.kt)("a",{parentName:"p",href:"capability-of-an-actor@"},"capability")," to register and advertise the information about ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential types")," that their respective ",(0,s.kt)("a",{parentName:"p",href:"governance@"},"governing parties")," have decided to disclose so as to enable other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to decide whether or not it is beneficial for them to use ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," of such types."),(0,s.kt)("h3",{id:"semantics-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/semantics"},"Semantics")),(0,s.kt)("p",null,"a mapping between the (tangible/textual) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and (intangible) ideas/",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," - their meaning."),(0,s.kt)("h3",{id:"compliance-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-level"},"Compliance level")),(0,s.kt)("p",null,"a measure for stating how well an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," conforms with a stated (set of) requirement(s)."),(0,s.kt)("h3",{id:"risk-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-level"},"Risk level")),(0,s.kt)("p",null,"a measure for the deviation of the intended realization (results) of a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," uses to represent the priority with which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," of that ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," should be reckoned with."),(0,s.kt)("h3",{id:"control-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-level"},"Control level")),(0,s.kt)("p",null,"a measure for the efficiency and effectiveness in which a ",(0,s.kt)("a",{parentName:"p",href:"controller@"},"control")," produces the results specified by its ",(0,s.kt)("a",{parentName:"p",href:"@"},"control objective")),(0,s.kt)("h3",{id:"transaction-request"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-request"},"Transaction Request")),(0,s.kt)("p",null,"a message, send by a requesting ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to a providing ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that initiates the negotiation of a new ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction agreement")," between these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," for the provisioning of a specific product or service."),(0,s.kt)("h3",{id:"terminology-process-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terminology-process"},"Terminology Process")),(0,s.kt)("p",null,"a method for recognizing misunderstandings as such, and creating or maintaining ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," that resolve them."),(0,s.kt)("h3",{id:"human-being"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/human-being"},"Human Being")),(0,s.kt)("p",null,"a person of flesh and blood (homo sapiens), that we classify both as a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),",an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),", and a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h3",{id:"risk-management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-management"},"Risk management")),(0,s.kt)("p",null,"a process that is run by (or on behalf of) a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for the purpose of ",(0,s.kt)("a",{parentName:"p",href:"management@"},"managing")," the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," that it ",(0,s.kt)("a",{parentName:"p",href:"@"},"owns")," (thereby realizing specific ",(0,s.kt)("a",{parentName:"p",href:"risk-objective@"},"risk objectives"),")."),(0,s.kt)("h3",{id:"onboarding"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/onboarding"},"Onboarding")),(0,s.kt)("p",null,"a process that is run for a specific (set of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," on behalf of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that terminates successfully if and only if the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has (a) established the suitability of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," for executing certain kinds of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on its behalf, (b) ensured that their mutual rights and duties are properly specified and will be appropriately enforced, and (c) provided the circumstances/contexts within which the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is enabled to do so."),(0,s.kt)("h3",{id:"control-process"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-process"},"Control Process")),(0,s.kt)("p",null,"a process, ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," and run by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", to ensure that a specific subset of its control ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," are realized."),(0,s.kt)("h3",{id:"ownership"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ownership"},"Ownership")),(0,s.kt)("p",null,"a relationship between two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that exists within the ",(0,s.kt)("a",{parentName:"p",href:"@"},"scope of control")," of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),", in which one of them (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") has legal, rightful or natural rights and/or duties to enjoy, dispose of, and control the other (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned"),")."),(0,s.kt)("h3",{id:"mandate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mandate"},"Mandate")),(0,s.kt)("p",null,"a right or duty that one ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"mandate@"},"mandator"),") has granted to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," or ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," (the ",(0,s.kt)("a",{parentName:"p",href:"mandate@"},"mandatee"),") for executing a specific (set of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," in the name of, and under responsibility/accountability of, this (first) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"identity-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identity"},"Identity Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"identity@"},"digital identities")," work, how this relates to (attributes in) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credentials"),", and how all this can be made to work in ",(0,s.kt)("a",{parentName:"p",href:"@"},"SSI")," contexts."),(0,s.kt)("h3",{id:"identifier-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identifier"},"Identifier Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{parentName:"p",href:"@"},"identifiers")," are defined and used for ",(0,s.kt)("a",{parentName:"p",href:"@"},"identification")," purposes."),(0,s.kt)("h3",{id:"party-representation-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-party-representation"},"Party Representation Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can be represented in various circumstances."),(0,s.kt)("h3",{id:"governance-and-management-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-governance-and-management"},"Governance and Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," organize that their ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives")," are realized, either by doing the associated work themselves, or by arranging for other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to do that."),(0,s.kt)("h3",{id:"decision-making-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decision-making"},"Decision Making Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," would, could, or should reason in order to reach good conclusions and make good decisions. This can be used as a basis for understanding the information needs of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they need to decide e.g. whether or not to commit to a ",(0,s.kt)("a",{parentName:"p",href:"@"},"Transaction")," proposal, or whether or not data is ",(0,s.kt)("a",{parentName:"p",href:"@"},"valid")," for some purpose. This pattern is based on ",(0,s.kt)("a",{parentName:"p",href:"https://www.cambridge.org/core/books/uses-of-argument/26CF801BC12004587B66778297D5567C"},"Toulmin's use of arguments")," (of which a pragmatical text can be found ",(0,s.kt)("a",{parentName:"p",href:"https://owl.purdue.edu/owl/general_writing/academic_writing/historical_perspectives_on_argumentation/toulmin_argument.html"},"here"),")"),(0,s.kt)("h3",{id:"decentralized-risk-management-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decentralized-risk-management"},"Decentralized Risk Management Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how individual ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can efficiently and effectively perform their own ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk management")," processes, while taking into account that there are other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that have ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectations")," towards them."),(0,s.kt)("h3",{id:"trust-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-trust"},"Trust Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how the concept of ",(0,s.kt)("a",{parentName:"p",href:"@"},"trust")," relates to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that do the trusting, and other concepts that express what it is that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," trust."),(0,s.kt)("h3",{id:"party-actor-and-actions-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-party-actor-action"},"Party, Actor and Actions Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how things get done. It answers questions such as: 'Who/what does things?', 'How are their actions being guided/controlled?', 'Who controls whom/what?', 'Who/what may be held accountable?'."),(0,s.kt)("h3",{id:"mental-model-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-mental-model"},"Mental Model Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain how to create, maintain and use (decentralized) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/vocabulary",title:"Vocabulary: the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."},"vocabularies")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),") that groups of people can use for the specific purposes they pursue."),(0,s.kt)("h3",{id:"decentralized-grc-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-decentralized-grc"},"Decentralized GRC Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain one's thinking about topics related to Governance, Risk management and Compliance (GRC) in a decentralized context, i.e., a context in which ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," all autonomously do their own GRC."),(0,s.kt)("h3",{id:"mandates-delegation-and-hiring-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-mandates-delegation-hiring"},"Mandates, Delegation and Hiring Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the ideas behind Mandating, Delegating, Hiring and their relations."),(0,s.kt)("h3",{id:"identification-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-identification"},"Identification Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the mechanisms that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," may use to ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities"),", and mechanisms for communicating with another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," such that both ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," and know whether or not they ",(0,s.kt)("a",{parentName:"p",href:"@"},"identify")," the same ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h3",{id:"semantics-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-semantics"},"Semantics Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain the relations between the (intangible) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") that are part of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and how they are (tangibly) represented by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"attributes"),", etc."),(0,s.kt)("h3",{id:"guardianship-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-guardianship"},"Guardianship Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship")," consists of, and how it relates to ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardians"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"dependents"),", ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", etc."),(0,s.kt)("h3",{id:"jurisdiction-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-jurisdiction"},"Jurisdiction Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," consists of, and relates it to ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h3",{id:"duties-and-rights-pattern-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-duties-and-rights"},"Duties and Rights Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that can be used to explain what a generic duties and rights consists of (based on ",(0,s.kt)("a",{parentName:"p",href:"https://plato.stanford.edu/entries/rights/#FormRighHohfAnalSyst"},"Hofeld's theories"),"), and relates it to ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdictions"),", ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities"),"."),(0,s.kt)("h3",{id:"terminology-pattern-3"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-terminology"},"Terminology Pattern")),(0,s.kt)("p",null,"a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," that one can use to explain one's thinking about a certain topic, as well as to devise/design a way of thinking that members of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," can use to align their thinking as they pursue that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"objectives"),"."),(0,s.kt)("h3",{id:"framework-conceptual"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/framework"},"Framework (Conceptual)")),(0,s.kt)("p",null,"a set of assumptions, concepts, values, and practices that constitutes a way of viewing reality."),(0,s.kt)("h3",{id:"ecosystem"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ecosystem"},"Ecosystem")),(0,s.kt)("p",null,"a set of at least two (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (its 'members') whose individual work complements that of other members, and is of benefit to the set as a whole."),(0,s.kt)("h3",{id:"normative-framework"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/normative-framework"},"Normative framework")),(0,s.kt)("p",null,"a set of rules that are followed and/or criteria that remain fulfilled by (a specific kind of) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," whose behavior and/or properties are characterized as 'normal'."),(0,s.kt)("h3",{id:"legal-system"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-system"},"Legal System")),(0,s.kt)("p",null,"a system in which rules are defined, and mechanisms for their enforcement and conflict resolution are (implicitly or explicitly) specified."),(0,s.kt)("h3",{id:"definition-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/definition"},"Definition")),(0,s.kt)("p",null,"a text that helps ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to have the same understanding about the meaning of (and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," behind) a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", ideally in such a way that these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," can determine whether or not they make the same distinction."),(0,s.kt)("h3",{id:"communication-session"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/communication-session"},"Communication Session")),(0,s.kt)("p",null,"a time interval during which two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," have an established ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication channel")," that does not exist outside of that time interval."),(0,s.kt)("h3",{id:"term-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/term"},"Term")),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used in at least one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"/context to represent a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h3",{id:"partial-identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/partial-identity"},"Partial identity")),(0,s.kt)("p",null,"all ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," that a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (= the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the partial identity) has about that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (= the '",(0,s.kt)("a",{parentName:"p",href:"@"},"subject"),"' of the partial identity)."),(0,s.kt)("h3",{id:"identify"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identify"},"Identify")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act"),", by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that results in the selection of either"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{parentName:"li",href:"@"},"partial identity")," that the party ",(0,s.kt)("a",{parentName:"li",href:"@"},"owns"),", given some (observed or received) data, or"),(0,s.kt)("li",{parentName:"ul"},"a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," from a given set of entities that is the ",(0,s.kt)("a",{parentName:"li",href:"@"},"subject")," of a specified ",(0,s.kt)("a",{parentName:"li",href:"@"},"partial identity")," that the party ",(0,s.kt)("a",{parentName:"li",href:"@"},"owns"),".")),(0,s.kt)("h3",{id:"agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/agent"},"Agent")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," that is executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (called the ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor"),")."),(0,s.kt)("h3",{id:"dependent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/dependent"},"Dependent")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the caring for and/or protecting/guarding/defending of which a ",(0,s.kt)("a",{parentName:"p",href:"@"},"guardianship arrangement")," has been established."),(0,s.kt)("h3",{id:"owned"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/owned"},"Owned")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," over which another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") has the power (duty, right) to enjoy it, dispose of it and control it; that power is limited to (the scope of) that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),", and by its rules."),(0,s.kt)("h3",{id:"legal-entity-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/legal-entity"},"Legal Entity")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that is known by, recognized to exist, and registered in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction"),"."),(0,s.kt)("h3",{id:"party-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/party"},"Party")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," that sets its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", maintains its ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", and uses that ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," to pursue its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," in an autonomous (sovereign) manner. Humans and ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization")," are the typical examples."),(0,s.kt)("h3",{id:"mission"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/mission"},"Mission")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that provides an answer to the question why that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," exists - i.e. its 'raison d'\xeatre'."),(0,s.kt)("h3",{id:"expectation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/expectation"},"Expectation")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that is ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for having a specific (set of) result(s) produced, where the actual production thereof is (going to be) outsourced to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"obligation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/obligation"},"Obligation")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," that is ",(0,s.kt)("a",{parentName:"p",href:"@"},"owned")," by the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for producing a specific (set of) result(s) that are to be used (consumed) by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," and/or other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),"."),(0,s.kt)("h3",{id:"control-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control-objective"},"Control Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to contribute to the realization of another (set of) ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", by producing results that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," needs to realize these other ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"compliance-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-objective"},"Compliance Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to reach and maintain a state of affairs in which a specific set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," controls are in accordance with a specific set of requirements (e.g., laws, regulations, standards, etc.)."),(0,s.kt)("h3",{id:"risk-objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-objective"},"Risk Objective")),(0,s.kt)("p",null,"an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", owned by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", that aims to reach and maintain a state of affairs in which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," associated with a specific set of its ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," become, and/or remain, acceptable."),(0,s.kt)("h3",{id:"employment-contract"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/employment-contract"},"Employment Contract")),(0,s.kt)("p",null,"an agreement/contract between two ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", one of which controls a set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject")," of the contract), that states (or refers to) all (sets of) rights and duties under which these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," can and/or must work for the other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"glossary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/glossary"},"Glossary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," with the (single) meaning it has in (at least) one context."),(0,s.kt)("h3",{id:"dictionary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/dictionary"},"Dictionary")),(0,s.kt)("p",null,"an alphabetically sorted list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," with various meanings they may have in different contexts."),(0,s.kt)("h3",{id:"tag-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/tag"},"Tag")),(0,s.kt)("p",null,"an alphanumeric string that is used to identify ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (so called 'scopetags'), group ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (so called 'grouptags'), or identify a specific version of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," (so called 'versiontags') from within a specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,s.kt)("h3",{id:"advertisement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/advertisement"},"Advertisement")),(0,s.kt)("p",null,"an offer by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to provide a (type of) ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", where the offer includes (a reference to) the syntax and semantics specifications of that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", and also lists various other characteristics that enable other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to decide whether or not a ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," that the advertising ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has issued under this offer, is ",(0,s.kt)("a",{parentName:"p",href:"validate@"},"valid")," to be processed in one or more of its ",(0,s.kt)("a",{parentName:"p",href:"information-process@"},"information processes"),"."),(0,s.kt)("h3",{id:"transaction-id"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-id"},"Transaction Id")),(0,s.kt)("p",null,"character string that this ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," uses to identify, and refer to, that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"credential"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential"},"Credential")),(0,s.kt)("p",null,"data, representing a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"assertion")," (claims, statements), authored and signed by, or on behalf of, a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"actor-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/actor"},"Actor")),(0,s.kt)("p",null,"entity that can act (do things/execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),"), e.g. people, machines, but not ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/organization",title:"Organization: a Party that is capable of setting Objectives and making sure these are realized by Actors that it has Onboarded and/or by (vetted) Parties that are committed to contribute to these Objectives."},"organization"),"."),(0,s.kt)("h3",{id:"guardianship-arrangement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-arrangement"},"Guardianship Arrangement")),(0,s.kt)("p",null,"guardianship Arrangement (in a Jurisdiction): the specification of a set of rights and duties between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that enforces these rights and duties, for the purpose of caring for and/or protecting/guarding/defending one or more of these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"entities"),"."),(0,s.kt)("h3",{id:"role-name"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/role-name"},"Role name")),(0,s.kt)("p",null,"name (text) that refers to (and identifies) a ",(0,s.kt)("a",{parentName:"p",href:"@"},"role")," in a specific context."),(0,s.kt)("h3",{id:"self-sovereign-identity-ssi"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/self-sovereign-identity"},"Self-Sovereign Identity (SSI)")),(0,s.kt)("p",null,"self-Sovereign Identity (SSI) is a term that has many different interpretations, and that we use to refer to concepts/ideas, architectures, processes and technologies that aim to support (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they negotiate and execute electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction")," with one another."),(0,s.kt)("h3",{id:"entity-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/entity"},"Entity")),(0,s.kt)("p",null,"someone or something that is known to exist."),(0,s.kt)("h3",{id:"data"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/data"},"Data")),(0,s.kt)("p",null,"something (tangible) that can be used to communicate a meaning (which is intangible/information)."),(0,s.kt)("h3",{id:"action-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/action"},"Action")),(0,s.kt)("p",null,"something that is actually done (a 'unit of work' that is executed) by a single ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," (on behalf of a given ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"), as a single operation, in a specific context."),(0,s.kt)("h3",{id:"objective"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/objective"},"Objective")),(0,s.kt)("p",null,"something toward which a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner"),") directs effort (an aim, goal, or end of action)."),(0,s.kt)("h3",{id:"scope-essiflabterminology"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/eSSIFLab-scope"},"Scope: essifLabTerminology")),(0,s.kt)("p",null,"specification of the eSSIF-Lab scope."),(0,s.kt)("h3",{id:"ssi-self-sovereign-identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi"},"SSI (Self-Sovereign Identity)")),(0,s.kt)("p",null,"sSI (Self-Sovereign Identity) is a term that has many different interpretations, and that we use to refer to concepts/ideas, architectures, processes and technologies that aim to support (autonomous) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," as they negotiate and execute electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction")," with one another."),(0,s.kt)("h3",{id:"knowledge"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/knowledge"},"Knowledge")),(0,s.kt)("p",null,"the (intangible) sum of what is known by a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", as well as the familiarity, awareness or understanding of someone or something by that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"capability-of-a-party"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/capability"},"Capability (of a Party)")),(0,s.kt)("p",null,"the (named) combination of (a) the means of a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to get something done, (b) the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"governance")," process that ensures that its (business) ",(0,s.kt)("a",{parentName:"p",href:"@"},"policies")," for getting that something done are being created and maintained, and (c) the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"management")," process that creates and maintains the (operational) ",(0,s.kt)("a",{parentName:"p",href:"@"},"policies"),", such that every ",(0,s.kt)("a",{parentName:"p",href:"@"},"employee")," that has a task in getting this something done can find and interpret a ",(0,s.kt)("a",{parentName:"p",href:"@"},"policy")," and use it as it executes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," in such tasks."),(0,s.kt)("h3",{id:"subject"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/subject"},"Subject")),(0,s.kt)("p",null,"the (single) ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," to which a given set of coherent data relates/pertains. Examples of such sets include attributes, ",(0,s.kt)("a",{parentName:"p",href:"assertion@"},"Claims/Assertions"),", files/dossiers, ",(0,s.kt)("a",{parentName:"p",href:"credential@"},"(verifiable) credentials"),", ",(0,s.kt)("a",{parentName:"p",href:"partial-identity@"},"(partial) identities"),", ",(0,s.kt)("a",{parentName:"p",href:"employment-contract@"},"employment contracts"),", etc."),(0,s.kt)("h3",{id:"trust-level"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/trust-level"},"Trust level")),(0,s.kt)("p",null,"the (subjective) degree of belief or confidence that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has in X (someone, something, ...)."),(0,s.kt)("h3",{id:"trust"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/trust"},"Trust")),(0,s.kt)("p",null,"the (un)conscious decision by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to believe that X is in fact the case."),(0,s.kt)("h3",{id:"governance"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/governance"},"Governance")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act")," or process of governing or overseeing the realization of (the results associated with) a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," by the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),", in order to ensure they will be fit for the purposes that this ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," intends to use them for."),(0,s.kt)("h3",{id:"management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/management"},"Management")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"act")," or process of managing or actually realizing of (the results associated with) a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," by the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of these ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective"),"."),(0,s.kt)("h3",{id:"peer-actor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-actor"},"Peer Actor")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," with whom/which this other ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is communicating in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication session"),"."),(0,s.kt)("h3",{id:"peer-agent"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/peer-agent"},"Peer-agent")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," with whom/which this other ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," is communicating in that ",(0,s.kt)("a",{parentName:"p",href:"@"},"communication session"),"."),(0,s.kt)("h3",{id:"controllership"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/controllership"},"Controllership")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{parentName:"p",href:"@"},"capability")," of an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," to execute ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," on a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the purpose of ensuring that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," will act/behave, or be used, in a particular way."),(0,s.kt)("h3",{id:"principal"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/principal"},"Principal")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for whom, or on behalf of whom, the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," is then called an ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),")."),(0,s.kt)("h3",{id:"risk-owner"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk-owner"},"Risk Owner")),(0,s.kt)("p",null,"the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"owner")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," to which a ",(0,s.kt)("a",{parentName:"p",href:"@"},"risk")," is associated."),(0,s.kt)("h3",{id:"validate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/validate"},"Validate")),(0,s.kt)("p",null,"the act, by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", of determining whether or not that data is valid to be used for some specific purpose(s) of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"verify"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/verify"},"Verify")),(0,s.kt)("p",null,"the act, by or on behalf of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),", of determining whether that data is authentic (i.e. originates from the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that authored it), timely (i.e. has not expired), and conforms to other specifications that apply to its structure."),(0,s.kt)("h3",{id:"revokerevocation"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/revoke"},"Revoke/Revocation")),(0,s.kt)("p",null,"the act, by or on behalf of the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that has issued the ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),", of no longer vouching for the correctness or any other qualification of (arbitrary parts of) that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential"),"."),(0,s.kt)("h3",{id:"self-sovereignty"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/self-sovereignty"},"Self-Sovereignty")),(0,s.kt)("p",null,"the characteristic of every ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that it is autonomous in managing and operating its ",(0,s.kt)("a",{parentName:"p",href:"@"},"owns")," ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge"),", particularly in making decisions and deciding how to decide."),(0,s.kt)("h3",{id:"assessment-framework"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/assessment-framework"},"Assessment Framework")),(0,s.kt)("p",null,"the combination of a set of criteria that an auditor can assess by applying them to an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," (of a specific kind), and the procedures that this auditor will follow for doing so, for the purpose of establishing the extent in which that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," conforms to a stated set of requirements."),(0,s.kt)("h3",{id:"control"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/control"},"Control")),(0,s.kt)("p",null,"the combination of resources (e.g. people, tools, budgets, time) and processes that are tasked to realize a specific ",(0,s.kt)("a",{parentName:"p",href:"@"},"control objective")," of a particular ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"identity"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/identity"},"Identity")),(0,s.kt)("p",null,"the combined ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," about that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," of all ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties"),", i.e. the union of all ",(0,s.kt)("a",{parentName:"p",href:"partial-identity@"},"partial identities")," of which that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," is the ",(0,s.kt)("a",{parentName:"p",href:"@"},"subject"),"."),(0,s.kt)("h3",{id:"jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/jurisdiction"},"Jurisdiction")),(0,s.kt)("p",null,"the composition of a ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," (legislation, enforcement thereof, and conflict resolution), a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," that governs that ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system"),", a scope within which that ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," is operational, and one or more ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," for the purpose of which the ",(0,s.kt)("a",{parentName:"p",href:"@"},"legal system")," is operated. See also the ",(0,s.kt)("a",{parentName:"p",href:"pattern:jurisdiction@"},"Jurisdictions pattern"),"."),(0,s.kt)("h3",{id:"decision"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/decision"},"Decision")),(0,s.kt)("p",null,"the conclusion that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," inferences from a set of ",(0,s.kt)("a",{parentName:"p",href:"@"},"data")," that it considers to be facts."),(0,s.kt)("h3",{id:"commitment-decision"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/commitment-decision"},"Commitment Decision")),(0,s.kt)("p",null,"the decision of that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," whether or not to commit to that ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),", i.e. (promise) to fulfill the ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," that the associated ",(0,s.kt)("a",{parentName:"p",href:"transaction-proposal@"},"transaction agreement proposal")," would impose on that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," once it were signed."),(0,s.kt)("h3",{id:"corpus-of-terminology"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/corpus"},"Corpus of Terminology")),(0,s.kt)("p",null,"the documentation that describes the ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," around a set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),"."),(0,s.kt)("h3",{id:"risk"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/risk"},"Risk")),(0,s.kt)("p",null,"the effects that uncertainty (i.e. a lack of information, understanding or ",(0,s.kt)("a",{parentName:"p",href:"@"},"knowledge")," of events, their consequences or likelihoods) can have on the intended realization of an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"transaction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction"},"Transaction")),(0,s.kt)("p",null,"the exchange of goods, services, funds, or data between some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," (called ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction"),")."),(0,s.kt)("h3",{id:"scope-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scope"},"Scope")),(0,s.kt)("p",null,"the extent of the area or subject matter (which we use, e.g., to define ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," in, but it serves other purposes as well)."),(0,s.kt)("h3",{id:"scope-of-control"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/scope-of-control"},"Scope of Control")),(0,s.kt)("p",null,"the extent of the area or subject matter that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," ",(0,s.kt)("a",{parentName:"p",href:"controller@"},"controls"),"."),(0,s.kt)("h3",{id:"concept-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/concept"},"Concept")),(0,s.kt)("p",null,"the ideas/thoughts behind a classification of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," (what makes ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," in that class 'the same')."),(0,s.kt)("h3",{id:"capability-of-an-actor"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/capability-of-an-actor"},"Capability (of an Actor)")),(0,s.kt)("p",null,"the potential of an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," to execute a (named) coherent set of ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action")," (a 'function', or 'task') on behalf of some ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"compliance-management"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance-management"},"Compliance management")),(0,s.kt)("p",null,"the process that is run by (or on behalf of) a specific ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," for the purpose of ",(0,s.kt)("a",{parentName:"p",href:"management@"},"managing")," its ",(0,s.kt)("a",{parentName:"p",href:"compliance-objective@"},"compliance objectives"),"."),(0,s.kt)("h3",{id:"documentation-interoperability"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/documentation-interop"},"Documentation Interoperability")),(0,s.kt)("p",null,"the property that a documentation system of making its content comprehensible for a variety of people that come from different backgrounds."),(0,s.kt)("h3",{id:"owner"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/owner"},"Owner")),(0,s.kt)("p",null,"the role that a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," performs when it is exercising its legal, rightful or natural title to control that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity"),"."),(0,s.kt)("h3",{id:"controller"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/controller"},"Controller")),(0,s.kt)("p",null,"the role that an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/actor",title:"Actor: Entity that can act (do things/execute Actions), e.g. people, machines, but not Organizations."},"actor")," performs as it is executing actions on that ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," for the purpose of ensuring that the ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entity")," will act/behave, or be used, in a particular way."),(0,s.kt)("h3",{id:"essif-lab-world-model-2"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/pattern-world-model"},"eSSIF-Lab World Model")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", relations between them (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mental-model",title:"Mental Model: a Semantic Unit that relates a set of Concepts (ideas), Relations between them, and constraints about a certain topic, into a coherent and consistent whole (sometimes called 'viewpoint', or 'way of thinking')."},"pattern"),"), and ",(0,s.kt)("a",{parentName:"p",href:"essifLab-principles"},"Principles")," (that are the starting point for eSSIF-Lab's thinking)."),(0,s.kt)("h3",{id:"terminology-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/terminology"},"Terminology")),(0,s.kt)("p",null,"the set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that are used within a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to refer to a single ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", enabling ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," to reason and communicate ideas they have about one or more specific topics."),(0,s.kt)("h3",{id:"transaction-agreement"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-agreement"},"Transaction Agreement")),(0,s.kt)("p",null,"the set of rules that specify the rights (",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation"),") and duties (",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation"),") of ",(0,s.kt)("a",{parentName:"p",href:"@"},"participant")," towards one another in the context of a specific ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction"),"."),(0,s.kt)("h3",{id:"guardianship-in-a-jurisdiction"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/guardianship-arrangement"},"Guardianship (in a Jurisdiction)")),(0,s.kt)("p",null,"the specification of a set of rights and duties between ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"legal entities")," of the ",(0,s.kt)("a",{parentName:"p",href:"@"},"jurisdiction")," that enforces these rights and duties, for the purpose of caring for and/or protecting/guarding/defending one or more of these ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/legal-entity",title:"Legal Entity (of a Jurisdiction): an Entity that is known by, recognized to exist, and registered in that Jurisdiction."},"entities"),". (Synonym of ",(0,s.kt)("a",{parentName:"p",href:"@"},"Guardianship Arrangement"),")"),(0,s.kt)("h3",{id:"credential-type"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/credential-type"},"Credential Type")),(0,s.kt)("p",null,"the specification of the contents, properties, constraints etc. that ",(0,s.kt)("a",{parentName:"p",href:"@"},"credential")," of this type must have/comply with."),(0,s.kt)("h3",{id:"transaction-form"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/transaction-form"},"Transaction Form")),(0,s.kt)("p",null,"the specification of the set of data that this ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," needs to (a) commit to a (proposed) ",(0,s.kt)("a",{parentName:"p",href:"transaction@"},"business transaction")," of that kind, (b) fulfill its duties/",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," and (c) escalate if necessary."),(0,s.kt)("h3",{id:"outsourcing"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/outsourcing"},"Outsourcing")),(0,s.kt)("p",null,"the state of affairs in which a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," has an ",(0,s.kt)("a",{parentName:"p",href:"@"},"objective")," (better: an ",(0,s.kt)("a",{parentName:"p",href:"@"},"expectation"),") for the realization of a (set of) result(s), where the actual production of these results is expected to be done by a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," other than itself."),(0,s.kt)("h3",{id:"compliance"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/compliance"},"Compliance")),(0,s.kt)("p",null,"the state of realization of a set of conformance criteria or normative framework of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party"),"."),(0,s.kt)("h3",{id:"vocabulary-1"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/vocabulary"},"Vocabulary")),(0,s.kt)("p",null,"the sum or stock of words employed by a language, group, individual, or work or in a field of knowledge."),(0,s.kt)("h3",{id:"ssi-infrastructure"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/ssi-infrastructure"},"SSI Infrastructure")),(0,s.kt)("p",null,"the technological components that are (envisaged to be) all over the world for the purpose of providing, requesting and obtaining ",(0,s.kt)("a",{parentName:"p",href:"@"},"qualified data"),", for the purpose of negotiating and/or executing electronic ",(0,s.kt)("a",{parentName:"p",href:"@"},"transaction"),"."),(0,s.kt)("h3",{id:"delegate"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/delegate"},"Delegate")),(0,s.kt)("p",null,"the transferral of ",(0,s.kt)("a",{parentName:"p",href:"@"},"ownership")," of one or more ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegator"),"), including the associated accountability, to another ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegatee"),")), which implies that the ",(0,s.kt)("a",{parentName:"p",href:"delegate@"},"delegatee")," can realize such ",(0,s.kt)("a",{parentName:"p",href:"@"},"obligation")," as it sees fit."),(0,s.kt)("h3",{id:"define-1"},(0,s.kt)("a",{parentName:"h3",href:"https://tno-terminology-design.github.io/tev2-specifications/docs/terms/define"},"Define")),(0,s.kt)("p",null,"to provide a criterion and a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", where the criterion can be used by people to determine whether or not something is an instance/example of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"), and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is used to refer to that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),", or an arbitrary instance thereof."),(0,s.kt)("h3",{id:"colleague"},(0,s.kt)("a",{parentName:"h3",href:"/framework/docs/terms/colleague"},"Colleague")),(0,s.kt)("p",null,"two or more (digital or non-digital) ",(0,s.kt)("a",{parentName:"p",href:"@"},"agent")," that have the same ",(0,s.kt)("a",{parentName:"p",href:"@"},"principal")," (i.e. ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," on whose behalf they are executing an ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/action",title:"Action: something that is actually done (a 'unit of work' that is executed) by a single Actor (on behalf of a given Party), as a single operation, in a specific context."},"action"),").")),(0,s.kt)(r.Z,{value:"glossary-and-abbrs",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," for the default ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," within this (TEv2) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", in the same format as defined in file ",(0,s.kt)("inlineCode",{parentName:"p"},"terminology-config.yaml"),", but now with the specification of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," placed inline."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" con[1]="markdown-table-row" con[2]="markdown-abbr-table-row"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:null},"Abbreviation"),(0,s.kt)("th",{parentName:"tr",align:null},"Refers to")))),(0,s.kt)("p",null,'{% hrg="" con',"[1]",'="markdown-table-row" con',"[2]",'="markdown-abbr-table-row" %}')),(0,s.kt)(r.Z,{value:"glossary-with-notes",mdxType:"TabItem"},(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"This is the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that shows that you can add notes to a glossary entry.\nFor this purpose, we use a custom converter that"),(0,s.kt)("ol",{parentName:"admonition"},(0,s.kt)("li",{parentName:"ol"},"only creates an entry for MRG entries that have an existing, non-empty ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryNotes")," field"),(0,s.kt)("li",{parentName:"ol"},"shows the notes.")),(0,s.kt)("p",{parentName:"admonition"},"We have simplified the handlebars template so that it becomes easier for readers to focus on what we have been trying to do here."),(0,s.kt)("p",{parentName:"admonition"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," that is used is ",(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" converter="{{#if glossaryNotes}}## {{noRefs glossaryTerm}}\\n\\n{{glossaryText}}\\n\\n### Notes\\n\\n{{#each glossaryNotes}}- {{this}}\\n{{/each}}\\n{{/if}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("h2",{id:"glossary-markdown-style"},"Glossary (Markdown style)"),(0,s.kt)("h3",{id:"body-file-1"},"Body File"),(0,s.kt)("p",null,"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),"."),(0,s.kt)("h4",{id:"notes-23"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"li"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),".")),(0,s.kt)("h3",{id:"body-of-a-curated-text-1"},"Body (of a Curated Text)"),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents."),(0,s.kt)("h4",{id:"notes-24"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),".")),(0,s.kt)("h3",{id:"converter-profile-1"},"Converter Profile"),(0,s.kt)("p",null,"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from."),(0,s.kt)("h4",{id:"notes-25"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",{parentName:"ul"},"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments.")),(0,s.kt)("h3",{id:"converter-1"},"Converter"),(0,s.kt)("p",null,"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output."),(0,s.kt)("h4",{id:"notes-26"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",{parentName:"ul"},"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),".")),(0,s.kt)("h3",{id:"form-phrase-macro-map-1"},"Form Phrase Macro Map"),(0,s.kt)("p",null,"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),"."),(0,s.kt)("h4",{id:"notes-27"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"li"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",{parentName:"ul"},"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"li"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"li",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),".")),(0,s.kt)("h3",{id:"form-phrase-for-a-semantic-unit-1"},"Form Phrase (for a Semantic Unit)"),(0,s.kt)("p",null,"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."),(0,s.kt)("h4",{id:"notes-28"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"li"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),".")),(0,s.kt)("h3",{id:"front-matter-1"},"Front Matter"),(0,s.kt)("p",null,"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."),(0,s.kt)("h4",{id:"notes-29"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",{parentName:"ul"},"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML.")),(0,s.kt)("h3",{id:"glossary-term-1"},"Glossary Term"),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h4",{id:"notes-30"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",{parentName:"ul"},"if the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"li"},"{{capFirst term}}"))),(0,s.kt)("h3",{id:"glossary-text-1"},"Glossary Text"),(0,s.kt)("p",null,"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),"."),(0,s.kt)("h4",{id:"notes-31"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"the ",(0,s.kt)("inlineCode",{parentName:"li"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),".")),(0,s.kt)("h3",{id:"handlebars-helper-function-1"},"Handlebars Helper Function"),(0,s.kt)("p",null,"a function that can be used in a ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template."),(0,s.kt)("h4",{id:"notes-32"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences.")),(0,s.kt)("h3",{id:"handlebars-object-1"},"Handlebars Object"),(0,s.kt)("p",null,"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),"."),(0,s.kt)("h4",{id:"notes-33"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"))),(0,s.kt)("h3",{id:"handlebars-template-1"},"Handlebars Template"),(0,s.kt)("p",null,"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure."),(0,s.kt)("h4",{id:"notes-34"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",{parentName:"ul"},"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates.")),(0,s.kt)("h3",{id:"header-of-a-curated-text-1"},"Header (of a Curated Text)"),(0,s.kt)("p",null,"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."),(0,s.kt)("h4",{id:"notes-35"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),".")),(0,s.kt)("h3",{id:"machine-readable-glossary-tool-1"},"Machine Readable Glossary Tool"),(0,s.kt)("p",null,"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),"."),(0,s.kt)("h4",{id:"notes-36"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),".")),(0,s.kt)("h3",{id:""}),(0,s.kt)("p",null,"the (name of the field in the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered."),(0,s.kt)("h4",{id:"notes-37"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves.")),(0,s.kt)("h3",{id:"regular-expression-1"},"Regular Expression"),(0,s.kt)("p",null,"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."),(0,s.kt)("h4",{id:"notes-38"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"li",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),".")),(0,s.kt)("h3",{id:"regularized-text-1"},"Regularized Text"),(0,s.kt)("p",null,"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"p"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"p"},"-")," character."),(0,s.kt)("h4",{id:"notes-39"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"li"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text.")),(0,s.kt)("h3",{id:"relation-between-concepts-2"},"Relation (between Concepts)"),(0,s.kt)("p",null,"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,s.kt)("h4",{id:"notes-40"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other.")),(0,s.kt)("h3",{id:"semantic-unit-2"},"Semantic Unit"),(0,s.kt)("p",null,"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),")."),(0,s.kt)("h4",{id:"notes-41"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc.")),(0,s.kt)("h3",{id:"term-identifier-1"},"Term Identifier"),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h4",{id:"notes-42"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed.")),(0,s.kt)("h3",{id:"-1"}),(0,s.kt)("p",null,"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),"."),(0,s.kt)("h4",{id:"notes-43"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",{parentName:"ul"},"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",{parentName:"ul"},"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term.")),(0,s.kt)("h3",{id:"terminology-identifier-1"},"Terminology Identifier"),(0,s.kt)("p",null,"a ",(0,s.kt)("a",{parentName:"p",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"p"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h4",{id:"notes-44"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"If ",(0,s.kt)("inlineCode",{parentName:"li"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"li"},":")," is omitted, their values are taken be the current (or default) ones.")),(0,s.kt)("h3",{id:"tev2-toolbox-1"},"TEv2 Toolbox"),(0,s.kt)("p",null,"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs"},"TEv2 specifications"),"."),(0,s.kt)("h4",{id:"notes-45"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets.")),(0,s.kt)("h2",{id:"glossary-table-style"},"Glossary (Table style)"),(0,s.kt)("admonition",{type:"info"},(0,s.kt)("p",{parentName:"admonition"},"The same, but now generating the glossary in a table format. We use the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),":"),(0,s.kt)("p",{parentName:"admonition"},(0,s.kt)("inlineCode",{parentName:"p"},"{%")," ",(0,s.kt)("inlineCode",{parentName:"p"},'hrg="" converter="{{#if glossaryNotes}}## {{noRefs glossaryTerm}}\\n\\n{{glossaryText}}\\n\\n### Notes\\n\\n{{#each glossaryNotes}}- {{this}}\\n{{/each}}\\n{{/if}}"')," ",(0,s.kt)("inlineCode",{parentName:"p"},"%}"))),(0,s.kt)("table",null,(0,s.kt)("thead",{parentName:"table"},(0,s.kt)("tr",{parentName:"thead"},(0,s.kt)("th",{parentName:"tr",align:"left"},"Term"),(0,s.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,s.kt)("tbody",{parentName:"table"},(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Body File"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a file that is located somewhere within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),", and that contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," has a field ",(0,s.kt)("inlineCode",{parentName:"td"},"bodyFile")," that specifies its location within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Body (of a Curated Text)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that contains arbitrarily structured documentation about the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," documents.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Bodies live either in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files")," (behind the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header"),"), or in separate so-called ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Converter Profile"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the specification of a class of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-object",title:"Handlebars Object: a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a Handlebars Template."},"data objects"),", instances of which are used by specific ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tools")," to generate text fragments from.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Converter profiles exist, e.g., for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),"."),(0,s.kt)("li",null,"Converter profiles are used by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),", which are (predefined or custom) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that produce the generated text fragments."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Converter"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a specification, in the form of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template"),", for constructing a text that a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," uses to create its output.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," converter constructs a text that replaces a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),". That text, when rendered in a static website, would typically link to the page that documents the term. Also, it may provide a popup that shows its definition."),(0,s.kt)("li",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," converter constructs a text that replaces an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),". That text typically renders as a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable glossary"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Form Phrase Macro Map"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a list of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," will use to expand ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," as specified for ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Form-phrase macro maps can be specified in the ",(0,s.kt)("inlineCode",{parentName:"td"},"scope")," section of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")),(0,s.kt)("li",null,"Form-phrase macro maps can be specified in (the ",(0,s.kt)("inlineCode",{parentName:"td"},"mrgt")," section) of a ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/configuration-file"},"configuration file")," that is used when calling the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Form Phrase (for a Semantic Unit)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a word or phrase that refers to a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", yet is not (necessarily) the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is used in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The set of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase",title:"Form Phrase (for a Semantic Unit): a word or phrase that refers to a particular Semantic Unit, yet is not (necessarily) the Term that is used in the Definition of that Semantic Unit. Form phrases can be, e.g., plural forms, possessive extensions, verb-conjugation forms, abbreviations, and other variations."},"form phrases")," that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can recognize, is specified in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"unit"),". Such specifications may contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",null,"For looking up the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," (documentation, as specified in its corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"), ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can match words or phrases they encounter with the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," that are listed in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries"),". Such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regularized-text",title:"Regularized Text: a character string that starts with a lowercase character (`[a-z]`), and has subsequent characters that match Regex `[a-z_0-9-]`, and doesn't end with a `-` character."},"regularized texts")," do not contain ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form-phrase macros"),"."),(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," ensures that the texts in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt#processing-form-phrases",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"properly converted"),", and listed in the ",(0,s.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of the corresponding ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Front Matter"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Front matter is also commonly used by various static site generators (not just by ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),")."),(0,s.kt)("li",null,"The front-matter must be the first thing in the file and must be enclosed in triple-dashed lines for YAML."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Glossary Term"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossaryterm",title:"Glossary Term: a human readable text that will be used as the Term in a Definition as presented in a HRG."},"glossary term")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("li",null,"if the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryTerm")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," is left empty, a replacement value can typically be generated by the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," ",(0,s.kt)("inlineCode",{parentName:"td"},"{{capFirst term}}")),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Glossary Text"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a human readable text that will be used as the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),", as presented in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"the ",(0,s.kt)("inlineCode",{parentName:"td"},"glossaryText")," field in a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," can be used to specify the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarytext",title:"Glossary Text: a human readable text that will be used as the Definition for a particular Term, as presented in a HRG."},"glossary text")," for a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Helper Function"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a function that can be used in a ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/expressions.html"},"handlebars expression")," to manipulate or format the data before displaying it within a template.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"A handlebars helper can be used, e.g., to add a personal touch to the way information is presented, making it possible to tailor the output to fit specific needs or preferences."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Object"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a data object, that serves as the source of (context dependent) data from which a text is produced according to the specifications of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars template"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the structure (type) of the data objects that it will pass to its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Handlebars Template"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a blueprint/template that uses the ",(0,s.kt)("a",{parentName:"td",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"TEv2 ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are Handlebars templates."),(0,s.kt)("li",null,"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") allow for the creation of customizable texts that automatically update with specific data."),(0,s.kt)("li",null,"Handlebars templates (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters"),") are characterized by their use of Handlebars expressions within the templates."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Header (of a Curated Text)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Headers live in ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Curated Text File: a file that contains either a (complete) Curated Text, or the Header of that Curated Text and a reference to the File that contains its Body."},"curated text files"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Machine Readable Glossary Tool"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a software tool designed to create, manage, and process ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"Machine Readable Glossaries (MRGs)"),", as ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"specified by TEv2"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"MRGTs offer features for selecting ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that are ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," it is run in, or from other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"}),(0,s.kt)("td",{parentName:"tr",align:"left"},"the (name of the field in the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs/files/saf#scope-section"},(0,s.kt)("inlineCode",{parentName:"a"},"scope"),"-section")," of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," that contains the) path to the directory where ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," are rendered.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"The (value of this field) is for the rendered versions of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," what ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," is for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," themselves."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Regular Expression"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Within ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", we use a ",(0,s.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp"},"JavaScript flavor (ECMAScript 2022)"),"."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Regularized Text"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a character string that starts with a lowercase character (",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z]"),"), and has subsequent characters that match ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"[a-z_0-9-]"),", and doesn't end with a ",(0,s.kt)("inlineCode",{parentName:"td"},"-")," character.",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"In other words, every text that matches the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,s.kt)("inlineCode",{parentName:"td"},"^[a-z][a-z_0-9-]*(?<=[^-])$")," is a regularized text."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Relation (between Concepts)"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a (significant) connection or association between two or more ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"These connections define the way these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," are interrelated, providing insights into how they interact and influence each other."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Semantic Unit"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a basic building block of meaning or representation that exists within the 'mind' of a ",(0,s.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," (i.e., in its ",(0,s.kt)("a",{href:"/framework/docs/terms/knowledge",title:"Knowledge: The (intangible) sum of what is known by a specific Party, as well as the familiarity, awareness or understanding of someone or something by that Party."},"knowledge"),").",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"Examples include ideas, or ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/property",title:"Property (of a Concept): a connection or association between a Concept and a primitive data element, such as a text or a number, that represents some characteristic that instances of the Concept may have."},"properties")," of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," between ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", constraints over such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations"),", etc."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Term Identifier"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},"@"),", that is used for identifying a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," within a designated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"If ",(0,s.kt)("inlineCode",{parentName:"td"},"@")," is omitted, the current (or default) ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is assumed."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"}),(0,s.kt)("td",{parentName:"tr",align:"left"},"a word or phrase (i.e.: text) that is used to represent ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concepts"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"a term is ambiguous if it represents more than one ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"concept"),"."),(0,s.kt)("li",null,"a term that is used in a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which we call a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"scoped term"),") should not be ambiguous."),(0,s.kt)("li",null,"a term that is unambiguous can be made part of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," by associating it with a criterion that people can use to determine what is, and what is not, an instance (or: example) of that term."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"Terminology Identifier"),(0,s.kt)("td",{parentName:"tr",align:"left"},"a ",(0,s.kt)("a",{parentName:"td",href:"identifier@"},"text"),", of the form ",(0,s.kt)("inlineCode",{parentName:"td"},":"),", that identifies a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," from within a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and can also be used to find the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," file (in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," of that same ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") that contains ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entries")," for every ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," contained in that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"If ",(0,s.kt)("inlineCode",{parentName:"td"},"")," and/or ",(0,s.kt)("inlineCode",{parentName:"td"},":")," is omitted, their values are taken be the current (or default) ones."),(0,s.kt)("br",null)))),(0,s.kt)("tr",{parentName:"tbody"},(0,s.kt)("td",{parentName:"tr",align:"left"},"TEv2 Toolbox"),(0,s.kt)("td",{parentName:"tr",align:"left"},"the collection of tools designed to support and facilitate the process of terminology management following the ",(0,s.kt)("a",{parentName:"td",href:"/docs/specs"},"TEv2 specifications"),".",(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("strong",{parentName:"td"},"Notes"),(0,s.kt)("br",null),(0,s.kt)("br",null),(0,s.kt)("ul",null,(0,s.kt)("li",null,"These tools assist ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," in various tasks related to the curation, creation, and maintenance of terminological assets."),(0,s.kt)("br",null)))))))))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5ea46faf.d932d671.js b/assets/js/5ea46faf.d5ac5da9.js similarity index 99% rename from assets/js/5ea46faf.d932d671.js rename to assets/js/5ea46faf.d5ac5da9.js index b9621bde6..43e2657cc 100644 --- a/assets/js/5ea46faf.d932d671.js +++ b/assets/js/5ea46faf.d5ac5da9.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3504],{3905:(e,t,r)=>{r.d(t,{Zo:()=>h,kt:()=>l});var i=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function n(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=i.createContext({}),d=function(e){var t=i.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},h=function(e){var t=d(e.components);return i.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},f=i.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),f=d(r),l=a,u=f["".concat(c,".").concat(l)]||f[l]||p[l]||o;return r?i.createElement(u,n(n({ref:t},h),{},{components:r})):i.createElement(u,n({ref:t},h))}));function l(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,n=new Array(o);n[0]=f;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,n[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>p,frontMatter:()=>o,metadata:()=>s,toc:()=>d});var i=r(3117),a=(r(7294),r(3905));const o={id:"curatedir",displayed_sidebar:"tev2SideBar",term:"curatedir",termType:"concept",isa:null,glossaryTerm:"Curatedir",glossaryText:"a directory within a [scopedir](@) within which every file contains a [curated text](@) for that [scope](@).",grouptags:[],formPhrases:["curatedir{ss}","curate-director{yies}"],status:"proposed",created:20220729,updated:20220729,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Curatedir",s={unversionedId:"terms/curatedir",id:"terms/curatedir",title:"Curatedir",description:"A Curatedir is a directory within a scopedir within which every file contains a curated text for that scope.",source:"@site/docs/terms/curatedir.md",sourceDirName:"terms",slug:"/terms/curatedir",permalink:"/tev2-specifications/docs/terms/curatedir",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curatedir.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curatedir",displayed_sidebar:"tev2SideBar",term:"curatedir",termType:"concept",isa:null,glossaryTerm:"Curatedir",glossaryText:"a directory within a [scopedir](@) within which every file contains a [curated text](@) for that [scope](@).",grouptags:[],formPhrases:["curatedir{ss}","curate-director{yies}"],status:"proposed",created:20220729,updated:20220729,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],h={toc:d};function p(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,i.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curatedir"},"Curatedir"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"Curatedir")," is a directory within a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," may contain subdirectories to organize the various kinds of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),"."),(0,a.kt)("p",null,"The location of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is specified in the ",(0,a.kt)("inlineCode",{parentName:"p"},"curatedir")," field of the ",(0,a.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},"scope section")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which is located in the root of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),")."),(0,a.kt)("p",null,"Note that files that are not in the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," may nevertheless be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),", e.g., because they contain ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files")," to which ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," refer."))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3504],{3905:(e,t,r)=>{r.d(t,{Zo:()=>h,kt:()=>l});var i=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function n(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var c=i.createContext({}),d=function(e){var t=i.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},h=function(e){var t=d(e.components);return i.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},f=i.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),f=d(r),l=a,u=f["".concat(c,".").concat(l)]||f[l]||p[l]||o;return r?i.createElement(u,n(n({ref:t},h),{},{components:r})):i.createElement(u,n({ref:t},h))}));function l(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,n=new Array(o);n[0]=f;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,n[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>p,frontMatter:()=>o,metadata:()=>s,toc:()=>d});var i=r(3117),a=(r(7294),r(3905));const o={id:"curatedir",displayed_sidebar:"tev2SideBar",term:"curatedir",termType:"concept",isa:null,glossaryTerm:"Curatedir",glossaryText:"a directory within a [scopedir](@) within which every file contains a [curated text](@) for that [scope](@).",grouptags:[],formPhrases:["curatedir{ss}","curate-director{yies}"],status:"proposed",created:20220729,updated:20220729,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Curatedir",s={unversionedId:"terms/curatedir",id:"terms/curatedir",title:"Curatedir",description:"A Curatedir is a directory within a scopedir within which every file contains a curated text for that scope.",source:"@site/docs/terms/curatedir.md",sourceDirName:"terms",slug:"/terms/curatedir",permalink:"/tev2-specifications/docs/terms/curatedir",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curatedir.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curatedir",displayed_sidebar:"tev2SideBar",term:"curatedir",termType:"concept",isa:null,glossaryTerm:"Curatedir",glossaryText:"a directory within a [scopedir](@) within which every file contains a [curated text](@) for that [scope](@).",grouptags:[],formPhrases:["curatedir{ss}","curate-director{yies}"],status:"proposed",created:20220729,updated:20220729,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],h={toc:d};function p(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,i.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curatedir"},"Curatedir"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"Curatedir")," is a directory within a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," within which every file contains a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," may contain subdirectories to organize the various kinds of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),"."),(0,a.kt)("p",null,"The location of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is specified in the ",(0,a.kt)("inlineCode",{parentName:"p"},"curatedir")," field of the ",(0,a.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},"scope section")," of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (which is located in the root of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),")."),(0,a.kt)("p",null,"Note that files that are not in the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," may nevertheless be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),", e.g., because they contain ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body files")," to which ",(0,a.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"headers")," of a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," refer."))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/5f28d73f.039a61f5.js b/assets/js/5f28d73f.d3f95027.js similarity index 99% rename from assets/js/5f28d73f.039a61f5.js rename to assets/js/5f28d73f.d3f95027.js index accab2fcd..1e706376a 100644 --- a/assets/js/5f28d73f.039a61f5.js +++ b/assets/js/5f28d73f.d3f95027.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6752],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>m});var o=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var h=o.createContext({}),c=function(e){var t=o.useContext(h),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},l=function(e){var t=c(e.components);return o.createElement(h.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},f=o.forwardRef((function(e,t){var i=e.components,a=e.mdxType,n=e.originalType,h=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),f=c(i),m=a,p=f["".concat(h,".").concat(m)]||f[m]||d[m]||n;return i?o.createElement(p,s(s({ref:t},l),{},{components:i})):o.createElement(p,s({ref:t},l))}));function m(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=i.length,s=new Array(n);s[0]=f;var r={};for(var h in t)hasOwnProperty.call(t,h)&&(r[h]=t[h]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var c=2;c{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>s,default:()=>d,frontMatter:()=>n,metadata:()=>r,toc:()=>c});var o=i(3117),a=(i(7294),i(3905));const n={id:"terminology-process",displayed_sidebar:"tev2SideBar",term:"terminology-process",termType:"concept",isa:null,glossaryTerm:"Terminology Process",glossaryText:"a method for recognizing misunderstandings as such, and creating or maintaining [definitions](@) that resolve them.",grouptags:[],formPhrases:["terminology-processes"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Terminology Process",r={unversionedId:"terms/terminology-process",id:"terms/terminology-process",title:"Terminology Process",description:"The eSSIF-Lab terminology process is a method for recognizing misunderstandings as such, and creating or maintaining definitions that resolve them. It helps parties that work together to realize certain objectives (in some scope) by enabling them to establish a terminology that has the property that every party has the same understanding of each of its terms, and that each of these terms is relevant for the realizations of these objectives.xx",source:"@site/docs/terms/terminology-process.md",sourceDirName:"terms",slug:"/terms/terminology-process",permalink:"/tev2-specifications/docs/terms/terminology-process",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology-process.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology-process",displayed_sidebar:"tev2SideBar",term:"terminology-process",termType:"concept",isa:null,glossaryTerm:"Terminology Process",glossaryText:"a method for recognizing misunderstandings as such, and creating or maintaining [definitions](@) that resolve them.",grouptags:[],formPhrases:["terminology-processes"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},h={},c=[{value:"Prerequisites",id:"prerequisites",level:2},{value:"Creating or Changing a Definition",id:"creating-or-changing-a-definition",level:2},{value:"Conflict Mediation and Resolution",id:"conflict-mediation-and-resolution",level:2},{value:"Background",id:"background",level:2},{value:"Notes",id:"notes",level:2}],l={toc:c};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,o.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"terminology-process"},"Terminology Process"),(0,a.kt)("p",null,"The eSSIF-Lab ",(0,a.kt)("strong",{parentName:"p"},"terminology process")," is a method for recognizing misunderstandings as such, and creating or maintaining ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them. It helps ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that work together to realize certain ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," (in some ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") by enabling them to establish a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that has the property that every party has the same understanding of each of its ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", and that each of these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," is relevant for the realizations of these ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".xx"),(0,a.kt)("h2",{id:"prerequisites"},"Prerequisites"),(0,a.kt)("p",null,"This process focuses on the creation and maintenance of qualitatively good definitions, i.e. ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that satisfy the following quality criteria:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," is associated with a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is explicitly defined, i.e. any ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," can unambiguously determine whether or not the definition applies;"),(0,a.kt)("li",{parentName:"ul"},"the ",(0,a.kt)("a",{parentName:"li",href:"https://www.lexico.com/definition/criterion"},"criteria")," of the definition are well-formed, meaning that all stakeholders make the same judgments c.q. reach the same conclusions when using these criteria in a given situation that is relevant within the scope."),(0,a.kt)("li",{parentName:"ul"},"the definition is relevant, which means that stakeholders have identified cases that demonstrate how the use of this definition helps them realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so, or they have agreed that relevance is obvious."),(0,a.kt)("li",{parentName:"ul"},"there is consensus between the stakeholders regarding the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," - the actual word or phrase - that is to be used to refer to (unidentified, or arbitrary, or specific) ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that satisfy the criterion.")),(0,a.kt)("p",null,"This process does not prohibit that definitions may satisfy other criteria, or be associated with other attributes so that they may become better suited to serve other purposes as well. For example, a definition that is to be used in an educational context may be required to come with examples, and/or explanations about why the distinction is made as it is."),(0,a.kt)("h2",{id:"creating-or-changing-a-definition"},"Creating or Changing a Definition"),(0,a.kt)("p",null,"The process (step) for creating and/or changing a definition starts with a request to this end."),(0,a.kt)("p",null,"Processing this request, which includes deciding whether or not to service it in the first place, should be done by one or more stakeholders of the term. After all, they are the ones that contribute to the realization of the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," for which the term was defined, and hence need to ensure they can (keep) work(ing) with it.",(0,a.kt)("sup",{parentName:"p",id:"fnref-note"},(0,a.kt)("a",{parentName:"sup",href:"#fn-note",className:"footnote-ref"},"note"))),(0,a.kt)("p",null,"This doesn't mean that others Of course, it doesn't mean that others cannot have good ideas, but whether or not that is the case is for the stakeholders to decide. Too often do we see e.g. people adding terms to a glossary for purposes that don't serve the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,a.kt)("p",null,"We do not prescribe any specific way for stakeholders to process the request. We only state the conditions that anyone can check to see if the work is done, which is the case when the definition qualifies as a 'good definition' according to the criteria stated above. Thus, stakeholders can do whatever they deem appropriate, as long as the end result satisfies these criteria."),(0,a.kt)("p",null,"If the set of stakeholders is too large to be practical for satisfying these criteria, they may appoint one (or a small committee) of them as a 'terminology officer' or 'curator', i.e. the one that is tasked with processing such requests and bringing that processing to a satisfactory end."),(0,a.kt)("h2",{id:"conflict-mediation-and-resolution"},"Conflict Mediation and Resolution"),(0,a.kt)("p",null,"We have experienced many situations in which terms were not used 'in the right way'. This is not problematic per se. Going back to the example of the coffee cup, one of the students may observe that coffee is being served in something that he does not consider to be a cup. If he reacts by saying how surprised he is to find out that cups are more varied than he thought so far, this is an expression of having obtained a new insight, and having learned in an enjoyable fashion. From our perspective, he values the importance of the criterion higher than the importance of being right in the definition that he has (unconsciously) used himself."),(0,a.kt)("p",null,"However, we often find that people feel strongly about what is the 'right' definition of a term, even though they have problems in providing a good definition, i.e. one that is both relevant and well-formed. This often leads to debates that in the end do not have a satisfactory conclusion."),(0,a.kt)("p",null,"If you find yourself in such a discussion, there are several things that you can do to revert this situation. The first thing is to verify that the participants are sufficiently motivated to have an outcome that is good for all \u2013 even if that means they will have to acknowledge that they were not right all the way. We assume that a sufficiently motivated group of participants can agree that definitions should have the properties that we have defined for being a good definition. You may want to explicitly establish this assumption, and explain that these properties prevent misunderstandings, cater for better cooperation as you get a common 'picture' of what you are doing, and what is relevant for that and what is not. And yes, it may seem to take more time than usual. However, we see this as a sure sign that spending this time now and resolving the issue will save us multiple such times where the issue is not resolved in a manner that is satisfactory to all participants: such issues will persist in popping up. Some people may need to experience this for themselves before accepting that this is the case."),(0,a.kt)("p",null,"Even after having established that participants are motivated to come to a good definition, participants may have strong feelings about the meaning of terms or the phrasing of a definition, and object to review that. In such cases, it may help to state the scope of the definition that you are trying to agree on, e.g. being a project you all work on, or the discussion that you are having. Then, you can explain that the definition you are trying to pin down is only applicable in that scope, which means that strong feelings about the meaning of the term or the phrasing of a definition are ok in other context, and that the definition for the term that you are trying to define does not pose a threat to these contexts. We have seen this intervention have a relativizing effect on people, as it allows them to participate without having to give up their opinions (for other contexts)."),(0,a.kt)("p",null,"Another intervention that you can do when the scope is clear, yet the discussions go all over the place, is clearly stating when you are trying to formulate a criterion and assess its well-formedness, and when you are establishing the relevance of the distinction that you attempt to make. When assessing relevance, the task is to come up with situations that call for the need to make the envisaged distinction. But you should not surrender to the temptation to already apply (one of the) criteria that may lie around. When you are trying to formulate or choose a criterion and assess its well-formedness, the task is to throw these (relevant) situations at the criterion, and ONLY find out whether or not stakeholders make the same distinction. As you alternate between these two tasks, you may find that at some point in time,"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"convergence takes place, i.e. the proposed criteria increasingly become well-formed, and increasingly make the distinction that you are after. You have a good definition!"),(0,a.kt)("li",{parentName:"ul"},"it dawns on you that it is not one, but other distinctions need be made as well. In the example of the wine students, they may find out that they do not only need a definition for 'glass', but that they need other terms in order to distinguish between the various kinds of glasses they need for drinking different wines.",(0,a.kt)("sup",{parentName:"li",id:"fnref-iau"},(0,a.kt)("a",{parentName:"sup",href:"#fn-iau",className:"footnote-ref"},"IAU"))," You split up the discussion in as many discussions as you want to make distinctions."),(0,a.kt)("li",{parentName:"ul"},"no convergence takes place at all. You are probably trying to make distinctions that in the end do not make any sense. Take a break, try to get some fresh/foolish ideas, and try again from there.")),(0,a.kt)("h2",{id:"background"},"Background"),(0,a.kt)("p",null,"A common way to foster mutual understanding is to define terms. The idea is that if we agree to define a term in some way, and use that term accordingly, we avoid misunderstandings. Indeed, many terminologies (lists of definitions) have been established, in many varieties (e.g. glossaries, dictionaries, etc.) in an attempt to achieve this objective. The fact that debates about well-known terms keep popping up over and over again both underlines the importance of this work and suggests that improvements are called for."),(0,a.kt)("p",null,"We propose an approach that focuses on the effects that we want definitions to have in discussions, the most important one of which is that people that use a term in a discussion agree as to what is, and what is not an instance of the term, and that this agreement extends to multiple, different situations."),(0,a.kt)("p",null,"Note that this effect is limited to the scope of a discussion, which would allow the same term to have a different meaning/interpretation in other discussions (as is common practice). Terminologies however are typically meant to be used in large(r) scopes, where people pursue specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". For example, a terminology may be needed for creating, maintaining and using (a set of) standards, or an IT system."),(0,a.kt)("p",null,"We postulate that the use of a specific terminology is limited to a (set of) scope(s) within which specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," are being pursued. Doing this allows us to discuss the relevance of terms within a scope: a definition that does not help people to realize the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the scope has no place in the terminology of that scope. Conversely, any distinction that helps people to realize one or more of the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," should be made explicit, and assigned a term. This makes terminology the invaluable asset that we feel it should be."),(0,a.kt)("p",null,"Within this document, we use the term 'stakeholder (of a terminology)' to refer to a person that contributes to realizing ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of some scope for which that terminology exists, or is being developed/maintained. Having this notion allows us to distinguish between people that have a working interest in the terms defined therein, and those that do not. We will only allow stakeholders of a terminology to participate in discussions to create, update or delete terms therein."),(0,a.kt)("p",null,"Terms that are defined in a terminology use usually classifications of things we know to exist. For example, 'cup' represents a class of things that have specific characteristics. If stakeholders want to agree on what a cup is, they should devise a criterion that allows them to distinguish between things that are a cup, and things that are not. One part of a definition should thus be a criterion by which any stakeholder can make this judgment."),(0,a.kt)("p",null,"We say that a criterion is 'well-formed' if it has the property that all stakeholders make the same judgment in a given, yet arbitrary case. So if stakeholders use a well-formed criterion for 'cup', then you can present any item to them, and every time they will agree as to whether or not this item is a cup. The property of being well-formed is important for these criteria, because it ensures that stakeholders have the same idea about the meaning of a term."),(0,a.kt)("p",null,"Criteria that are well-formed in one context may not be well-formed in another context. In the context of a caf\xe9 in which some students want to converse while drinking a cup of coffee, the criterion 'anything that can contain coffee and that a person can drink out of' would be well-formed. In the context of a space station in which some astronauts want to converse while drinking a cup of coffee, this criterion may not be appropriate as it would include cups that spill their coffee because of the lack of gravity",(0,a.kt)("sup",{parentName:"p",id:"fnref-nasa"},(0,a.kt)("a",{parentName:"sup",href:"#fn-nasa",className:"footnote-ref"},"NASA")),". Therefore, another part of a definition should be a reference to the scope(s) within which it is applied."),(0,a.kt)("p",null,"We say that a criterion is 'relevant' if it has the property that all stakeholders agree \u2013 possibly for different reasons \u2013 that the distinction it makes helps them to realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so. Testing for this property (i.e. asking the stakeholders whether or not they think it helps to realize ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues",(0,a.kt)("sup",{parentName:"p",id:"fnref-test"},(0,a.kt)("a",{parentName:"sup",href:"#fn-test",className:"footnote-ref"},"test")),") ensures that the criterion does not need to make distinctions that, while relevant in other scopes, are irrelevant in the scope in which it is established."),(0,a.kt)("p",null,"Obviously, criteria that are relevant in one context may not not be relevant in another context. For example, in the context of a chic restaurant in which some students want to have a good time, conversing with one another and drinking glasses of wine, the criterion for a glass: 'anything that can contain wine and that a person can drink out of' would be relevant. In the context of that same restaurants in which the same students want to taste wine as part of their training to become a sommelier, this criterion is no longer relevant."),(0,a.kt)("h2",{id:"notes"},"Notes"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"see: ",(0,a.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Dwarf_planet"},"https://en.wikipedia.org/wiki/Dwarf_planet")," for an account of what happened and for the resolution;"),(0,a.kt)("li",{parentName:"ul"},'IAU (August 24, 2006). "',(0,a.kt)("a",{parentName:"li",href:"https://www.iau.org/static/resolutions/Resolution_GA26-5-6.pdf"},"Definition of a Planet in the Solar System: Resolutions 5 and 6"),'". IAU 2006 General Assembly. International Astronomical Union. Retrieved March 8, 2018. \u2013 discussions')),(0,a.kt)("div",{className:"footnotes"},(0,a.kt)("hr",{parentName:"div"}),(0,a.kt)("ol",{parentName:"div"},(0,a.kt)("li",{parentName:"ol",id:"fn-note"},"We have often seen (changes in) definitions of terms being contributed by well-intentioned people, the result of which didn't qualify as a 'good definition', amongst others because they were not stakeholders as we see them.",(0,a.kt)("a",{parentName:"li",href:"#fnref-note",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-iau"},"A famous example of discussions and the use of definitions that constitute of criteria is that in the IAU, about (dwarf) planets. While it is a good example of how definitions should be used, it also shows that it is not the holy grail. See:",(0,a.kt)("a",{parentName:"li",href:"#fnref-iau",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-nasa"},"NASA has designed so-called 'space cups' for drinking liquids such a s coffee in the International Space Station ISS. See ",(0,a.kt)("a",{parentName:"li",href:"https://www.nasa.gov/mission_pages/station/research/experiments/2029.html"},"https://www.nasa.gov/mission_pages/station/research/experiments/2029.html"),".",(0,a.kt)("a",{parentName:"li",href:"#fnref-nasa",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-test"},"If you test a criterion by simply asking stakeholders to assert that the criteria is relevant, you run the ",(0,a.kt)("a",{href:"/framework/docs/terms/risk",title:"Risk (of a Party's Objective): the effects that uncertainty (i.e. a lack of information, understanding or knowledge of events, their consequences or likelihoods) can have on the intended realization of that Party's Objective."},"risk")," that they have their own interpretation of the term 'relevant'. In order to mitigate this ",(0,a.kt)("a",{href:"/framework/docs/terms/risk",title:"Risk (of a Party's Objective): the effects that uncertainty (i.e. a lack of information, understanding or knowledge of events, their consequences or likelihoods) can have on the intended realization of that Party's Objective."},"risk"),", you should either define 'relevance (of a criterion that is used in a definition)' as the property of helping stakeholders in the scope of that definition to to realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so, or you should ask the question as we stated here.",(0,a.kt)("a",{parentName:"li",href:"#fnref-test",className:"footnote-backref"},"\u21a9")))))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6752],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>m});var o=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,o)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var h=o.createContext({}),c=function(e){var t=o.useContext(h),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},l=function(e){var t=c(e.components);return o.createElement(h.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},f=o.forwardRef((function(e,t){var i=e.components,a=e.mdxType,n=e.originalType,h=e.parentName,l=r(e,["components","mdxType","originalType","parentName"]),f=c(i),m=a,p=f["".concat(h,".").concat(m)]||f[m]||d[m]||n;return i?o.createElement(p,s(s({ref:t},l),{},{components:i})):o.createElement(p,s({ref:t},l))}));function m(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=i.length,s=new Array(n);s[0]=f;var r={};for(var h in t)hasOwnProperty.call(t,h)&&(r[h]=t[h]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var c=2;c{i.r(t),i.d(t,{assets:()=>h,contentTitle:()=>s,default:()=>d,frontMatter:()=>n,metadata:()=>r,toc:()=>c});var o=i(3117),a=(i(7294),i(3905));const n={id:"terminology-process",displayed_sidebar:"tev2SideBar",term:"terminology-process",termType:"concept",isa:null,glossaryTerm:"Terminology Process",glossaryText:"a method for recognizing misunderstandings as such, and creating or maintaining [definitions](@) that resolve them.",grouptags:[],formPhrases:["terminology-processes"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Terminology Process",r={unversionedId:"terms/terminology-process",id:"terms/terminology-process",title:"Terminology Process",description:"The eSSIF-Lab terminology process is a method for recognizing misunderstandings as such, and creating or maintaining definitions that resolve them. It helps parties that work together to realize certain objectives (in some scope) by enabling them to establish a terminology that has the property that every party has the same understanding of each of its terms, and that each of these terms is relevant for the realizations of these objectives.xx",source:"@site/docs/terms/terminology-process.md",sourceDirName:"terms",slug:"/terms/terminology-process",permalink:"/tev2-specifications/docs/terms/terminology-process",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/terminology-process.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"terminology-process",displayed_sidebar:"tev2SideBar",term:"terminology-process",termType:"concept",isa:null,glossaryTerm:"Terminology Process",glossaryText:"a method for recognizing misunderstandings as such, and creating or maintaining [definitions](@) that resolve them.",grouptags:[],formPhrases:["terminology-processes"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},h={},c=[{value:"Prerequisites",id:"prerequisites",level:2},{value:"Creating or Changing a Definition",id:"creating-or-changing-a-definition",level:2},{value:"Conflict Mediation and Resolution",id:"conflict-mediation-and-resolution",level:2},{value:"Background",id:"background",level:2},{value:"Notes",id:"notes",level:2}],l={toc:c};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,o.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"terminology-process"},"Terminology Process"),(0,a.kt)("p",null,"The eSSIF-Lab ",(0,a.kt)("strong",{parentName:"p"},"terminology process")," is a method for recognizing misunderstandings as such, and creating or maintaining ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that resolve them. It helps ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"parties")," that work together to realize certain ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," (in some ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") by enabling them to establish a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that has the property that every party has the same understanding of each of its ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", and that each of these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," is relevant for the realizations of these ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),".xx"),(0,a.kt)("h2",{id:"prerequisites"},"Prerequisites"),(0,a.kt)("p",null,"This process focuses on the creation and maintenance of qualitatively good definitions, i.e. ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that satisfy the following quality criteria:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition")," is associated with a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that is explicitly defined, i.e. any ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," can unambiguously determine whether or not the definition applies;"),(0,a.kt)("li",{parentName:"ul"},"the ",(0,a.kt)("a",{parentName:"li",href:"https://www.lexico.com/definition/criterion"},"criteria")," of the definition are well-formed, meaning that all stakeholders make the same judgments c.q. reach the same conclusions when using these criteria in a given situation that is relevant within the scope."),(0,a.kt)("li",{parentName:"ul"},"the definition is relevant, which means that stakeholders have identified cases that demonstrate how the use of this definition helps them realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so, or they have agreed that relevance is obvious."),(0,a.kt)("li",{parentName:"ul"},"there is consensus between the stakeholders regarding the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," - the actual word or phrase - that is to be used to refer to (unidentified, or arbitrary, or specific) ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," that satisfy the criterion.")),(0,a.kt)("p",null,"This process does not prohibit that definitions may satisfy other criteria, or be associated with other attributes so that they may become better suited to serve other purposes as well. For example, a definition that is to be used in an educational context may be required to come with examples, and/or explanations about why the distinction is made as it is."),(0,a.kt)("h2",{id:"creating-or-changing-a-definition"},"Creating or Changing a Definition"),(0,a.kt)("p",null,"The process (step) for creating and/or changing a definition starts with a request to this end."),(0,a.kt)("p",null,"Processing this request, which includes deciding whether or not to service it in the first place, should be done by one or more stakeholders of the term. After all, they are the ones that contribute to the realization of the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," for which the term was defined, and hence need to ensure they can (keep) work(ing) with it.",(0,a.kt)("sup",{parentName:"p",id:"fnref-note"},(0,a.kt)("a",{parentName:"sup",href:"#fn-note",className:"footnote-ref"},"note"))),(0,a.kt)("p",null,"This doesn't mean that others Of course, it doesn't mean that others cannot have good ideas, but whether or not that is the case is for the stakeholders to decide. Too often do we see e.g. people adding terms to a glossary for purposes that don't serve the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),"."),(0,a.kt)("p",null,"We do not prescribe any specific way for stakeholders to process the request. We only state the conditions that anyone can check to see if the work is done, which is the case when the definition qualifies as a 'good definition' according to the criteria stated above. Thus, stakeholders can do whatever they deem appropriate, as long as the end result satisfies these criteria."),(0,a.kt)("p",null,"If the set of stakeholders is too large to be practical for satisfying these criteria, they may appoint one (or a small committee) of them as a 'terminology officer' or 'curator', i.e. the one that is tasked with processing such requests and bringing that processing to a satisfactory end."),(0,a.kt)("h2",{id:"conflict-mediation-and-resolution"},"Conflict Mediation and Resolution"),(0,a.kt)("p",null,"We have experienced many situations in which terms were not used 'in the right way'. This is not problematic per se. Going back to the example of the coffee cup, one of the students may observe that coffee is being served in something that he does not consider to be a cup. If he reacts by saying how surprised he is to find out that cups are more varied than he thought so far, this is an expression of having obtained a new insight, and having learned in an enjoyable fashion. From our perspective, he values the importance of the criterion higher than the importance of being right in the definition that he has (unconsciously) used himself."),(0,a.kt)("p",null,"However, we often find that people feel strongly about what is the 'right' definition of a term, even though they have problems in providing a good definition, i.e. one that is both relevant and well-formed. This often leads to debates that in the end do not have a satisfactory conclusion."),(0,a.kt)("p",null,"If you find yourself in such a discussion, there are several things that you can do to revert this situation. The first thing is to verify that the participants are sufficiently motivated to have an outcome that is good for all \u2013 even if that means they will have to acknowledge that they were not right all the way. We assume that a sufficiently motivated group of participants can agree that definitions should have the properties that we have defined for being a good definition. You may want to explicitly establish this assumption, and explain that these properties prevent misunderstandings, cater for better cooperation as you get a common 'picture' of what you are doing, and what is relevant for that and what is not. And yes, it may seem to take more time than usual. However, we see this as a sure sign that spending this time now and resolving the issue will save us multiple such times where the issue is not resolved in a manner that is satisfactory to all participants: such issues will persist in popping up. Some people may need to experience this for themselves before accepting that this is the case."),(0,a.kt)("p",null,"Even after having established that participants are motivated to come to a good definition, participants may have strong feelings about the meaning of terms or the phrasing of a definition, and object to review that. In such cases, it may help to state the scope of the definition that you are trying to agree on, e.g. being a project you all work on, or the discussion that you are having. Then, you can explain that the definition you are trying to pin down is only applicable in that scope, which means that strong feelings about the meaning of the term or the phrasing of a definition are ok in other context, and that the definition for the term that you are trying to define does not pose a threat to these contexts. We have seen this intervention have a relativizing effect on people, as it allows them to participate without having to give up their opinions (for other contexts)."),(0,a.kt)("p",null,"Another intervention that you can do when the scope is clear, yet the discussions go all over the place, is clearly stating when you are trying to formulate a criterion and assess its well-formedness, and when you are establishing the relevance of the distinction that you attempt to make. When assessing relevance, the task is to come up with situations that call for the need to make the envisaged distinction. But you should not surrender to the temptation to already apply (one of the) criteria that may lie around. When you are trying to formulate or choose a criterion and assess its well-formedness, the task is to throw these (relevant) situations at the criterion, and ONLY find out whether or not stakeholders make the same distinction. As you alternate between these two tasks, you may find that at some point in time,"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"convergence takes place, i.e. the proposed criteria increasingly become well-formed, and increasingly make the distinction that you are after. You have a good definition!"),(0,a.kt)("li",{parentName:"ul"},"it dawns on you that it is not one, but other distinctions need be made as well. In the example of the wine students, they may find out that they do not only need a definition for 'glass', but that they need other terms in order to distinguish between the various kinds of glasses they need for drinking different wines.",(0,a.kt)("sup",{parentName:"li",id:"fnref-iau"},(0,a.kt)("a",{parentName:"sup",href:"#fn-iau",className:"footnote-ref"},"IAU"))," You split up the discussion in as many discussions as you want to make distinctions."),(0,a.kt)("li",{parentName:"ul"},"no convergence takes place at all. You are probably trying to make distinctions that in the end do not make any sense. Take a break, try to get some fresh/foolish ideas, and try again from there.")),(0,a.kt)("h2",{id:"background"},"Background"),(0,a.kt)("p",null,"A common way to foster mutual understanding is to define terms. The idea is that if we agree to define a term in some way, and use that term accordingly, we avoid misunderstandings. Indeed, many terminologies (lists of definitions) have been established, in many varieties (e.g. glossaries, dictionaries, etc.) in an attempt to achieve this objective. The fact that debates about well-known terms keep popping up over and over again both underlines the importance of this work and suggests that improvements are called for."),(0,a.kt)("p",null,"We propose an approach that focuses on the effects that we want definitions to have in discussions, the most important one of which is that people that use a term in a discussion agree as to what is, and what is not an instance of the term, and that this agreement extends to multiple, different situations."),(0,a.kt)("p",null,"Note that this effect is limited to the scope of a discussion, which would allow the same term to have a different meaning/interpretation in other discussions (as is common practice). Terminologies however are typically meant to be used in large(r) scopes, where people pursue specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". For example, a terminology may be needed for creating, maintaining and using (a set of) standards, or an IT system."),(0,a.kt)("p",null,"We postulate that the use of a specific terminology is limited to a (set of) scope(s) within which specific ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," are being pursued. Doing this allows us to discuss the relevance of terms within a scope: a definition that does not help people to realize the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of the scope has no place in the terminology of that scope. Conversely, any distinction that helps people to realize one or more of the ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," should be made explicit, and assigned a term. This makes terminology the invaluable asset that we feel it should be."),(0,a.kt)("p",null,"Within this document, we use the term 'stakeholder (of a terminology)' to refer to a person that contributes to realizing ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," of some scope for which that terminology exists, or is being developed/maintained. Having this notion allows us to distinguish between people that have a working interest in the terms defined therein, and those that do not. We will only allow stakeholders of a terminology to participate in discussions to create, update or delete terms therein."),(0,a.kt)("p",null,"Terms that are defined in a terminology use usually classifications of things we know to exist. For example, 'cup' represents a class of things that have specific characteristics. If stakeholders want to agree on what a cup is, they should devise a criterion that allows them to distinguish between things that are a cup, and things that are not. One part of a definition should thus be a criterion by which any stakeholder can make this judgment."),(0,a.kt)("p",null,"We say that a criterion is 'well-formed' if it has the property that all stakeholders make the same judgment in a given, yet arbitrary case. So if stakeholders use a well-formed criterion for 'cup', then you can present any item to them, and every time they will agree as to whether or not this item is a cup. The property of being well-formed is important for these criteria, because it ensures that stakeholders have the same idea about the meaning of a term."),(0,a.kt)("p",null,"Criteria that are well-formed in one context may not be well-formed in another context. In the context of a caf\xe9 in which some students want to converse while drinking a cup of coffee, the criterion 'anything that can contain coffee and that a person can drink out of' would be well-formed. In the context of a space station in which some astronauts want to converse while drinking a cup of coffee, this criterion may not be appropriate as it would include cups that spill their coffee because of the lack of gravity",(0,a.kt)("sup",{parentName:"p",id:"fnref-nasa"},(0,a.kt)("a",{parentName:"sup",href:"#fn-nasa",className:"footnote-ref"},"NASA")),". Therefore, another part of a definition should be a reference to the scope(s) within which it is applied."),(0,a.kt)("p",null,"We say that a criterion is 'relevant' if it has the property that all stakeholders agree \u2013 possibly for different reasons \u2013 that the distinction it makes helps them to realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so. Testing for this property (i.e. asking the stakeholders whether or not they think it helps to realize ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues",(0,a.kt)("sup",{parentName:"p",id:"fnref-test"},(0,a.kt)("a",{parentName:"sup",href:"#fn-test",className:"footnote-ref"},"test")),") ensures that the criterion does not need to make distinctions that, while relevant in other scopes, are irrelevant in the scope in which it is established."),(0,a.kt)("p",null,"Obviously, criteria that are relevant in one context may not not be relevant in another context. For example, in the context of a chic restaurant in which some students want to have a good time, conversing with one another and drinking glasses of wine, the criterion for a glass: 'anything that can contain wine and that a person can drink out of' would be relevant. In the context of that same restaurants in which the same students want to taste wine as part of their training to become a sommelier, this criterion is no longer relevant."),(0,a.kt)("h2",{id:"notes"},"Notes"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"see: ",(0,a.kt)("a",{parentName:"li",href:"https://en.wikipedia.org/wiki/Dwarf_planet"},"https://en.wikipedia.org/wiki/Dwarf_planet")," for an account of what happened and for the resolution;"),(0,a.kt)("li",{parentName:"ul"},'IAU (August 24, 2006). "',(0,a.kt)("a",{parentName:"li",href:"https://www.iau.org/static/resolutions/Resolution_GA26-5-6.pdf"},"Definition of a Planet in the Solar System: Resolutions 5 and 6"),'". IAU 2006 General Assembly. International Astronomical Union. Retrieved March 8, 2018. \u2013 discussions')),(0,a.kt)("div",{className:"footnotes"},(0,a.kt)("hr",{parentName:"div"}),(0,a.kt)("ol",{parentName:"div"},(0,a.kt)("li",{parentName:"ol",id:"fn-note"},"We have often seen (changes in) definitions of terms being contributed by well-intentioned people, the result of which didn't qualify as a 'good definition', amongst others because they were not stakeholders as we see them.",(0,a.kt)("a",{parentName:"li",href:"#fnref-note",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-iau"},"A famous example of discussions and the use of definitions that constitute of criteria is that in the IAU, about (dwarf) planets. While it is a good example of how definitions should be used, it also shows that it is not the holy grail. See:",(0,a.kt)("a",{parentName:"li",href:"#fnref-iau",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-nasa"},"NASA has designed so-called 'space cups' for drinking liquids such a s coffee in the International Space Station ISS. See ",(0,a.kt)("a",{parentName:"li",href:"https://www.nasa.gov/mission_pages/station/research/experiments/2029.html"},"https://www.nasa.gov/mission_pages/station/research/experiments/2029.html"),".",(0,a.kt)("a",{parentName:"li",href:"#fnref-nasa",className:"footnote-backref"},"\u21a9")),(0,a.kt)("li",{parentName:"ol",id:"fn-test"},"If you test a criterion by simply asking stakeholders to assert that the criteria is relevant, you run the ",(0,a.kt)("a",{href:"/framework/docs/terms/risk",title:"Risk (of a Party's Objective): the effects that uncertainty (i.e. a lack of information, understanding or knowledge of events, their consequences or likelihoods) can have on the intended realization of that Party's Objective."},"risk")," that they have their own interpretation of the term 'relevant'. In order to mitigate this ",(0,a.kt)("a",{href:"/framework/docs/terms/risk",title:"Risk (of a Party's Objective): the effects that uncertainty (i.e. a lack of information, understanding or knowledge of events, their consequences or likelihoods) can have on the intended realization of that Party's Objective."},"risk"),", you should either define 'relevance (of a criterion that is used in a definition)' as the property of helping stakeholders in the scope of that definition to to realize their ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives")," and/or address issues that prevent them from doing so, or you should ask the question as we stated here.",(0,a.kt)("a",{parentName:"li",href:"#fnref-test",className:"footnote-backref"},"\u21a9")))))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/6044cad1.2a79a4e6.js b/assets/js/6044cad1.2bf3b876.js similarity index 98% rename from assets/js/6044cad1.2a79a4e6.js rename to assets/js/6044cad1.2bf3b876.js index c99e30b27..835881497 100644 --- a/assets/js/6044cad1.2a79a4e6.js +++ b/assets/js/6044cad1.2bf3b876.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5419],{3905:(e,r,t)=>{t.d(r,{Zo:()=>f,kt:()=>d});var n=t(7294);function s(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function o(e,r){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r&&(n=n.filter((function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable}))),t.push.apply(t,n)}return t}function a(e){for(var r=1;r=0||(s[t]=e[t]);return s}(e,r);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(s[t]=e[t])}return s}var c=n.createContext({}),p=function(e){var r=n.useContext(c),t=r;return e&&(t="function"==typeof e?e(r):a(a({},r),e)),t},f=function(e){var r=p(e.components);return n.createElement(c.Provider,{value:r},e.children)},m={inlineCode:"code",wrapper:function(e){var r=e.children;return n.createElement(n.Fragment,{},r)}},l=n.forwardRef((function(e,r){var t=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,f=i(e,["components","mdxType","originalType","parentName"]),l=p(t),d=s,u=l["".concat(c,".").concat(d)]||l[d]||m[d]||o;return t?n.createElement(u,a(a({ref:r},f),{},{components:t})):n.createElement(u,a({ref:r},f))}));function d(e,r){var t=arguments,s=r&&r.mdxType;if("string"==typeof e||s){var o=t.length,a=new Array(o);a[0]=l;var i={};for(var c in r)hasOwnProperty.call(r,c)&&(i[c]=r[c]);i.originalType=e,i.mdxType="string"==typeof e?e:s,a[1]=i;for(var p=2;p{t.r(r),t.d(r,{assets:()=>c,contentTitle:()=>a,default:()=>m,frontMatter:()=>o,metadata:()=>i,toc:()=>p});var n=t(3117),s=(t(7294),t(3905));const o={id:"mrg-ref",displayed_sidebar:"tev2SideBar",term:"mrg-ref",termType:"concept",isa:null,bodyFile:"/specs/syntax/41-mrg-refs.md",glossaryTerm:"MRGRef",glossaryText:"a text that is [marked up (in a specific way)](/docs/specs/syntax/mrg-refs) so that it refers to a particular [terminology](@), as well as to a specific way for creating an associated [HRG](@).",grouptags:[],formPhrases:["mrg-ref{ss}","mrgref{ss}","mrg reference{ss}"],status:"proposed",created:20231127,updated:20231127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a=void 0,i={unversionedId:"terms/mrg-ref",id:"terms/mrg-ref",title:"mrg-ref",description:"",source:"@site/docs/terms/mrg-ref.md",sourceDirName:"terms",slug:"/terms/mrg-ref",permalink:"/tev2-specifications/docs/terms/mrg-ref",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrg-ref.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrg-ref",displayed_sidebar:"tev2SideBar",term:"mrg-ref",termType:"concept",isa:null,bodyFile:"/specs/syntax/41-mrg-refs.md",glossaryTerm:"MRGRef",glossaryText:"a text that is [marked up (in a specific way)](/docs/specs/syntax/mrg-refs) so that it refers to a particular [terminology](@), as well as to a specific way for creating an associated [HRG](@).",grouptags:[],formPhrases:["mrg-ref{ss}","mrgref{ss}","mrg reference{ss}"],status:"proposed",created:20231127,updated:20231127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],f={toc:p};function m(e){let{components:r,...t}=e;return(0,s.kt)("wrapper",(0,n.Z)({},f,t,{components:r,mdxType:"MDXLayout"}))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5419],{3905:(e,r,t)=>{t.d(r,{Zo:()=>f,kt:()=>d});var n=t(7294);function s(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function o(e,r){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r&&(n=n.filter((function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable}))),t.push.apply(t,n)}return t}function a(e){for(var r=1;r=0||(s[t]=e[t]);return s}(e,r);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(s[t]=e[t])}return s}var c=n.createContext({}),p=function(e){var r=n.useContext(c),t=r;return e&&(t="function"==typeof e?e(r):a(a({},r),e)),t},f=function(e){var r=p(e.components);return n.createElement(c.Provider,{value:r},e.children)},m={inlineCode:"code",wrapper:function(e){var r=e.children;return n.createElement(n.Fragment,{},r)}},l=n.forwardRef((function(e,r){var t=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,f=i(e,["components","mdxType","originalType","parentName"]),l=p(t),d=s,u=l["".concat(c,".").concat(d)]||l[d]||m[d]||o;return t?n.createElement(u,a(a({ref:r},f),{},{components:t})):n.createElement(u,a({ref:r},f))}));function d(e,r){var t=arguments,s=r&&r.mdxType;if("string"==typeof e||s){var o=t.length,a=new Array(o);a[0]=l;var i={};for(var c in r)hasOwnProperty.call(r,c)&&(i[c]=r[c]);i.originalType=e,i.mdxType="string"==typeof e?e:s,a[1]=i;for(var p=2;p{t.r(r),t.d(r,{assets:()=>c,contentTitle:()=>a,default:()=>m,frontMatter:()=>o,metadata:()=>i,toc:()=>p});var n=t(3117),s=(t(7294),t(3905));const o={id:"mrg-ref",displayed_sidebar:"tev2SideBar",term:"mrg-ref",termType:"concept",isa:null,bodyFile:"/specs/syntax/41-mrg-refs.md",glossaryTerm:"MRGRef",glossaryText:"a text that is [marked up (in a specific way)](/docs/specs/syntax/mrg-refs) so that it refers to a particular [terminology](@), as well as to a specific way for creating an associated [HRG](@).",grouptags:[],formPhrases:["mrg-ref{ss}","mrgref{ss}","mrg reference{ss}"],status:"proposed",created:20231127,updated:20231127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},a=void 0,i={unversionedId:"terms/mrg-ref",id:"terms/mrg-ref",title:"mrg-ref",description:"",source:"@site/docs/terms/mrg-ref.md",sourceDirName:"terms",slug:"/terms/mrg-ref",permalink:"/tev2-specifications/docs/terms/mrg-ref",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrg-ref.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrg-ref",displayed_sidebar:"tev2SideBar",term:"mrg-ref",termType:"concept",isa:null,bodyFile:"/specs/syntax/41-mrg-refs.md",glossaryTerm:"MRGRef",glossaryText:"a text that is [marked up (in a specific way)](/docs/specs/syntax/mrg-refs) so that it refers to a particular [terminology](@), as well as to a specific way for creating an associated [HRG](@).",grouptags:[],formPhrases:["mrg-ref{ss}","mrgref{ss}","mrg reference{ss}"],status:"proposed",created:20231127,updated:20231127,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],f={toc:p};function m(e){let{components:r,...t}=e;return(0,s.kt)("wrapper",(0,n.Z)({},f,t,{components:r,mdxType:"MDXLayout"}))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/65f59a55.9502c7df.js b/assets/js/65f59a55.8f6b4f1d.js similarity index 99% rename from assets/js/65f59a55.9502c7df.js rename to assets/js/65f59a55.8f6b4f1d.js index 0eddd5225..206fa004c 100644 --- a/assets/js/65f59a55.9502c7df.js +++ b/assets/js/65f59a55.8f6b4f1d.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[328],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>u});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=r.createContext({}),d=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},l=function(e){var t=d(e.components);return r.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,s=e.originalType,c=e.parentName,l=o(e,["components","mdxType","originalType","parentName"]),p=d(a),u=n,h=p["".concat(c,".").concat(u)]||p[u]||m[u]||s;return a?r.createElement(h,i(i({ref:t},l),{},{components:a})):r.createElement(h,i({ref:t},l))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=a.length,i=new Array(s);i[0]=p;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,i[1]=o;for(var d=2;d{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>m,frontMatter:()=>s,metadata:()=>o,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const s={id:"hrg",displayed_sidebar:"tev2SideBar",term:"hrg",termType:"concept",isa:"glossary",glossaryTerm:"Human Readable Glossary",glossaryAbbr:"HRG",glossaryText:"a [glossary](@) that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.",grouptags:["glossaries","data-structures"],formPhrases:["hrg{ss}","human-readable-glossar{yies}","human-readable-glossar{yies}-hrg{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG - Human Readable Glossary",o={unversionedId:"terms/hrg",id:"terms/hrg",title:"HRG - Human Readable Glossary",description:"A Human Readable Glossary or HRG is a glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding. Unlike dictionaries, the terms in a HRG are not ambiguous and have clear and well-defined meanings.",source:"@site/docs/terms/hrg.md",sourceDirName:"terms",slug:"/terms/hrg",permalink:"/tev2-specifications/docs/terms/hrg",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg",displayed_sidebar:"tev2SideBar",term:"hrg",termType:"concept",isa:"glossary",glossaryTerm:"Human Readable Glossary",glossaryAbbr:"HRG",glossaryText:"a [glossary](@) that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.",grouptags:["glossaries","data-structures"],formPhrases:["hrg{ss}","human-readable-glossar{yies}","human-readable-glossar{yies}-hrg{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],l={toc:d};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},l,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"hrg---human-readable-glossary"},"HRG - Human Readable Glossary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Human Readable Glossary")," or ",(0,n.kt)("strong",{parentName:"p"},"HRG")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding. Unlike ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," in a HRG are not ambiguous and have clear and well-defined ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"meanings"),"."))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[328],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>u});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var c=r.createContext({}),d=function(e){var t=r.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},l=function(e){var t=d(e.components);return r.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},p=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,s=e.originalType,c=e.parentName,l=o(e,["components","mdxType","originalType","parentName"]),p=d(a),u=n,h=p["".concat(c,".").concat(u)]||p[u]||m[u]||s;return a?r.createElement(h,i(i({ref:t},l),{},{components:a})):r.createElement(h,i({ref:t},l))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=a.length,i=new Array(s);i[0]=p;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:n,i[1]=o;for(var d=2;d{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>m,frontMatter:()=>s,metadata:()=>o,toc:()=>d});var r=a(3117),n=(a(7294),a(3905));const s={id:"hrg",displayed_sidebar:"tev2SideBar",term:"hrg",termType:"concept",isa:"glossary",glossaryTerm:"Human Readable Glossary",glossaryAbbr:"HRG",glossaryText:"a [glossary](@) that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.",grouptags:["glossaries","data-structures"],formPhrases:["hrg{ss}","human-readable-glossar{yies}","human-readable-glossar{yies}-hrg{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG - Human Readable Glossary",o={unversionedId:"terms/hrg",id:"terms/hrg",title:"HRG - Human Readable Glossary",description:"A Human Readable Glossary or HRG is a glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding. Unlike dictionaries, the terms in a HRG are not ambiguous and have clear and well-defined meanings.",source:"@site/docs/terms/hrg.md",sourceDirName:"terms",slug:"/terms/hrg",permalink:"/tev2-specifications/docs/terms/hrg",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg",displayed_sidebar:"tev2SideBar",term:"hrg",termType:"concept",isa:"glossary",glossaryTerm:"Human Readable Glossary",glossaryAbbr:"HRG",glossaryText:"a [glossary](@) that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding.",grouptags:["glossaries","data-structures"],formPhrases:["hrg{ss}","human-readable-glossar{yies}","human-readable-glossar{yies}-hrg{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[],l={toc:d};function m(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},l,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"hrg---human-readable-glossary"},"HRG - Human Readable Glossary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Human Readable Glossary")," or ",(0,n.kt)("strong",{parentName:"p"},"HRG")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding. Unlike ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," in a HRG are not ambiguous and have clear and well-defined ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"meanings"),"."))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/67283e50.21621b71.js b/assets/js/67283e50.e3f33abc.js similarity index 98% rename from assets/js/67283e50.21621b71.js rename to assets/js/67283e50.e3f33abc.js index c6074fc96..ed803ed59 100644 --- a/assets/js/67283e50.21621b71.js +++ b/assets/js/67283e50.e3f33abc.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[991],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>y});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},l=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=d(r),y=n,u=m["".concat(c,".").concat(y)]||m[y]||p[y]||i;return r?a.createElement(u,o(o({ref:t},l),{},{components:r})):a.createElement(u,o({ref:t},l))}));function y(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=r.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>p,frontMatter:()=>i,metadata:()=>s,toc:()=>d});var a=r(3117),n=(r(7294),r(3905));const i={id:"mrd",displayed_sidebar:"tev2SideBar",term:"mrd",termType:"concept",isa:"dictionary",glossaryTerm:"Machine Readable Dictionary",glossaryAbbr:"MRD",glossaryText:"a type of [dictionary](@) that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the [terms](@) and their meanings.",grouptags:[],formPhrases:["machine-readable-dictionar{yies}","mrd{ss}","machine-readable-dictionary-mrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Machine Readable Dictionary",s={unversionedId:"terms/mrd",id:"terms/mrd",title:"Machine Readable Dictionary",description:"A Machine Readable Dictionary is a type of dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the terms and their meanings.",source:"@site/docs/terms/mrd.md",sourceDirName:"terms",slug:"/terms/mrd",permalink:"/tev2-specifications/docs/terms/mrd",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrd.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrd",displayed_sidebar:"tev2SideBar",term:"mrd",termType:"concept",isa:"dictionary",glossaryTerm:"Machine Readable Dictionary",glossaryAbbr:"MRD",glossaryText:"a type of [dictionary](@) that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the [terms](@) and their meanings.",grouptags:[],formPhrases:["machine-readable-dictionar{yies}","mrd{ss}","machine-readable-dictionary-mrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],l={toc:d};function p(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"machine-readable-dictionary"},"Machine Readable Dictionary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Machine Readable Dictionary")," is a type of dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"An API documentation with a machine-readable dictionary enables developers to access and utilize data programmatically."),(0,n.kt)("li",{parentName:"ol"},"Language translation tools often use machine-readable dictionaries to automate the translation process.")),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Machine-readable dictionaries facilitate automated data retrieval and processing, improving efficiency in various applications."),(0,n.kt)("li",{parentName:"ul"},"The structured format allows for interoperability and compatibility across different systems and platforms.")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[991],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>y});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},l=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,i=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=d(r),y=n,u=m["".concat(c,".").concat(y)]||m[y]||p[y]||i;return r?a.createElement(u,o(o({ref:t},l),{},{components:r})):a.createElement(u,o({ref:t},l))}));function y(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var i=r.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>p,frontMatter:()=>i,metadata:()=>s,toc:()=>d});var a=r(3117),n=(r(7294),r(3905));const i={id:"mrd",displayed_sidebar:"tev2SideBar",term:"mrd",termType:"concept",isa:"dictionary",glossaryTerm:"Machine Readable Dictionary",glossaryAbbr:"MRD",glossaryText:"a type of [dictionary](@) that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the [terms](@) and their meanings.",grouptags:[],formPhrases:["machine-readable-dictionar{yies}","mrd{ss}","machine-readable-dictionary-mrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Machine Readable Dictionary",s={unversionedId:"terms/mrd",id:"terms/mrd",title:"Machine Readable Dictionary",description:"A Machine Readable Dictionary is a type of dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the terms and their meanings.",source:"@site/docs/terms/mrd.md",sourceDirName:"terms",slug:"/terms/mrd",permalink:"/tev2-specifications/docs/terms/mrd",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrd.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrd",displayed_sidebar:"tev2SideBar",term:"mrd",termType:"concept",isa:"dictionary",glossaryTerm:"Machine Readable Dictionary",glossaryAbbr:"MRD",glossaryText:"a type of [dictionary](@) that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the [terms](@) and their meanings.",grouptags:[],formPhrases:["machine-readable-dictionar{yies}","mrd{ss}","machine-readable-dictionary-mrd{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],l={toc:d};function p(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"machine-readable-dictionary"},"Machine Readable Dictionary"),(0,n.kt)("p",null,"A ",(0,n.kt)("strong",{parentName:"p"},"Machine Readable Dictionary")," is a type of dictionary that is formatted in a way that can be easily processed and interpreted by computers or software programs. It uses the YAML format to represent the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their meanings."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("ol",null,(0,n.kt)("li",{parentName:"ol"},"An API documentation with a machine-readable dictionary enables developers to access and utilize data programmatically."),(0,n.kt)("li",{parentName:"ol"},"Language translation tools often use machine-readable dictionaries to automate the translation process.")),(0,n.kt)("h2",{id:"notes"},"Notes"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"Machine-readable dictionaries facilitate automated data retrieval and processing, improving efficiency in various applications."),(0,n.kt)("li",{parentName:"ul"},"The structured format allows for interoperability and compatibility across different systems and platforms.")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/67d70933.9dec27e7.js b/assets/js/67d70933.dd17a66b.js similarity index 98% rename from assets/js/67d70933.9dec27e7.js rename to assets/js/67d70933.dd17a66b.js index 7b05d9ab8..f3daa6e1e 100644 --- a/assets/js/67d70933.9dec27e7.js +++ b/assets/js/67d70933.dd17a66b.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7332],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>m});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var a=n.createContext({}),l=function(e){var t=n.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},p=function(e){var t=l(e.components);return n.createElement(a.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,a=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),f=l(r),m=i,d=f["".concat(a,".").concat(m)]||f[m]||u[m]||o;return r?n.createElement(d,c(c({ref:t},p),{},{components:r})):n.createElement(d,c({ref:t},p))}));function m(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,c=new Array(o);c[0]=f;var s={};for(var a in t)hasOwnProperty.call(t,a)&&(s[a]=t[a]);s.originalType=e,s.mdxType="string"==typeof e?e:i,c[1]=s;for(var l=2;l{r.d(t,{Z:()=>v});var n=r(7294),i=r(6010),o=r(3438),c=r(9960),s=r(3919),a=r(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",u="cardDescription_PWke";function f(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},r)}function m(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(f,{href:t},n.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:o},r," ",o),c&&n.createElement("p",{className:(0,i.Z)("text--truncate",u),title:c},c))}function d(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(m,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,a.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function y(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,o.xz)(t.docId??void 0);return n.createElement(m,{href:t.href,icon:r,title:t.label,description:t.description??i?.description})}function g(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(y,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function h(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return n.createElement(h,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,i.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(g,{item:e})))))}},3256:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>a,toc:()=>p});var n=r(3117),i=(r(7294),r(3905)),o=r(2991);const c={id:"specs"},s="Specifications",a={unversionedId:"categories/specs",id:"categories/specs",title:"Specifications",description:"This section contains the specifications for the various TEv2 tools.",source:"@site/docs/categories/30-specs.md",sourceDirName:"categories",slug:"/categories/specs",permalink:"/tev2-specifications/docs/categories/specs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/30-specs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:30,frontMatter:{id:"specs"},sidebar:"tev2SideBar",previous:{title:"Terminology Construction",permalink:"/tev2-specifications/docs/manuals/curator/terminology-construction"},next:{title:"Specifications - Files",permalink:"/tev2-specifications/docs/categories/specs-files"}},l={},p=[],u={toc:p};function f(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications"},"Specifications"),(0,i.kt)("p",null,"This section contains the specifications for the various ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools"),".\nSubsections specify things like syntaxes, files that are used, the individual tools themselves, etc."),(0,i.kt)(o.Z,{folder:"/docs/specs",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7332],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>m});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var a=n.createContext({}),l=function(e){var t=n.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},p=function(e){var t=l(e.components);return n.createElement(a.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,a=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),f=l(r),m=i,d=f["".concat(a,".").concat(m)]||f[m]||u[m]||o;return r?n.createElement(d,c(c({ref:t},p),{},{components:r})):n.createElement(d,c({ref:t},p))}));function m(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,c=new Array(o);c[0]=f;var s={};for(var a in t)hasOwnProperty.call(t,a)&&(s[a]=t[a]);s.originalType=e,s.mdxType="string"==typeof e?e:i,c[1]=s;for(var l=2;l{r.d(t,{Z:()=>v});var n=r(7294),i=r(6010),o=r(3438),c=r(9960),s=r(3919),a=r(5999);const l="cardContainer_fWXF",p="cardTitle_rnsV",u="cardDescription_PWke";function f(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},r)}function m(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(f,{href:t},n.createElement("h2",{className:(0,i.Z)("text--truncate",p),title:o},r," ",o),c&&n.createElement("p",{className:(0,i.Z)("text--truncate",u),title:c},c))}function d(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(m,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,a.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function y(e){let{item:t}=e;const r=(0,s.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,o.xz)(t.docId??void 0);return n.createElement(m,{href:t.href,icon:r,title:t.label,description:t.description??i?.description})}function g(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(y,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function h(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(v,{items:r.items,className:t})}function v(e){const{items:t,className:r}=e;if(!t)return n.createElement(h,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,i.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(g,{item:e})))))}},3256:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>l,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>a,toc:()=>p});var n=r(3117),i=(r(7294),r(3905)),o=r(2991);const c={id:"specs"},s="Specifications",a={unversionedId:"categories/specs",id:"categories/specs",title:"Specifications",description:"This section contains the specifications for the various TEv2 tools.",source:"@site/docs/categories/30-specs.md",sourceDirName:"categories",slug:"/categories/specs",permalink:"/tev2-specifications/docs/categories/specs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/30-specs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:30,frontMatter:{id:"specs"},sidebar:"tev2SideBar",previous:{title:"Terminology Construction",permalink:"/tev2-specifications/docs/manuals/curator/terminology-construction"},next:{title:"Specifications - Files",permalink:"/tev2-specifications/docs/categories/specs-files"}},l={},p=[],u={toc:p};function f(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"specifications"},"Specifications"),(0,i.kt)("p",null,"This section contains the specifications for the various ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools"),".\nSubsections specify things like syntaxes, files that are used, the individual tools themselves, etc."),(0,i.kt)(o.Z,{folder:"/docs/specs",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/6b3de583.8d495837.js b/assets/js/6b3de583.d16bf757.js similarity index 99% rename from assets/js/6b3de583.8d495837.js rename to assets/js/6b3de583.d16bf757.js index ad7682eeb..f942f94c2 100644 --- a/assets/js/6b3de583.8d495837.js +++ b/assets/js/6b3de583.d16bf757.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4730],{3905:(t,e,i)=>{i.d(e,{Zo:()=>l,kt:()=>p});var a=i(7294);function o(t,e,i){return e in t?Object.defineProperty(t,e,{value:i,enumerable:!0,configurable:!0,writable:!0}):t[e]=i,t}function r(t,e){var i=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),i.push.apply(i,a)}return i}function n(t){for(var e=1;e=0||(o[i]=t[i]);return o}(t,e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,i)&&(o[i]=t[i])}return o}var c=a.createContext({}),d=function(t){var e=a.useContext(c),i=e;return t&&(i="function"==typeof t?t(e):n(n({},e),t)),i},l=function(t){var e=d(t.components);return a.createElement(c.Provider,{value:e},t.children)},f={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},h=a.forwardRef((function(t,e){var i=t.components,o=t.mdxType,r=t.originalType,c=t.parentName,l=s(t,["components","mdxType","originalType","parentName"]),h=d(i),p=o,u=h["".concat(c,".").concat(p)]||h[p]||f[p]||r;return i?a.createElement(u,n(n({ref:e},l),{},{components:i})):a.createElement(u,n({ref:e},l))}));function p(t,e){var i=arguments,o=e&&e.mdxType;if("string"==typeof t||o){var r=i.length,n=new Array(r);n[0]=h;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:o,n[1]=s;for(var d=2;d{i.r(e),i.d(e,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>r,metadata:()=>s,toc:()=>d});var a=i(3117),o=(i(7294),i(3905));i(4996);const r={id:"body-file",sidebar_label:"Body Files",date:20231009},n="Body Files",s={unversionedId:"specs/files/body-file",id:"specs/files/body-file",title:"Body Files",description:"A body file contains the body of a curated text, i.e. the text that documents a semantic unit, but has no a-priori structure whatsoever (as that would be part of the header of that curated text).",source:"@site/docs/specs/files/11-body-file.md",sourceDirName:"specs/files",slug:"/specs/files/body-file",permalink:"/tev2-specifications/docs/specs/files/body-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/11-body-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:11,frontMatter:{id:"body-file",sidebar_label:"Body Files",date:20231009},sidebar:"tev2SideBar",previous:{title:"Curated Text Files",permalink:"/tev2-specifications/docs/specs/files/curated-text-file"},next:{title:"SAF (Scope Admin File)",permalink:"/tev2-specifications/docs/specs/files/saf"}},c={},d=[],l={toc:d};function f(t){let{components:e,...i}=t;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:e,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"body-files"},"Body Files"),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," contains the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", i.e. the text that documents a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", but has no a-priori structure whatsoever (as that would be part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),")."),(0,o.kt)("p",null,"Typically, body files are pieces of documentation about a particular ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other kind of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),") that already serve a purpose in some documentation set. For example, a set of documents that constitute, e.g., an architecture, or a specification, would contain files that specify a particular entity (e.g., a component, or a protocol). The contents of these files could then serve as the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that particular entity."),(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"Body files")," are to be located within the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of which they are part, so that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can properly find and operate on them.")}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4730],{3905:(t,e,i)=>{i.d(e,{Zo:()=>l,kt:()=>p});var a=i(7294);function o(t,e,i){return e in t?Object.defineProperty(t,e,{value:i,enumerable:!0,configurable:!0,writable:!0}):t[e]=i,t}function r(t,e){var i=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),i.push.apply(i,a)}return i}function n(t){for(var e=1;e=0||(o[i]=t[i]);return o}(t,e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,i)&&(o[i]=t[i])}return o}var c=a.createContext({}),d=function(t){var e=a.useContext(c),i=e;return t&&(i="function"==typeof t?t(e):n(n({},e),t)),i},l=function(t){var e=d(t.components);return a.createElement(c.Provider,{value:e},t.children)},f={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},h=a.forwardRef((function(t,e){var i=t.components,o=t.mdxType,r=t.originalType,c=t.parentName,l=s(t,["components","mdxType","originalType","parentName"]),h=d(i),p=o,u=h["".concat(c,".").concat(p)]||h[p]||f[p]||r;return i?a.createElement(u,n(n({ref:e},l),{},{components:i})):a.createElement(u,n({ref:e},l))}));function p(t,e){var i=arguments,o=e&&e.mdxType;if("string"==typeof t||o){var r=i.length,n=new Array(r);n[0]=h;var s={};for(var c in e)hasOwnProperty.call(e,c)&&(s[c]=e[c]);s.originalType=t,s.mdxType="string"==typeof t?t:o,n[1]=s;for(var d=2;d{i.r(e),i.d(e,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>r,metadata:()=>s,toc:()=>d});var a=i(3117),o=(i(7294),i(3905));i(4996);const r={id:"body-file",sidebar_label:"Body Files",date:20231009},n="Body Files",s={unversionedId:"specs/files/body-file",id:"specs/files/body-file",title:"Body Files",description:"A body file contains the body of a curated text, i.e. the text that documents a semantic unit, but has no a-priori structure whatsoever (as that would be part of the header of that curated text).",source:"@site/docs/specs/files/11-body-file.md",sourceDirName:"specs/files",slug:"/specs/files/body-file",permalink:"/tev2-specifications/docs/specs/files/body-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/11-body-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:11,frontMatter:{id:"body-file",sidebar_label:"Body Files",date:20231009},sidebar:"tev2SideBar",previous:{title:"Curated Text Files",permalink:"/tev2-specifications/docs/specs/files/curated-text-file"},next:{title:"SAF (Scope Admin File)",permalink:"/tev2-specifications/docs/specs/files/saf"}},c={},d=[],l={toc:d};function f(t){let{components:e,...i}=t;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:e,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"body-files"},"Body Files"),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," contains the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),", i.e. the text that documents a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", but has no a-priori structure whatsoever (as that would be part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/curated-text-file",title:"Header (of a Curated Text): the part of a Curated Text, which is at the beginning of that text, that starts with a line that (only) contains three subsequent '-'characters, and that ends with a second occurrence of such a line."},"header")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),")."),(0,o.kt)("p",null,"Typically, body files are pieces of documentation about a particular ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," (or other kind of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),") that already serve a purpose in some documentation set. For example, a set of documents that constitute, e.g., an architecture, or a specification, would contain files that specify a particular entity (e.g., a component, or a protocol). The contents of these files could then serve as the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that documents that particular entity."),(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"Body files")," are to be located within the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curatedir",title:"Curatedir: a directory within a Scopedir within which every file contains a Curated Text for that Scope."},"curatedir")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of which they are part, so that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tools")," can properly find and operate on them.")}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/6db347e8.17cc4822.js b/assets/js/6db347e8.7f0c62e1.js similarity index 99% rename from assets/js/6db347e8.17cc4822.js rename to assets/js/6db347e8.7f0c62e1.js index 7cf5d7f0f..130d63f1c 100644 --- a/assets/js/6db347e8.17cc4822.js +++ b/assets/js/6db347e8.7f0c62e1.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3214],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>d});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),p=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},l=function(e){var t=p(e.components);return a.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,s=e.originalType,c=e.parentName,l=n(e,["components","mdxType","originalType","parentName"]),f=p(i),d=o,m=f["".concat(c,".").concat(d)]||f[d]||h[d]||s;return i?a.createElement(m,r(r({ref:t},l),{},{components:i})):a.createElement(m,r({ref:t},l))}));function d(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=i.length,r=new Array(s);r[0]=f;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:o,r[1]=n;for(var p=2;p{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>s,metadata:()=>n,toc:()=>p});var a=i(3117),o=(i(7294),i(3905));const s={id:"scopetag",displayed_sidebar:"tev2SideBar",term:"scopetag",termType:"concept",isa:"tag",glossaryTerm:null,glossaryText:"a [tag](@) that is used to identify [scopes](@) from within a specific [scope](@)",grouptags:[],formPhrases:["scopetag{ss}","scope-tag{ss}"],status:"proposed",created:20220606,updated:20220728,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Scopetag",n={unversionedId:"terms/scopetag",id:"terms/scopetag",title:"Scopetag",description:"Summary",source:"@site/docs/terms/scopetag.md",sourceDirName:"terms",slug:"/terms/scopetag",permalink:"/tev2-specifications/docs/terms/scopetag",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scopetag.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scopetag",displayed_sidebar:"tev2SideBar",term:"scopetag",termType:"concept",isa:"tag",glossaryTerm:null,glossaryText:"a [tag](@) that is used to identify [scopes](@) from within a specific [scope](@)",grouptags:[],formPhrases:["scopetag{ss}","scope-tag{ss}"],status:"proposed",created:20220606,updated:20220728,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Summary",id:"summary",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],l={toc:p};function h(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"scopetag"},"Scopetag"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scopetag")," is a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", e.g. in ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,o.kt)("p",null,"Scopetags identify a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (from within a given ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), and hence can be used (within that given ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") to disambiguate ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("h3",{id:"criteria"},"Criteria"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scopetag")," (of/within a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") is a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to identify itself or other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),". It satisfies the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,o.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),"."),(0,o.kt)("h3",{id:"examples"},"Examples"),(0,o.kt)("p",null,"Examples of scopetags are ",(0,o.kt)("inlineCode",{parentName:"p"},"essif-lab"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"toip"),", or ",(0,o.kt)("inlineCode",{parentName:"p"},"ctwg"),"."),(0,o.kt)("h3",{id:"notes"},"Notes"),(0,o.kt)("p",null,"Discussions about which ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," a tag should satisfy must be held with care. For example, one might argue that allowing the ",(0,o.kt)("inlineCode",{parentName:"p"},".")," character for ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," might be beneficial. However, allowing a ",(0,o.kt)("inlineCode",{parentName:"p"},".")," character in a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," may cause problems with (the alternative syntax) of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", as email address in square brackets might then qualify as a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," while that is very likely not the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"'s intention."))}h.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3214],{3905:(e,t,i)=>{i.d(t,{Zo:()=>l,kt:()=>d});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function s(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function r(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),p=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},l=function(e){var t=p(e.components);return a.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,s=e.originalType,c=e.parentName,l=n(e,["components","mdxType","originalType","parentName"]),f=p(i),d=o,m=f["".concat(c,".").concat(d)]||f[d]||h[d]||s;return i?a.createElement(m,r(r({ref:t},l),{},{components:i})):a.createElement(m,r({ref:t},l))}));function d(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=i.length,r=new Array(s);r[0]=f;var n={};for(var c in t)hasOwnProperty.call(t,c)&&(n[c]=t[c]);n.originalType=e,n.mdxType="string"==typeof e?e:o,r[1]=n;for(var p=2;p{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>s,metadata:()=>n,toc:()=>p});var a=i(3117),o=(i(7294),i(3905));const s={id:"scopetag",displayed_sidebar:"tev2SideBar",term:"scopetag",termType:"concept",isa:"tag",glossaryTerm:null,glossaryText:"a [tag](@) that is used to identify [scopes](@) from within a specific [scope](@)",grouptags:[],formPhrases:["scopetag{ss}","scope-tag{ss}"],status:"proposed",created:20220606,updated:20220728,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Scopetag",n={unversionedId:"terms/scopetag",id:"terms/scopetag",title:"Scopetag",description:"Summary",source:"@site/docs/terms/scopetag.md",sourceDirName:"terms",slug:"/terms/scopetag",permalink:"/tev2-specifications/docs/terms/scopetag",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/scopetag.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"scopetag",displayed_sidebar:"tev2SideBar",term:"scopetag",termType:"concept",isa:"tag",glossaryTerm:null,glossaryText:"a [tag](@) that is used to identify [scopes](@) from within a specific [scope](@)",grouptags:[],formPhrases:["scopetag{ss}","scope-tag{ss}"],status:"proposed",created:20220606,updated:20220728,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Summary",id:"summary",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],l={toc:p};function h(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},l,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"scopetag"},"Scopetag"),(0,o.kt)("h3",{id:"summary"},"Summary"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scopetag")," is a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used to identify ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", e.g. in ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,o.kt)("p",null,"Scopetags identify a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," (from within a given ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"), and hence can be used (within that given ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") to disambiguate ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),"."),(0,o.kt)("p",null,"The ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,o.kt)("h3",{id:"criteria"},"Criteria"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scopetag")," (of/within a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") is a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/tag",title:"Tag: an alphanumeric string that is used to identify Scopes (so called 'scopetags'), group Terms (so called 'grouptags'), or identify a specific version of a Terminology (so called 'versiontags') from within a specific Scope."},"tag")," that is used within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," to identify itself or other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),". It satisfies the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," ",(0,o.kt)("inlineCode",{parentName:"p"},"[a-z0-9_-]+"),"."),(0,o.kt)("h3",{id:"examples"},"Examples"),(0,o.kt)("p",null,"Examples of scopetags are ",(0,o.kt)("inlineCode",{parentName:"p"},"essif-lab"),", ",(0,o.kt)("inlineCode",{parentName:"p"},"toip"),", or ",(0,o.kt)("inlineCode",{parentName:"p"},"ctwg"),"."),(0,o.kt)("h3",{id:"notes"},"Notes"),(0,o.kt)("p",null,"Discussions about which ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," a tag should satisfy must be held with care. For example, one might argue that allowing the ",(0,o.kt)("inlineCode",{parentName:"p"},".")," character for ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," might be beneficial. However, allowing a ",(0,o.kt)("inlineCode",{parentName:"p"},".")," character in a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," may cause problems with (the alternative syntax) of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),", as email address in square brackets might then qualify as a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," while that is very likely not the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"'s intention."))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/6f1c0af3.a6e38350.js b/assets/js/6f1c0af3.cb34cb18.js similarity index 98% rename from assets/js/6f1c0af3.a6e38350.js rename to assets/js/6f1c0af3.cb34cb18.js index db080110b..1e0f41fd5 100644 --- a/assets/js/6f1c0af3.a6e38350.js +++ b/assets/js/6f1c0af3.cb34cb18.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[5402],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>m});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,s=e.parentName,u=a(e,["components","mdxType","originalType","parentName"]),p=l(r),m=i,f=p["".concat(s,".").concat(m)]||p[m]||d[m]||o;return r?n.createElement(f,c(c({ref:t},u),{},{components:r})):n.createElement(f,c({ref:t},u))}));function m(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,c=new Array(o);c[0]=p;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a.mdxType="string"==typeof e?e:i,c[1]=a;for(var l=2;l{r.d(t,{Z:()=>h});var n=r(7294),i=r(6010),o=r(3438),c=r(9960),a=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",d="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},r)}function m(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,i.Z)("text--truncate",u),title:o},r," ",o),c&&n.createElement("p",{className:(0,i.Z)("text--truncate",d),title:c},c))}function f(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(m,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,o.xz)(t.docId??void 0);return n.createElement(m,{href:t.href,icon:r,title:t.label,description:t.description??i?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(f,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function b(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(h,{items:r.items,className:t})}function h(e){const{items:t,className:r}=e;if(!t)return n.createElement(b,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,i.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},4814:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>m,frontMatter:()=>a,metadata:()=>l,toc:()=>d});var n=r(3117),i=(r(7294),r(3905)),o=r(4996),c=r(2991);const a={id:"guides"},s="Guides",l={unversionedId:"categories/guides",id:"categories/guides",title:"Guides",description:"{r.d(t,{Zo:()=>u,kt:()=>m});var n=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):c(c({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,i=e.mdxType,o=e.originalType,s=e.parentName,u=a(e,["components","mdxType","originalType","parentName"]),p=l(r),m=i,f=p["".concat(s,".").concat(m)]||p[m]||d[m]||o;return r?n.createElement(f,c(c({ref:t},u),{},{components:r})):n.createElement(f,c({ref:t},u))}));function m(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=r.length,c=new Array(o);c[0]=p;var a={};for(var s in t)hasOwnProperty.call(t,s)&&(a[s]=t[s]);a.originalType=e,a.mdxType="string"==typeof e?e:i,c[1]=a;for(var l=2;l{r.d(t,{Z:()=>h});var n=r(7294),i=r(6010),o=r(3438),c=r(9960),a=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",d="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(c.Z,{href:t,className:(0,i.Z)("card padding--lg",l)},r)}function m(e){let{href:t,icon:r,title:o,description:c}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,i.Z)("text--truncate",u),title:o},r," ",o),c&&n.createElement("p",{className:(0,i.Z)("text--truncate",d),title:c},c))}function f(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(m,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,a.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",i=(0,o.xz)(t.docId??void 0);return n.createElement(m,{href:t.href,icon:r,title:t.label,description:t.description??i?.description})}function y(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(f,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function b(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(h,{items:r.items,className:t})}function h(e){const{items:t,className:r}=e;if(!t)return n.createElement(b,e);const c=(0,o.MN)(t);return n.createElement("section",{className:(0,i.Z)("row",r)},c.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(y,{item:e})))))}},4814:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>m,frontMatter:()=>a,metadata:()=>l,toc:()=>d});var n=r(3117),i=(r(7294),r(3905)),o=r(4996),c=r(2991);const a={id:"guides"},s="Guides",l={unversionedId:"categories/guides",id:"categories/guides",title:"Guides",description:"{r.d(t,{Zo:()=>h,kt:()=>p});var a=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function i(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},h=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var r=e.components,s=e.mdxType,n=e.originalType,c=e.parentName,h=o(e,["components","mdxType","originalType","parentName"]),l=d(r),p=s,f=l["".concat(c,".").concat(p)]||l[p]||m[p]||n;return r?a.createElement(f,i(i({ref:t},h),{},{components:r})):a.createElement(f,i({ref:t},h))}));function p(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=r.length,i=new Array(n);i[0]=l;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:s,i[1]=o;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>m,frontMatter:()=>n,metadata:()=>o,toc:()=>d});var a=r(3117),s=(r(7294),r(3905));const n={id:"hrg-entry",displayed_sidebar:"tev2SideBar",term:"hrg-entry",termType:"concept",isa:"glossary-entry",glossaryTerm:"HRG Entry",glossaryText:"A specific kind of (human-readable) rendering of the combination of a [term](@) and a means that helps [readers](@) to understand the meaning of that [term](@) when it is used in a sentence.",grouptags:["glossary-entries","reference-materials"],formPhrases:["hrg-entr{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG Entry",o={unversionedId:"terms/hrg-entry",id:"terms/hrg-entry",title:"HRG Entry",description:"An HRG Entry is a specific kind of (human-readable) rendering of the combination of a term and a means that helps readers to understand the meaning of that term when it is used in a sentence.",source:"@site/docs/terms/hrg-entry.md",sourceDirName:"terms",slug:"/terms/hrg-entry",permalink:"/tev2-specifications/docs/terms/hrg-entry",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg-entry.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg-entry",displayed_sidebar:"tev2SideBar",term:"hrg-entry",termType:"concept",isa:"glossary-entry",glossaryTerm:"HRG Entry",glossaryText:"A specific kind of (human-readable) rendering of the combination of a [term](@) and a means that helps [readers](@) to understand the meaning of that [term](@) when it is used in a sentence.",grouptags:["glossary-entries","reference-materials"],formPhrases:["hrg-entr{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Purpose",id:"purpose",level:3}],h={toc:d};function m(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,a.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"hrg-entry"},"HRG Entry"),(0,s.kt)("p",null,"An ",(0,s.kt)("strong",{parentName:"p"},"HRG Entry")," is a specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps readers to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("p",null,"The way in which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is rendered depends on how the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," is called. Specifically, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is defined as a ",(0,s.kt)("inlineCode",{parentName:"p"},"synonymOf")," another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may be rendered in a way that differs from the way in which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are rendered that are not a ",(0,s.kt)("inlineCode",{parentName:"p"},"synonymOf")," some other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". Details are provided in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT specs"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT specs")," document how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are selected (and manipulated) for the construction of a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),". They also document how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are rendered that are, and those that are not ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," of some other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (there may be differences between them)."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," provide a specific kind of(human-readable) rendering for the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence, thus facilitating the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader's")," understanding of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in the way that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended.",(0,s.kt)("p",null,"As an example, consider a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," that would like to have an overview of all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it uses in a human readable way, and decides it needs a (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". Thus, they need a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," that knows how to find all these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and (after sorting them) render them into some human readable form. This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," would look for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", which contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that contain all data that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," needs."),(0,s.kt)("p",null,"As the number of tools that need (meta) data about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," grows, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be expected to cater for such needs."))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4988],{3905:(e,t,r)=>{r.d(t,{Zo:()=>h,kt:()=>p});var a=r(7294);function s(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function i(e){for(var t=1;t=0||(s[r]=e[r]);return s}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(s[r]=e[r])}return s}var c=a.createContext({}),d=function(e){var t=a.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},h=function(e){var t=d(e.components);return a.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},l=a.forwardRef((function(e,t){var r=e.components,s=e.mdxType,n=e.originalType,c=e.parentName,h=o(e,["components","mdxType","originalType","parentName"]),l=d(r),p=s,f=l["".concat(c,".").concat(p)]||l[p]||m[p]||n;return r?a.createElement(f,i(i({ref:t},h),{},{components:r})):a.createElement(f,i({ref:t},h))}));function p(e,t){var r=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var n=r.length,i=new Array(n);i[0]=l;var o={};for(var c in t)hasOwnProperty.call(t,c)&&(o[c]=t[c]);o.originalType=e,o.mdxType="string"==typeof e?e:s,i[1]=o;for(var d=2;d{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>m,frontMatter:()=>n,metadata:()=>o,toc:()=>d});var a=r(3117),s=(r(7294),r(3905));const n={id:"hrg-entry",displayed_sidebar:"tev2SideBar",term:"hrg-entry",termType:"concept",isa:"glossary-entry",glossaryTerm:"HRG Entry",glossaryText:"A specific kind of (human-readable) rendering of the combination of a [term](@) and a means that helps [readers](@) to understand the meaning of that [term](@) when it is used in a sentence.",grouptags:["glossary-entries","reference-materials"],formPhrases:["hrg-entr{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="HRG Entry",o={unversionedId:"terms/hrg-entry",id:"terms/hrg-entry",title:"HRG Entry",description:"An HRG Entry is a specific kind of (human-readable) rendering of the combination of a term and a means that helps readers to understand the meaning of that term when it is used in a sentence.",source:"@site/docs/terms/hrg-entry.md",sourceDirName:"terms",slug:"/terms/hrg-entry",permalink:"/tev2-specifications/docs/terms/hrg-entry",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/hrg-entry.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"hrg-entry",displayed_sidebar:"tev2SideBar",term:"hrg-entry",termType:"concept",isa:"glossary-entry",glossaryTerm:"HRG Entry",glossaryText:"A specific kind of (human-readable) rendering of the combination of a [term](@) and a means that helps [readers](@) to understand the meaning of that [term](@) when it is used in a sentence.",grouptags:["glossary-entries","reference-materials"],formPhrases:["hrg-entr{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},d=[{value:"Purpose",id:"purpose",level:3}],h={toc:d};function m(e){let{components:t,...r}=e;return(0,s.kt)("wrapper",(0,a.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"hrg-entry"},"HRG Entry"),(0,s.kt)("p",null,"An ",(0,s.kt)("strong",{parentName:"p"},"HRG Entry")," is a specific kind of (human-readable) rendering of the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps readers to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence."),(0,s.kt)("p",null,"The way in which a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," is rendered depends on how the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT")," is called. Specifically, a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is defined as a ",(0,s.kt)("inlineCode",{parentName:"p"},"synonymOf")," another ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," may be rendered in a way that differs from the way in which ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are rendered that are not a ",(0,s.kt)("inlineCode",{parentName:"p"},"synonymOf")," some other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". Details are provided in the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT specs"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT specs")," document how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," are selected (and manipulated) for the construction of a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG"),". They also document how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," are rendered that are, and those that are not ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/synonym",title:"Synonym (of a [term](@)): a Term that has the same (or sufficiently similar) meaning as another Term (i.e., the Term of which it is a Synonym."},"synonyms")," of some other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," (there may be differences between them)."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entries")," provide a specific kind of(human-readable) rendering for the combination of a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," and a means that helps ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to understand the meaning of that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," when it is used in a sentence, thus facilitating the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader's")," understanding of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," in the way that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," intended.",(0,s.kt)("p",null,"As an example, consider a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," that would like to have an overview of all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it uses in a human readable way, and decides it needs a (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". Thus, they need a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," that knows how to find all these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and (after sorting them) render them into some human readable form. This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," would look for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", which contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that contain all data that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," needs."),(0,s.kt)("p",null,"As the number of tools that need (meta) data about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," grows, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be expected to cater for such needs."))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/735a4e9a.a1e081f7.js b/assets/js/735a4e9a.9e8df7c3.js similarity index 98% rename from assets/js/735a4e9a.a1e081f7.js rename to assets/js/735a4e9a.9e8df7c3.js index 8805e6e31..e9e5be306 100644 --- a/assets/js/735a4e9a.a1e081f7.js +++ b/assets/js/735a4e9a.9e8df7c3.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9399],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var a=n.createContext({}),p=function(e){var t=n.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=p(e.components);return n.createElement(a.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},d=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,s=e.originalType,a=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),d=p(r),m=o,f=d["".concat(a,".").concat(m)]||d[m]||l[m]||s;return r?n.createElement(f,i(i({ref:t},u),{},{components:r})):n.createElement(f,i({ref:t},u))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=r.length,i=new Array(s);i[0]=d;var c={};for(var a in t)hasOwnProperty.call(t,a)&&(c[a]=t[a]);c.originalType=e,c.mdxType="string"==typeof e?e:o,i[1]=c;for(var p=2;p{r.r(t),r.d(t,{assets:()=>a,contentTitle:()=>i,default:()=>l,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var n=r(3117),o=(r(7294),r(3905));const s={id:"current-scope",displayed_sidebar:"tev2SideBar",term:"current-scope",termType:"concept",isa:null,glossaryTerm:"Current Scope",glossaryText:"the [scope](@) that is the context within which a [curator](@) is acting, or a tool is being called.",grouptags:[],formPhrases:["current-scope{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Current Scope",c={unversionedId:"terms/current-scope",id:"terms/current-scope",title:"Current Scope",description:"Further contents for this term will be authored as the need arises.",source:"@site/docs/terms/current-scope.md",sourceDirName:"terms",slug:"/terms/current-scope",permalink:"/tev2-specifications/docs/terms/current-scope",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/current-scope.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"current-scope",displayed_sidebar:"tev2SideBar",term:"current-scope",termType:"concept",isa:null,glossaryTerm:"Current Scope",glossaryText:"the [scope](@) that is the context within which a [curator](@) is acting, or a tool is being called.",grouptags:[],formPhrases:["current-scope{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},a={},p=[],u={toc:p};function l(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"current-scope"},"Current Scope"),(0,o.kt)("admonition",{title:"Editor's Note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"Further contents for this term will be authored as the need arises.")))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9399],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var a=n.createContext({}),p=function(e){var t=n.useContext(a),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=p(e.components);return n.createElement(a.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},d=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,s=e.originalType,a=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),d=p(r),m=o,f=d["".concat(a,".").concat(m)]||d[m]||l[m]||s;return r?n.createElement(f,i(i({ref:t},u),{},{components:r})):n.createElement(f,i({ref:t},u))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var s=r.length,i=new Array(s);i[0]=d;var c={};for(var a in t)hasOwnProperty.call(t,a)&&(c[a]=t[a]);c.originalType=e,c.mdxType="string"==typeof e?e:o,i[1]=c;for(var p=2;p{r.r(t),r.d(t,{assets:()=>a,contentTitle:()=>i,default:()=>l,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var n=r(3117),o=(r(7294),r(3905));const s={id:"current-scope",displayed_sidebar:"tev2SideBar",term:"current-scope",termType:"concept",isa:null,glossaryTerm:"Current Scope",glossaryText:"the [scope](@) that is the context within which a [curator](@) is acting, or a tool is being called.",grouptags:[],formPhrases:["current-scope{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Current Scope",c={unversionedId:"terms/current-scope",id:"terms/current-scope",title:"Current Scope",description:"Further contents for this term will be authored as the need arises.",source:"@site/docs/terms/current-scope.md",sourceDirName:"terms",slug:"/terms/current-scope",permalink:"/tev2-specifications/docs/terms/current-scope",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/current-scope.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"current-scope",displayed_sidebar:"tev2SideBar",term:"current-scope",termType:"concept",isa:null,glossaryTerm:"Current Scope",glossaryText:"the [scope](@) that is the context within which a [curator](@) is acting, or a tool is being called.",grouptags:[],formPhrases:["current-scope{ss}"],status:"proposed",created:20231009,updated:20231009,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},a={},p=[],u={toc:p};function l(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},u,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"current-scope"},"Current Scope"),(0,o.kt)("admonition",{title:"Editor's Note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"Further contents for this term will be authored as the need arises.")))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/7567abf2.a949a786.js b/assets/js/7567abf2.2253ddcf.js similarity index 99% rename from assets/js/7567abf2.a949a786.js rename to assets/js/7567abf2.2253ddcf.js index 8ee1ce7a2..7da210b03 100644 --- a/assets/js/7567abf2.a949a786.js +++ b/assets/js/7567abf2.2253ddcf.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[8948],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>p});var i=a(7294);function s(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function n(t){for(var e=1;e=0||(s[a]=t[a]);return s}(t,e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(s[a]=t[a])}return s}var c=i.createContext({}),m=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):n(n({},e),t)),a},d=function(t){var e=m(t.components);return i.createElement(c.Provider,{value:e},t.children)},l={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},h=i.forwardRef((function(t,e){var a=t.components,s=t.mdxType,r=t.originalType,c=t.parentName,d=o(t,["components","mdxType","originalType","parentName"]),h=m(a),p=s,f=h["".concat(c,".").concat(p)]||h[p]||l[p]||r;return a?i.createElement(f,n(n({ref:e},d),{},{components:a})):i.createElement(f,n({ref:e},d))}));function p(t,e){var a=arguments,s=e&&e.mdxType;if("string"==typeof t||s){var r=a.length,n=new Array(r);n[0]=h;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:s,n[1]=o;for(var m=2;m{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>r,metadata:()=>o,toc:()=>m});var i=a(3117),s=(a(7294),a(3905));const r={id:"mrg-entry",displayed_sidebar:"tev2SideBar",term:"mrg-entry",termType:"concept",isa:null,glossaryTerm:"MRG Entry",glossaryText:"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular [semantic unit](@), such as the associated [term(s)](@), its [definition](@), etc., to make it easy for IT-tools to create, e.g. documentation, [glossaries](@), [dictionaries](@), whitepapers, etc. that uses such [terms](@) ([definitions](@), etc.).",grouptags:[],formPhrases:["mrg-entr{yies}","mrgentr{yies}"],status:"proposed",created:20220811,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="MRG Entry",o={unversionedId:"terms/mrg-entry",id:"terms/mrg-entry",title:"MRG Entry",description:"An MRG Entry is a machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular semantic unit, such as the associated term(s), its definition, etc., to make it easy for IT-tools to create, e.g. documentation, glossaries, dictionaries, whitepapers, etc. that uses such terms (definitions, etc.).",source:"@site/docs/terms/mrg-entry.md",sourceDirName:"terms",slug:"/terms/mrg-entry",permalink:"/tev2-specifications/docs/terms/mrg-entry",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrg-entry.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrg-entry",displayed_sidebar:"tev2SideBar",term:"mrg-entry",termType:"concept",isa:null,glossaryTerm:"MRG Entry",glossaryText:"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular [semantic unit](@), such as the associated [term(s)](@), its [definition](@), etc., to make it easy for IT-tools to create, e.g. documentation, [glossaries](@), [dictionaries](@), whitepapers, etc. that uses such [terms](@) ([definitions](@), etc.).",grouptags:[],formPhrases:["mrg-entr{yies}","mrgentr{yies}"],status:"proposed",created:20220811,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Purpose",id:"purpose",level:3}],d={toc:m};function l(t){let{components:e,...a}=t;return(0,s.kt)("wrapper",(0,i.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"mrg-entry"},"MRG Entry"),(0,s.kt)("p",null,"An ",(0,s.kt)("strong",{parentName:"p"},"MRG Entry")," is a machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be seen as the collection of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that hold all data related to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of."),(0,s.kt)("p",null,"The contents of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," may vary, depending on the type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it documents. The kinds of data that are common for all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," are documented ",(0,s.kt)("a",{parentName:"p",href:"http://localhost:3000/docs/specs/files/mrg#entries"},"here"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"terminology construction manual")," describes how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," are selected (and manipulated) for the construction of a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," provide all (meta) data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that IT-tools might need for their own purposes.",(0,s.kt)("p",null,"As an example, consider a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," that would like to have an overview of all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it uses in a human readable way, and decides it needs a (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". Thus, they need a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," that knows how to find all these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and (after sorting them) render them into some human readable form. This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," would look for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", which contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that contain all data that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," needs."),(0,s.kt)("p",null,"As the number of tools that need (meta) data about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," grows, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be expected to cater for such needs."))}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[8948],{3905:(t,e,a)=>{a.d(e,{Zo:()=>d,kt:()=>p});var i=a(7294);function s(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function n(t){for(var e=1;e=0||(s[a]=t[a]);return s}(t,e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(s[a]=t[a])}return s}var c=i.createContext({}),m=function(t){var e=i.useContext(c),a=e;return t&&(a="function"==typeof t?t(e):n(n({},e),t)),a},d=function(t){var e=m(t.components);return i.createElement(c.Provider,{value:e},t.children)},l={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},h=i.forwardRef((function(t,e){var a=t.components,s=t.mdxType,r=t.originalType,c=t.parentName,d=o(t,["components","mdxType","originalType","parentName"]),h=m(a),p=s,f=h["".concat(c,".").concat(p)]||h[p]||l[p]||r;return a?i.createElement(f,n(n({ref:e},d),{},{components:a})):i.createElement(f,n({ref:e},d))}));function p(t,e){var a=arguments,s=e&&e.mdxType;if("string"==typeof t||s){var r=a.length,n=new Array(r);n[0]=h;var o={};for(var c in e)hasOwnProperty.call(e,c)&&(o[c]=e[c]);o.originalType=t,o.mdxType="string"==typeof t?t:s,n[1]=o;for(var m=2;m{a.r(e),a.d(e,{assets:()=>c,contentTitle:()=>n,default:()=>l,frontMatter:()=>r,metadata:()=>o,toc:()=>m});var i=a(3117),s=(a(7294),a(3905));const r={id:"mrg-entry",displayed_sidebar:"tev2SideBar",term:"mrg-entry",termType:"concept",isa:null,glossaryTerm:"MRG Entry",glossaryText:"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular [semantic unit](@), such as the associated [term(s)](@), its [definition](@), etc., to make it easy for IT-tools to create, e.g. documentation, [glossaries](@), [dictionaries](@), whitepapers, etc. that uses such [terms](@) ([definitions](@), etc.).",grouptags:[],formPhrases:["mrg-entr{yies}","mrgentr{yies}"],status:"proposed",created:20220811,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="MRG Entry",o={unversionedId:"terms/mrg-entry",id:"terms/mrg-entry",title:"MRG Entry",description:"An MRG Entry is a machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular semantic unit, such as the associated term(s), its definition, etc., to make it easy for IT-tools to create, e.g. documentation, glossaries, dictionaries, whitepapers, etc. that uses such terms (definitions, etc.).",source:"@site/docs/terms/mrg-entry.md",sourceDirName:"terms",slug:"/terms/mrg-entry",permalink:"/tev2-specifications/docs/terms/mrg-entry",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/mrg-entry.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"mrg-entry",displayed_sidebar:"tev2SideBar",term:"mrg-entry",termType:"concept",isa:null,glossaryTerm:"MRG Entry",glossaryText:"A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular [semantic unit](@), such as the associated [term(s)](@), its [definition](@), etc., to make it easy for IT-tools to create, e.g. documentation, [glossaries](@), [dictionaries](@), whitepapers, etc. that uses such [terms](@) ([definitions](@), etc.).",grouptags:[],formPhrases:["mrg-entr{yies}","mrgentr{yies}"],status:"proposed",created:20220811,updated:20220811,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Purpose",id:"purpose",level:3}],d={toc:m};function l(t){let{components:e,...a}=t;return(0,s.kt)("wrapper",(0,i.Z)({},d,a,{components:e,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"mrg-entry"},"MRG Entry"),(0,s.kt)("p",null,"An ",(0,s.kt)("strong",{parentName:"p"},"MRG Entry")," is a machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", such as the associated ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term(s)"),", its ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),", etc., to make it easy for IT-tools to create, e.g. documentation, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),", ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/dictionary",title:"Dictionary: an alphabetically sorted list of Terms with various meanings that they may have in different contexts."},"dictionaries"),", whitepapers, etc. that uses such ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", etc.)."),(0,s.kt)("p",null,"A ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," can be seen as the collection of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that hold all data related to the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scoped-term",title:"Scoped Term: a Term that represents (and identifies) a specific Semantic Unit of a particular Community (or Party)."},"terms")," that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," consists of."),(0,s.kt)("p",null,"The contents of an ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," may vary, depending on the type of ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that it documents. The kinds of data that are common for all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," are documented ",(0,s.kt)("a",{parentName:"p",href:"http://localhost:3000/docs/specs/files/mrg#entries"},"here"),"."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this concept fits in with related concepts."),(0,s.kt)("p",null,"The ",(0,s.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"terminology construction manual")," describes how ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," are selected (and manipulated) for the construction of a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,s.kt)("h3",{id:"purpose"},"Purpose"),(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," provide all (meta) data about a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that IT-tools might need for their own purposes.",(0,s.kt)("p",null,"As an example, consider a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," that would like to have an overview of all ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that it uses in a human readable way, and decides it needs a (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"human readable"),") ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),". Thus, they need a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," that knows how to find all these ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and (after sorting them) render them into some human readable form. This ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," would look for the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for that ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", which contains the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," that contain all data that the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"tool")," needs."),(0,s.kt)("p",null,"As the number of tools that need (meta) data about ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," grows, ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entries")," will be expected to cater for such needs."))}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/75cbb1e6.6d97aa12.js b/assets/js/75cbb1e6.fc69d21d.js similarity index 99% rename from assets/js/75cbb1e6.6d97aa12.js rename to assets/js/75cbb1e6.fc69d21d.js index 99fa1a623..a589e6dca 100644 --- a/assets/js/75cbb1e6.6d97aa12.js +++ b/assets/js/75cbb1e6.fc69d21d.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4658],{3905:(e,t,n)=>{n.d(t,{Zo:()=>l,kt:()=>f});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=r.createContext({}),u=function(e){var t=r.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},l=function(e){var t=u(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=u(n),f=a,h=m["".concat(c,".").concat(f)]||m[f]||d[f]||i;return n?r.createElement(h,o(o({ref:t},l),{},{components:n})):r.createElement(h,o({ref:t},l))}));function f(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var u=2;u{n.r(t),n.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>d,frontMatter:()=>i,metadata:()=>s,toc:()=>u});var r=n(3117),a=(n(7294),n(3905));const i={id:"curate",displayed_sidebar:"tev2SideBar",term:"curate",termType:"concept",isa:null,glossaryTerm:"Curate",glossaryText:"to select, organize, and present [terms](@), [definitions](@), and other, related content in a thoughtful and purposeful manner to establish shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology","cm-party-actor-action"],formPhrases:["curates","curated","curating","curation"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Curate",s={unversionedId:"terms/curate",id:"terms/curate",title:"Curate",description:"Curate: to select, organize, and present terms, definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a community working together on a particular set of objectives. The act of curation involves careful consideration of the relevance, clarity, and context of the concepts and their definitions, ensuring that they are unambiguous and effectively support communication and collaboration within the community.",source:"@site/docs/terms/curate.md",sourceDirName:"terms",slug:"/terms/curate",permalink:"/tev2-specifications/docs/terms/curate",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curate.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curate",displayed_sidebar:"tev2SideBar",term:"curate",termType:"concept",isa:null,glossaryTerm:"Curate",glossaryText:"to select, organize, and present [terms](@), [definitions](@), and other, related content in a thoughtful and purposeful manner to establish shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology","cm-party-actor-action"],formPhrases:["curates","curated","curating","curation"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},u=[{value:"Notes",id:"notes",level:3}],l={toc:u};function d(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},l,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curate"},"Curate"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"Curate"),": to select, organize, and present ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". The act of curation involves careful consideration of the relevance, clarity, and context of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ensuring that they are unambiguous and effectively support communication and collaboration within the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."),(0,a.kt)("h3",{id:"notes"},"Notes"),(0,a.kt)("p",null,"Curation plays a vital role in establishing and maintaining terminologies within a community's scope. Through careful curation, communities can ensure that their terminology remains consistent and facilitates effective communication among members. The process of curating a terminology involves defining concepts and their associated criteria, promoting shared understanding, and providing clear guidelines for using the terms consistently."),(0,a.kt)("p",null,"See also: ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4658],{3905:(e,t,n)=>{n.d(t,{Zo:()=>l,kt:()=>f});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=r.createContext({}),u=function(e){var t=r.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},l=function(e){var t=u(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),m=u(n),f=a,h=m["".concat(c,".").concat(f)]||m[f]||d[f]||i;return n?r.createElement(h,o(o({ref:t},l),{},{components:n})):r.createElement(h,o({ref:t},l))}));function f(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var u=2;u{n.r(t),n.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>d,frontMatter:()=>i,metadata:()=>s,toc:()=>u});var r=n(3117),a=(n(7294),n(3905));const i={id:"curate",displayed_sidebar:"tev2SideBar",term:"curate",termType:"concept",isa:null,glossaryTerm:"Curate",glossaryText:"to select, organize, and present [terms](@), [definitions](@), and other, related content in a thoughtful and purposeful manner to establish shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology","cm-party-actor-action"],formPhrases:["curates","curated","curating","curation"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Curate",s={unversionedId:"terms/curate",id:"terms/curate",title:"Curate",description:"Curate: to select, organize, and present terms, definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a community working together on a particular set of objectives. The act of curation involves careful consideration of the relevance, clarity, and context of the concepts and their definitions, ensuring that they are unambiguous and effectively support communication and collaboration within the community.",source:"@site/docs/terms/curate.md",sourceDirName:"terms",slug:"/terms/curate",permalink:"/tev2-specifications/docs/terms/curate",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curate.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curate",displayed_sidebar:"tev2SideBar",term:"curate",termType:"concept",isa:null,glossaryTerm:"Curate",glossaryText:"to select, organize, and present [terms](@), [definitions](@), and other, related content in a thoughtful and purposeful manner to establish shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology","cm-party-actor-action"],formPhrases:["curates","curated","curating","curation"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},u=[{value:"Notes",id:"notes",level:3}],l={toc:u};function d(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},l,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curate"},"Curate"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"Curate"),": to select, organize, and present ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms"),", ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", and other, related content in a thoughtful and purposeful manner to establish shared understanding among a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". The act of curation involves careful consideration of the relevance, clarity, and context of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions"),", ensuring that they are unambiguous and effectively support communication and collaboration within the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."),(0,a.kt)("h3",{id:"notes"},"Notes"),(0,a.kt)("p",null,"Curation plays a vital role in establishing and maintaining terminologies within a community's scope. Through careful curation, communities can ensure that their terminology remains consistent and facilitates effective communication among members. The process of curating a terminology involves defining concepts and their associated criteria, promoting shared understanding, and providing clear guidelines for using the terms consistently."),(0,a.kt)("p",null,"See also: ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/79495b8c.47e418f9.js b/assets/js/79495b8c.9dd0d9bb.js similarity index 99% rename from assets/js/79495b8c.47e418f9.js rename to assets/js/79495b8c.9dd0d9bb.js index 55cc516c5..59f9f8971 100644 --- a/assets/js/79495b8c.47e418f9.js +++ b/assets/js/79495b8c.9dd0d9bb.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6122],{3905:(e,t,o)=>{o.d(t,{Zo:()=>l,kt:()=>f});var i=o(7294);function a(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,i)}return o}function r(e){for(var t=1;t=0||(a[o]=e[o]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(a[o]=e[o])}return a}var c=i.createContext({}),m=function(e){var t=i.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},l=function(e){var t=m(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var o=e.components,a=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=m(o),f=a,u=d["".concat(c,".").concat(f)]||d[f]||h[f]||n;return o?i.createElement(u,r(r({ref:t},l),{},{components:o})):i.createElement(u,r({ref:t},l))}));function f(e,t){var o=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=o.length,r=new Array(n);r[0]=d;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var m=2;m{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>n,metadata:()=>s,toc:()=>m});var i=o(3117),a=(o(7294),o(3905));const n={id:"curator",displayed_sidebar:"tev2SideBar",term:"curator",termType:"concept",isa:null,glossaryTerm:"Curator (of a Scope)",glossaryText:"a person responsible for curating, managing, and maintaining the [terminologies](@), to ensure shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology"],formPhrases:["curator{ss}","terminology-curator{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Curator (of a Scope)",s={unversionedId:"terms/curator",id:"terms/curator",title:"Curator (of a Scope)",description:"A Curator is a person responsible for curating, managing, and maintaining terminologies, to ensure shared understanding among a community working together on a particular set of objectives. They carefully select, organize, and present the terminology, ensuring that the definitions are clear, precise, and reflect the community's agreed-upon understanding of the concepts (and other semantic units) they use.",source:"@site/docs/terms/curator.md",sourceDirName:"terms",slug:"/terms/curator",permalink:"/tev2-specifications/docs/terms/curator",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curator.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curator",displayed_sidebar:"tev2SideBar",term:"curator",termType:"concept",isa:null,glossaryTerm:"Curator (of a Scope)",glossaryText:"a person responsible for curating, managing, and maintaining the [terminologies](@), to ensure shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology"],formPhrases:["curator{ss}","terminology-curator{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],l={toc:m};function h(e){let{components:t,...o}=e;return(0,a.kt)("wrapper",(0,i.Z)({},l,o,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curator-of-a-scope"},"Curator (of a Scope)"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"Curator")," is a person responsible for curating, managing, and maintaining ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". They carefully select, organize, and present the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", ensuring that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," are clear, precise, and reflect the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," agreed-upon understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") they use."),(0,a.kt)("h3",{id:"examples"},"Examples"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"The curator of a software development team ensures that for a particular software product (the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of the team), all technical and non-technical ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," are consistently used, promoting coherence and reducing ambiguity during collaboration. Different products (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," may have different (internally coherent) ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),". If the software development team works on different products, they may need different ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),", and possibly ensure that these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," get harmonized. Here, too, the curator plays a crucial role."),(0,a.kt)("li",{parentName:"ul"},"The curator of a project team ensures that all technical and non-technical ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that are relevant within the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of that project are coherent, and consistently used within (written) project deliverables. This not only promotes coherence and reduces ambiguity during collaboration, but it also makes it easier for readers to understand the content of the project deliverables. It also facilities inter-project communications and knowledge exchange.")),(0,a.kt)("h3",{id:"notes"},"Notes"),(0,a.kt)("p",null,"Curators play a vital role in the success of a terminology management initiative. By curating the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," with precision and ensuring shared understanding among community members, they contribute to effective communication, collaboration, and knowledge sharing within the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."))}h.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[6122],{3905:(e,t,o)=>{o.d(t,{Zo:()=>l,kt:()=>f});var i=o(7294);function a(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(e,t){var o=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),o.push.apply(o,i)}return o}function r(e){for(var t=1;t=0||(a[o]=e[o]);return a}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,o)&&(a[o]=e[o])}return a}var c=i.createContext({}),m=function(e){var t=i.useContext(c),o=t;return e&&(o="function"==typeof e?e(t):r(r({},t),e)),o},l=function(e){var t=m(e.components);return i.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},d=i.forwardRef((function(e,t){var o=e.components,a=e.mdxType,n=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=m(o),f=a,u=d["".concat(c,".").concat(f)]||d[f]||h[f]||n;return o?i.createElement(u,r(r({ref:t},l),{},{components:o})):i.createElement(u,r({ref:t},l))}));function f(e,t){var o=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var n=o.length,r=new Array(n);r[0]=d;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var m=2;m{o.r(t),o.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>n,metadata:()=>s,toc:()=>m});var i=o(3117),a=(o(7294),o(3905));const n={id:"curator",displayed_sidebar:"tev2SideBar",term:"curator",termType:"concept",isa:null,glossaryTerm:"Curator (of a Scope)",glossaryText:"a person responsible for curating, managing, and maintaining the [terminologies](@), to ensure shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology"],formPhrases:["curator{ss}","terminology-curator{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Curator (of a Scope)",s={unversionedId:"terms/curator",id:"terms/curator",title:"Curator (of a Scope)",description:"A Curator is a person responsible for curating, managing, and maintaining terminologies, to ensure shared understanding among a community working together on a particular set of objectives. They carefully select, organize, and present the terminology, ensuring that the definitions are clear, precise, and reflect the community's agreed-upon understanding of the concepts (and other semantic units) they use.",source:"@site/docs/terms/curator.md",sourceDirName:"terms",slug:"/terms/curator",permalink:"/tev2-specifications/docs/terms/curator",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/curator.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"curator",displayed_sidebar:"tev2SideBar",term:"curator",termType:"concept",isa:null,glossaryTerm:"Curator (of a Scope)",glossaryText:"a person responsible for curating, managing, and maintaining the [terminologies](@), to ensure shared understanding among a [community](@) working together on a particular set of [objectives](@essif-lab).",grouptags:["terminology"],formPhrases:["curator{ss}","terminology-curator{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Examples",id:"examples",level:3},{value:"Notes",id:"notes",level:3}],l={toc:m};function h(e){let{components:t,...o}=e;return(0,a.kt)("wrapper",(0,i.Z)({},l,o,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"curator-of-a-scope"},"Curator (of a Scope)"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"Curator")," is a person responsible for curating, managing, and maintaining ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),", to ensure shared understanding among a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community")," working together on a particular set of ",(0,a.kt)("a",{href:"/framework/docs/terms/objective",title:"Objective: Something toward which a Party (its Owner) directs effort (an aim, goal, or end of action)."},"objectives"),". They carefully select, organize, and present the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", ensuring that the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," are clear, precise, and reflect the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community's")," agreed-upon understanding of the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," (and other ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),") they use."),(0,a.kt)("h3",{id:"examples"},"Examples"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"The curator of a software development team ensures that for a particular software product (the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of the team), all technical and non-technical ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," are consistently used, promoting coherence and reducing ambiguity during collaboration. Different products (",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," may have different (internally coherent) ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies"),". If the software development team works on different products, they may need different ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," to be ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated"),", and possibly ensure that these ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," get harmonized. Here, too, the curator plays a crucial role."),(0,a.kt)("li",{parentName:"ul"},"The curator of a project team ensures that all technical and non-technical ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," and their ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," that are relevant within the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," of that project are coherent, and consistently used within (written) project deliverables. This not only promotes coherence and reduces ambiguity during collaboration, but it also makes it easier for readers to understand the content of the project deliverables. It also facilities inter-project communications and knowledge exchange.")),(0,a.kt)("h3",{id:"notes"},"Notes"),(0,a.kt)("p",null,"Curators play a vital role in the success of a terminology management initiative. By curating the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," with precision and ensuring shared understanding among community members, they contribute to effective communication, collaboration, and knowledge sharing within the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"community"),"."))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/7a6142bc.90c5eeac.js b/assets/js/7a6142bc.9b7a7d5d.js similarity index 99% rename from assets/js/7a6142bc.90c5eeac.js rename to assets/js/7a6142bc.9b7a7d5d.js index 97cbb6600..8d57c5690 100644 --- a/assets/js/7a6142bc.90c5eeac.js +++ b/assets/js/7a6142bc.9b7a7d5d.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4055],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>f});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=r.createContext({}),c=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},d=function(e){var t=c(e.components);return r.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},h=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,s=e.originalType,l=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),h=c(a),f=n,m=h["".concat(l,".").concat(f)]||h[f]||p[f]||s;return a?r.createElement(m,i(i({ref:t},d),{},{components:a})):r.createElement(m,i({ref:t},d))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=a.length,i=new Array(s);i[0]=h;var o={};for(var l in t)hasOwnProperty.call(t,l)&&(o[l]=t[l]);o.originalType=e,o.mdxType="string"==typeof e?e:n,i[1]=o;for(var c=2;c{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>p,frontMatter:()=>s,metadata:()=>o,toc:()=>c});var r=a(3117),n=(a(7294),a(3905));const s={id:"handlebars-template",displayed_sidebar:"tev2SideBar",term:"handlebars-template",termType:"concept",isa:null,glossaryTerm:"Handlebars Template",glossaryText:"a blueprint/template that uses the [Handlebars language](https://handlebarsjs.com/guide/#what-is-handlebars) to define where and how variable information can be inserted into a predetermined text structure.",glossaryNotes:["TEv2 [converters](@) are Handlebars templates.","Handlebars templates ([converters](@)) allow for the creation of customizable texts that automatically update with specific data.","Handlebars templates ([converters](@)) are characterized by their use of Handlebars expressions within the templates."],grouptags:[],formPhrases:["handlebar{ss} template{ss}","handlebar{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Handlebars Templates",o={unversionedId:"terms/handlebars-template",id:"terms/handlebars-template",title:"Handlebars Templates",description:"A handlebars template is a blueprint that uses the Handlebars language to define where and how variable information can be inserted into a predetermined text structure. This allows for the creation of customizable texts that automatically update with specific data. Handlebars templates are characterized by their use of Handlebars expressions within the templates.",source:"@site/docs/terms/handlebars-template.md",sourceDirName:"terms",slug:"/terms/handlebars-template",permalink:"/tev2-specifications/docs/terms/handlebars-template",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/handlebars-template.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"handlebars-template",displayed_sidebar:"tev2SideBar",term:"handlebars-template",termType:"concept",isa:null,glossaryTerm:"Handlebars Template",glossaryText:"a blueprint/template that uses the [Handlebars language](https://handlebarsjs.com/guide/#what-is-handlebars) to define where and how variable information can be inserted into a predetermined text structure.",glossaryNotes:["TEv2 [converters](@) are Handlebars templates.","Handlebars templates ([converters](@)) allow for the creation of customizable texts that automatically update with specific data.","Handlebars templates ([converters](@)) are characterized by their use of Handlebars expressions within the templates."],grouptags:[],formPhrases:["handlebar{ss} template{ss}","handlebar{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},c=[{value:"Purpose",id:"purpose",level:2},{value:"Examples",id:"examples",level:2},{value:"Handlebars template for generating a Markdown link for a TermRef",id:"handlebars-template-for-generating-a-markdown-link-for-a-termref",level:3},{value:"Handlebars template for generating a HRG entry",id:"handlebars-template-for-generating-a-hrg-entry",level:3}],d={toc:c};function p(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"handlebars-templates"},"Handlebars Templates"),(0,n.kt)("p",null,"A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," is a blueprint that uses the ",(0,n.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure. This allows for the creation of customizable texts that automatically update with specific data. Handlebars templates are characterized by their use of Handlebars expressions within the templates."),(0,n.kt)("p",null,(0,n.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars")," is a simple templating language. It uses a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," and an input object to generate output texts, in any format you like. ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars templates")," look like regular text with embedded handlebars expressions, which consist of a ",(0,n.kt)("inlineCode",{parentName:"p"},"{{"),", followed by some contents, and a closing ",(0,n.kt)("inlineCode",{parentName:"p"},"}}"),". When a template is executed, these expressions are replaced with values from an input object."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"The purpose of Handlebars templates is to separate the logic of data manipulation from the presentation layer, facilitating maintainability and readability. This approach enables developers to create templates that can be reused with different data, leading to more efficient code and a clearer separation of concerns within web applications."),(0,n.kt)("p",null,"Within the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are typically specified as (predefined, or custom) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates"),". The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the class of objects that a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," works on."),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," is specified in the documentation for that tool. See, e.g., the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/tools/trrt#converter-profile"},"TRRT converter profile"),", or the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/tools/hrgt#converter-profile"},"HRGT converter profile"),"."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("p",null,"Here are some (simple) examples for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that are used within the context of ","[TEv2]"),(0,n.kt)("h3",{id:"handlebars-template-for-generating-a-markdown-link-for-a-termref"},"Handlebars template for generating a Markdown link for a TermRef"),(0,n.kt)("p",null,"Resolving ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," (which is what the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," does) requires the creation of a text that, in the case of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," static website, can be rendered by Docusaurus. So the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," might generate, e.g., HTML, or markdown. Here is an example of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that is used to convert a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," into a markdown-link:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-handlebars"},"[{{showtext}}]({{navurl}}{{#if trait}}#{{trait}}{{/if}})\n")),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," handlebars object specifies the variables ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"navurl"),", and ",(0,n.kt)("inlineCode",{parentName:"p"},"trait")," (and quite a few more). This template will thus prorivide a markdown link to the location pointed to by ",(0,n.kt)("inlineCode",{parentName:"p"},"navurl"),", "),(0,n.kt)("h3",{id:"handlebars-template-for-generating-a-hrg-entry"},"Handlebars template for generating a HRG entry"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human readable glossaries")," are created by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),", which uses ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to generate entries for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". The data object on which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," works includes the data that is availble in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," is to be generated.",(0,n.kt)("p",null,"Here is a simple ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," that generates a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," that is a level-2 markdown section of which the title is taken from the ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryTerm")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and that contains a paragraph that contains the text that is available in the ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText")," field of that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry"),":"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-handlebars"},"## [{{glossaryTerm}}]({{localize navurl}})\\n\\n{{glossaryText}}\\n\\n\n")),(0,n.kt)("p",null,"where ",(0,n.kt)("inlineCode",{parentName:"p"},"\\n")," is a newline (line break)."),(0,n.kt)("p",null,"Notes:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"users can click on the text generated by ",(0,n.kt)("inlineCode",{parentName:"li"},"{{glossaryTerm}}"),", as it is also a link to the page that documents the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," was generated."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"{{localize navurl}}")," is a handlebars expression that uses the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions#localize",title:"Handlebars Helper Function: a function that can be used in a Handlebars Expression to manipulate or format the data before displaying it within a template."},"helper function")," ",(0,n.kt)("inlineCode",{parentName:"li"},"localize"),".")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4055],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>f});var r=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function s(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,r)}return a}function i(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=r.createContext({}),c=function(e){var t=r.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},d=function(e){var t=c(e.components);return r.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},h=r.forwardRef((function(e,t){var a=e.components,n=e.mdxType,s=e.originalType,l=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),h=c(a),f=n,m=h["".concat(l,".").concat(f)]||h[f]||p[f]||s;return a?r.createElement(m,i(i({ref:t},d),{},{components:a})):r.createElement(m,i({ref:t},d))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var s=a.length,i=new Array(s);i[0]=h;var o={};for(var l in t)hasOwnProperty.call(t,l)&&(o[l]=t[l]);o.originalType=e,o.mdxType="string"==typeof e?e:n,i[1]=o;for(var c=2;c{a.r(t),a.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>p,frontMatter:()=>s,metadata:()=>o,toc:()=>c});var r=a(3117),n=(a(7294),a(3905));const s={id:"handlebars-template",displayed_sidebar:"tev2SideBar",term:"handlebars-template",termType:"concept",isa:null,glossaryTerm:"Handlebars Template",glossaryText:"a blueprint/template that uses the [Handlebars language](https://handlebarsjs.com/guide/#what-is-handlebars) to define where and how variable information can be inserted into a predetermined text structure.",glossaryNotes:["TEv2 [converters](@) are Handlebars templates.","Handlebars templates ([converters](@)) allow for the creation of customizable texts that automatically update with specific data.","Handlebars templates ([converters](@)) are characterized by their use of Handlebars expressions within the templates."],grouptags:[],formPhrases:["handlebar{ss} template{ss}","handlebar{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},i="Handlebars Templates",o={unversionedId:"terms/handlebars-template",id:"terms/handlebars-template",title:"Handlebars Templates",description:"A handlebars template is a blueprint that uses the Handlebars language to define where and how variable information can be inserted into a predetermined text structure. This allows for the creation of customizable texts that automatically update with specific data. Handlebars templates are characterized by their use of Handlebars expressions within the templates.",source:"@site/docs/terms/handlebars-template.md",sourceDirName:"terms",slug:"/terms/handlebars-template",permalink:"/tev2-specifications/docs/terms/handlebars-template",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/handlebars-template.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"handlebars-template",displayed_sidebar:"tev2SideBar",term:"handlebars-template",termType:"concept",isa:null,glossaryTerm:"Handlebars Template",glossaryText:"a blueprint/template that uses the [Handlebars language](https://handlebarsjs.com/guide/#what-is-handlebars) to define where and how variable information can be inserted into a predetermined text structure.",glossaryNotes:["TEv2 [converters](@) are Handlebars templates.","Handlebars templates ([converters](@)) allow for the creation of customizable texts that automatically update with specific data.","Handlebars templates ([converters](@)) are characterized by their use of Handlebars expressions within the templates."],grouptags:[],formPhrases:["handlebar{ss} template{ss}","handlebar{ss}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},l={},c=[{value:"Purpose",id:"purpose",level:2},{value:"Examples",id:"examples",level:2},{value:"Handlebars template for generating a Markdown link for a TermRef",id:"handlebars-template-for-generating-a-markdown-link-for-a-termref",level:3},{value:"Handlebars template for generating a HRG entry",id:"handlebars-template-for-generating-a-hrg-entry",level:3}],d={toc:c};function p(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,r.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"handlebars-templates"},"Handlebars Templates"),(0,n.kt)("p",null,"A ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," is a blueprint that uses the ",(0,n.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars language")," to define where and how variable information can be inserted into a predetermined text structure. This allows for the creation of customizable texts that automatically update with specific data. Handlebars templates are characterized by their use of Handlebars expressions within the templates."),(0,n.kt)("p",null,(0,n.kt)("a",{parentName:"p",href:"https://handlebarsjs.com/guide/#what-is-handlebars"},"Handlebars")," is a simple templating language. It uses a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," and an input object to generate output texts, in any format you like. ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"Handlebars templates")," look like regular text with embedded handlebars expressions, which consist of a ",(0,n.kt)("inlineCode",{parentName:"p"},"{{"),", followed by some contents, and a closing ",(0,n.kt)("inlineCode",{parentName:"p"},"}}"),". When a template is executed, these expressions are replaced with values from an input object."),(0,n.kt)("h2",{id:"purpose"},"Purpose"),(0,n.kt)("p",null,"The purpose of Handlebars templates is to separate the logic of data manipulation from the presentation layer, facilitating maintainability and readability. This approach enables developers to create templates that can be reused with different data, leading to more efficient code and a clearer separation of concerns within web applications."),(0,n.kt)("p",null,"Within the context of ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2"),", ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," are typically specified as (predefined, or custom) ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates"),". The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," specifies the class of objects that a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," works on."),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter-profile",title:"Converter Profile: the specification of a class of Data Objects, instances of which are used by specific Text Conversion Tools to generate text fragments from."},"converter profile")," for a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," is specified in the documentation for that tool. See, e.g., the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/tools/trrt#converter-profile"},"TRRT converter profile"),", or the ",(0,n.kt)("a",{parentName:"p",href:"/docs/specs/tools/hrgt#converter-profile"},"HRGT converter profile"),"."),(0,n.kt)("h2",{id:"examples"},"Examples"),(0,n.kt)("p",null,"Here are some (simple) examples for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars templates")," that are used within the context of ","[TEv2]"),(0,n.kt)("h3",{id:"handlebars-template-for-generating-a-markdown-link-for-a-termref"},"Handlebars template for generating a Markdown link for a TermRef"),(0,n.kt)("p",null,"Resolving ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," (which is what the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," does) requires the creation of a text that, in the case of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/tev2",title:"TEv2: a set of specifications and Tools that caters for the Curation of Terminologies, as well as for its subsequent use in publications of different types (e.g. websites, whitepapers) and formats (e.g. html, LaTeX), as appropriate for different, individual Scopes."},"TEv2")," static website, can be rendered by Docusaurus. So the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," might generate, e.g., HTML, or markdown. Here is an example of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," that is used to convert a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," into a markdown-link:"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-handlebars"},"[{{showtext}}]({{navurl}}{{#if trait}}#{{trait}}{{/if}})\n")),(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," handlebars object specifies the variables ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext"),", ",(0,n.kt)("inlineCode",{parentName:"p"},"navurl"),", and ",(0,n.kt)("inlineCode",{parentName:"p"},"trait")," (and quite a few more). This template will thus prorivide a markdown link to the location pointed to by ",(0,n.kt)("inlineCode",{parentName:"p"},"navurl"),", "),(0,n.kt)("h3",{id:"handlebars-template-for-generating-a-hrg-entry"},"Handlebars template for generating a HRG entry"),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"Human readable glossaries")," are created by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"HRGT"),", which uses ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converters")," to generate entries for that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),". The data object on which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/converter",title:"Converter: a specification, in the form of a Handlebars Template, for constructing a text that a particular Text Conversion Tool uses to create its output."},"converter")," works includes the data that is availble in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," is to be generated.",(0,n.kt)("p",null,"Here is a simple ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/handlebars-template",title:"Handlebars Template: a blueprint/template that uses the Handlebars Language to define where and how variable information can be inserted into a predetermined text structure."},"handlebars template")," that generates a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," that is a level-2 markdown section of which the title is taken from the ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryTerm")," field in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry"),", and that contains a paragraph that contains the text that is available in the ",(0,n.kt)("inlineCode",{parentName:"p"},"glossaryText")," field of that ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"entry"),":"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-handlebars"},"## [{{glossaryTerm}}]({{localize navurl}})\\n\\n{{glossaryText}}\\n\\n\n")),(0,n.kt)("p",null,"where ",(0,n.kt)("inlineCode",{parentName:"p"},"\\n")," is a newline (line break)."),(0,n.kt)("p",null,"Notes:"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"users can click on the text generated by ",(0,n.kt)("inlineCode",{parentName:"li"},"{{glossaryTerm}}"),", as it is also a link to the page that documents the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for which the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg-entry",title:"HRG Entry: A specific kind of (human-readable) rendering of the combination of a Term and a means that helps Readers to understand the meaning of that Term when it is used in a sentence."},"HRG entry")," was generated."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"{{localize navurl}}")," is a handlebars expression that uses the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/handlebars-helper-functions#localize",title:"Handlebars Helper Function: a function that can be used in a Handlebars Expression to manipulate or format the data before displaying it within a template."},"helper function")," ",(0,n.kt)("inlineCode",{parentName:"li"},"localize"),".")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/7e8f2ce0.b83a2592.js b/assets/js/7e8f2ce0.10c1ae2f.js similarity index 99% rename from assets/js/7e8f2ce0.b83a2592.js rename to assets/js/7e8f2ce0.10c1ae2f.js index 44b1d5751..a60930017 100644 --- a/assets/js/7e8f2ce0.b83a2592.js +++ b/assets/js/7e8f2ce0.10c1ae2f.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7257],{3905:(e,t,i)=>{i.d(t,{Zo:()=>d,kt:()=>m});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function s(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},d=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},p=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=r(e,["components","mdxType","originalType","parentName"]),p=l(i),m=o,f=p["".concat(c,".").concat(m)]||p[m]||h[m]||n;return i?a.createElement(f,s(s({ref:t},d),{},{components:i})):a.createElement(f,s({ref:t},d))}));function m(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=i.length,s=new Array(n);s[0]=p;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,s[1]=r;for(var l=2;l{i.d(t,{Z:()=>c});var a=i(7294),o=i(6775);const n="apiTable_e8hp";function s(e,t){let{name:i,children:n}=e;const s=function(e){let t=e;for(;(0,a.isValidElement)(t);)[t]=a.Children.toArray(t.props.children);return t}(n),r=i?`${i}-${s}`:s,c=`#${r}`,l=(0,o.k6)();return a.createElement("tr",{id:r,tabIndex:0,ref:l.location.hash===c?t:void 0,onClick:e=>{"A"===e.target.tagName.toUpperCase()||l.push(c)},onKeyDown:e=>{"Enter"===e.key&&l.push(c)}},n.props.children)}const r=a.forwardRef(s);function c(e){let{children:t,name:i}=e;const[o,s]=a.Children.toArray(t.props.children),c=(0,a.useRef)(null);(0,a.useEffect)((()=>{c.current?.focus()}),[c]);const l=a.Children.map(s.props.children,(e=>a.createElement(r,{name:i,ref:c},e)));return a.createElement("table",{className:n},o,a.createElement("tbody",null,l))}},6270:(e,t,i)=>{i.r(t),i.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>p,frontMatter:()=>s,metadata:()=>c,toc:()=>d});var a=i(3117),o=(i(7294),i(3905)),n=(i(4996),i(869));const s={id:"saf",sidebar_label:"SAF (Scope Admin File)",date:20230103},r="Scope Administration File (SAF)",c={unversionedId:"specs/files/saf",id:"specs/files/saf",title:"Scope Administration File (SAF)",description:"A Scope Administration File (SAF) is a YAML file, named saf.yaml, that provides a centralized record of the resources available in that scope, facilitating their access by various tools involved in terminology management. It specifies where its curated texts, glossaries etc. live, the relationships it has with other scopes, and the specifications of the different terminologies that are curated within that scope. The SAF of a scope is located in its scopedir.",source:"@site/docs/specs/files/12-saf.md",sourceDirName:"specs/files",slug:"/specs/files/saf",permalink:"/tev2-specifications/docs/specs/files/saf",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/12-saf.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:12,frontMatter:{id:"saf",sidebar_label:"SAF (Scope Admin File)",date:20230103},sidebar:"tev2SideBar",previous:{title:"Body Files",permalink:"/tev2-specifications/docs/specs/files/body-file"},next:{title:"MRG (Machine Readable Glossary)",permalink:"/tev2-specifications/docs/specs/files/mrg"}},l={},d=[{value:"Scope Administration File Field Descriptions",id:"scope-administration-file-field-descriptions",level:2},{value:"SAF Terminology - Defining the Scope itself",id:"scope-section",level:3},{value:"SAF Scopes - Mapping Scopetags and Scopedirs",id:"scopes",level:3},{value:"SAF Versions - Enabling changes and updates in a scope's Terminology",id:"versions",level:3}],h={toc:d};function p(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"scope-administration-file-saf"},"Scope Administration File (SAF)"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scope Administration File (SAF)")," is a ",(0,o.kt)("a",{parentName:"p",href:"https://yaml.org/"},"YAML")," file, named ",(0,o.kt)("inlineCode",{parentName:"p"},"saf.yaml"),", that provides a centralized record of the resources available in that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", facilitating their access by various tools involved in terminology management. It specifies where its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live, the relationships it has with other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,o.kt)("p",null,"The directory within which the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," lives, is the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that it serves."),(0,o.kt)("h2",{id:"scope-administration-file-field-descriptions"},"Scope Administration File Field Descriptions"),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," has three main parts, which we refer to as 'sections':"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"scope"))," (singular) section defines meta-data concerning the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," itself, both for technical use and human use. It shows where directories and files live that ar part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and also ways in which people can contribute, raise issues, see what's going on, discuss, etc."),(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"scopes"))," (plural) section contains a mapping between ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," that are used within the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and the associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedirs"),". This enables tools to find the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of these ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and from there all other directories, files etc. that live within them, e.g. to use/import their data."),(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"versions"))," section specifies all versions of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that are actively maintained by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and for each of them, the set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that constitute this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,o.kt)("p",null,"The following sections specify the fields for each of these parts."),(0,o.kt)("h3",{id:"scope-section"},"SAF Terminology - Defining the Scope itself"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `scope` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},"#\n# This is an example of the `scope` section of a Scope Administration File\n#\nscope:\n scopetag: tev2 # identifier that curators have determined for this terminology\n scopedir: https://github.com/tno-terminology-design/tev2-specifications/tree/master/docs # URL of the scope-directory\n curatedir: terms # directory where all curated files are located. Full URL is `scopedir`/`curatedir`\n glossarydir: glossaries # directory where all glossary files and related stuff are located. Full URL is `scopedir`/`glossarydir`\n defaultvsn: latest # vsntag that identifies the default terminology. MRG is located at `scopedir`/`glossarydir`/mrg.`scopetag`.`defaultvsn`.yaml\n website: https://tno-terminology-design.github.io/tev2-specifications/docs-overview # base URL for creating links to rendered versions of Curated Texts\n license: LICENSE.md # file that contains the (default) licensing conditions. Full URL is `scopedir`/`license`\n"))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"scope")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)(n.Z,{mdxType:"APITable"},(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:"left"},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"scopetag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"Scopetag")," that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of this scope have determined for this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". The associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," is specified in the section ",(0,o.kt)("inlineCode",{parentName:"td"},"scopes"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"scopedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"URL of the location of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," associated with the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," listed in the ",(0,o.kt)("inlineCode",{parentName:"td"},"scopetags")," field.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where all ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files")," are located. This directory may contain subdirectories to allow ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to organize the files in any way they see fit. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},""),"/",(0,o.kt)("inlineCode",{parentName:"td"},""),". ",(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")," may also be an empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"glossarydir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where all ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),"-related files are located. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},""),"/",(0,o.kt)("inlineCode",{parentName:"td"},""),". This directory SHOULD contain one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for every element in the version-section in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". It MAY contain other files, e.g. ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," or ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," templates, files that contain instructions, headers, footers or other things that are necessary for generating specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"defaultvsn")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that identifies the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," is located at ",(0,o.kt)("inlineCode",{parentName:"td"},"scopedir"),"/",(0,o.kt)("inlineCode",{parentName:"td"},"glossarydir"),"/mrg.",(0,o.kt)("inlineCode",{parentName:"td"},"scopetag"),".",(0,o.kt)("inlineCode",{parentName:"td"},"defaultvsn"),".yaml")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"defaulttype")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Text that is used to identify the default kind of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". It is the default value for the ",(0,o.kt)("inlineCode",{parentName:"td"},"termType"),"-field in ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),". Default value for ",(0,o.kt)("inlineCode",{parentName:"td"},"defaulttype")," is ",(0,o.kt)("inlineCode",{parentName:"td"},"concept"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"website")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Base URL for creating links to rendered versions of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),". It should also serve as the home page of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". If not specified, it is assumed to be the empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"navpath")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts")," are rendered, relative to the value of ",(0,o.kt)("inlineCode",{parentName:"td"},"website"),". What ",(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")," is for ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),", is ",(0,o.kt)("inlineCode",{parentName:"td"},"navpath")," for the rendered versions of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),". If not specified, it is assumed to be the empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"navid")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Name of the field in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file"),' used by your static site generator in a URL, to uniquely identify that file (e.g., "id", "slug", "permalink"). If not specified, the filename of the ',(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," will be used.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"macros")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"Form phrase macro map")," that is to be used (overrides the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map#example",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"macro map"),")")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"license")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"File in the root of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," that contains the (default) licensing data.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},"..."),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," are free to add additional, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"-specific fields if they like to."))))),(0,o.kt)("h3",{id:"scopes"},"SAF Scopes - Mapping Scopetags and Scopedirs"),(0,o.kt)("p",null,"The ",(0,o.kt)("inlineCode",{parentName:"p"},"scopes")," section is a list that specifies a mapping between a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," as they are used in this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and its associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),". If you want to use multiple ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," to refer to one particular (other) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", each of them needs its own mapping."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `scopes` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},"#\n# The second section contains a mapping between scopetags that are used within the scope,\n# and the associated scopedirs. This enables tools to find the SAF of these scopes, and from\n# there all other directories, files etc. that live within them, e.g. to use/import their data.\n#\nscopes:\n- scopetag: essif-lab # define another scopetag for the same scopedir (just because you can)\n scopedir: https://github.com/essif-lab/framework/tree/master/docs # URL of the scope-directory\n- scopetag: ctwg # definition of (scope)tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/trustoverip/ctwg # URL of the scope-directory\n"))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"scopes")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"It may be simpler to change the ",(0,o.kt)("inlineCode",{parentName:"p"},"scopetags"),"-field, which is currently a list of scopetags, into a ",(0,o.kt)("inlineCode",{parentName:"p"},"scopetag"),"-field, which would specify a single scopetag. This would encourage curators to use no more than one scopetag for each scope they refer to, but if they really wanted to, they could make multiple entries with different scopetags that refer to the same scopedir.")),(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:null},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:null},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"scopetag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"A (single) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag"),", that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator(s)")," of this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has decided to use to refer to (the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of) a specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"scopedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"URL of the associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," (where the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located).")))),(0,o.kt)("h3",{id:"versions"},"SAF Versions - Enabling changes and updates in a scope's Terminology"),(0,o.kt)("p",null,"The third section (called ",(0,o.kt)("inlineCode",{parentName:"p"},"versions"),") in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," specifies the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are actively maintained by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Each such ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is identified (within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") by a (main) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," and optionally also alternative ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags"),". The contents of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is specified by so-called ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),". See the ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"Terminology Construction page")," and the ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection"},"term selection syntax page")," for details."),(0,o.kt)("p",null,"This ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section contains a list of fields that each specify one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," and some meta-data, e.g., regarding the state/validity of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," over time. This may be of interest to the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," as they need to decide whether or not to import ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from such a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,o.kt)("p",null,"There must be at least one such field in the ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section, namely a field that specifies the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the scope, i.e., the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is identified by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that is specified in the ",(0,o.kt)("inlineCode",{parentName:"p"},"defaultvsn")," field of ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},"the ",(0,o.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),"."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `versions` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},'#\n# The third section specifies the versions that are actively maintained by the curators.\n# For each version, the set of terms is selected that constitute the terminology.\n#\nversions:\n - vsntag: v0.9.4 # a versiontag that identifies this version from all other versions in the SAF\n altvsntags: # alternative verstiontags\n - latest\n - 0x921456\n termselection:\n - "[party,community](@essif-lab:0.9.4)" # import the terms `party` and `community` from the mrg of `essif-lab:0.9.4`.\n - "tags[management]@essif-lab" # import all terms from the mrg of `essif-lab:latest` that have grouptag `management`.\n - "*" # import all terms defined in the scope `tev2`\n status: proposed\n from: 20220312\n to:\n - vsntag: terms # a versiontag that identifies this version from all other versions in the SAF\n termselection:\n - "*" # import all terms that are curated in the current scope.\n'))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)(n.Z,{mdxType:"APITable"},(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:null},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:null},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"vsntag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"Versiontag")," that that is used to identify this version within the set of all other versions that are maintained within this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". in this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". It MUST NOT be changed during the lifetime of this version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"altvsntags")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"List of alternative ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," that may be used to refer to this version of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". A typical use of this field would be to tag a version as the 'latest' version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"termselection")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"List of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," that are used to generate (this version of) the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". See the ",(0,o.kt)("a",{parentName:"td",href:"/docs/manuals/curator/terminology-construction"},"Terminology Construction page")," and the ",(0,o.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-selection"},"term selection syntax page")," for details.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"license")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"File that contains the (default) licensing conditions. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},"scopedir"),"/",(0,o.kt)("inlineCode",{parentName:"td"},"license"),". If not specified, its value defaults to the value of the ",(0,o.kt)("inlineCode",{parentName:"td"},"license")," field in the ",(0,o.kt)("inlineCode",{parentName:"td"},"scope")," section (of this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),"). The purpose of this field is to allow different versions of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," to have different licenses.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"status")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"Text that identifies the status of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". (",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," may specify values for this field. If not specified, the status SHOULD be assumed to be 'concept', 'draft', 'proposed', or similar. An example is the ",(0,o.kt)("a",{parentName:"td",href:"https://github.com/trustoverip/concepts-and-terminology-wg/blob/master/docs/status-tags.md"},"status tags used by ToIP"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"from")),(0,o.kt)("td",{parentName:"tr",align:"center"},"F"),(0,o.kt)("td",{parentName:"tr",align:null},"Date at which it was decided to establish this version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"to")),(0,o.kt)("td",{parentName:"tr",align:"center"},"F"),(0,o.kt)("td",{parentName:"tr",align:null},"Date at which this version will expire (or has expired)."))))),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"The ",(0,o.kt)("inlineCode",{parentName:"p"},"from")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"to")," dates have been included to (in future) enable one to refer to a specific version of the terminology that was valid at a particular date. This feature needs to be worked out.")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7257],{3905:(e,t,i)=>{i.d(t,{Zo:()=>d,kt:()=>m});var a=i(7294);function o(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function n(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,a)}return i}function s(e){for(var t=1;t=0||(o[i]=e[i]);return o}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(o[i]=e[i])}return o}var c=a.createContext({}),l=function(e){var t=a.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},d=function(e){var t=l(e.components);return a.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},p=a.forwardRef((function(e,t){var i=e.components,o=e.mdxType,n=e.originalType,c=e.parentName,d=r(e,["components","mdxType","originalType","parentName"]),p=l(i),m=o,f=p["".concat(c,".").concat(m)]||p[m]||h[m]||n;return i?a.createElement(f,s(s({ref:t},d),{},{components:i})):a.createElement(f,s({ref:t},d))}));function m(e,t){var i=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var n=i.length,s=new Array(n);s[0]=p;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:o,s[1]=r;for(var l=2;l{i.d(t,{Z:()=>c});var a=i(7294),o=i(6775);const n="apiTable_e8hp";function s(e,t){let{name:i,children:n}=e;const s=function(e){let t=e;for(;(0,a.isValidElement)(t);)[t]=a.Children.toArray(t.props.children);return t}(n),r=i?`${i}-${s}`:s,c=`#${r}`,l=(0,o.k6)();return a.createElement("tr",{id:r,tabIndex:0,ref:l.location.hash===c?t:void 0,onClick:e=>{"A"===e.target.tagName.toUpperCase()||l.push(c)},onKeyDown:e=>{"Enter"===e.key&&l.push(c)}},n.props.children)}const r=a.forwardRef(s);function c(e){let{children:t,name:i}=e;const[o,s]=a.Children.toArray(t.props.children),c=(0,a.useRef)(null);(0,a.useEffect)((()=>{c.current?.focus()}),[c]);const l=a.Children.map(s.props.children,(e=>a.createElement(r,{name:i,ref:c},e)));return a.createElement("table",{className:n},o,a.createElement("tbody",null,l))}},6270:(e,t,i)=>{i.r(t),i.d(t,{assets:()=>l,contentTitle:()=>r,default:()=>p,frontMatter:()=>s,metadata:()=>c,toc:()=>d});var a=i(3117),o=(i(7294),i(3905)),n=(i(4996),i(869));const s={id:"saf",sidebar_label:"SAF (Scope Admin File)",date:20230103},r="Scope Administration File (SAF)",c={unversionedId:"specs/files/saf",id:"specs/files/saf",title:"Scope Administration File (SAF)",description:"A Scope Administration File (SAF) is a YAML file, named saf.yaml, that provides a centralized record of the resources available in that scope, facilitating their access by various tools involved in terminology management. It specifies where its curated texts, glossaries etc. live, the relationships it has with other scopes, and the specifications of the different terminologies that are curated within that scope. The SAF of a scope is located in its scopedir.",source:"@site/docs/specs/files/12-saf.md",sourceDirName:"specs/files",slug:"/specs/files/saf",permalink:"/tev2-specifications/docs/specs/files/saf",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/12-saf.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:12,frontMatter:{id:"saf",sidebar_label:"SAF (Scope Admin File)",date:20230103},sidebar:"tev2SideBar",previous:{title:"Body Files",permalink:"/tev2-specifications/docs/specs/files/body-file"},next:{title:"MRG (Machine Readable Glossary)",permalink:"/tev2-specifications/docs/specs/files/mrg"}},l={},d=[{value:"Scope Administration File Field Descriptions",id:"scope-administration-file-field-descriptions",level:2},{value:"SAF Terminology - Defining the Scope itself",id:"scope-section",level:3},{value:"SAF Scopes - Mapping Scopetags and Scopedirs",id:"scopes",level:3},{value:"SAF Versions - Enabling changes and updates in a scope's Terminology",id:"versions",level:3}],h={toc:d};function p(e){let{components:t,...i}=e;return(0,o.kt)("wrapper",(0,a.Z)({},h,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"scope-administration-file-saf"},"Scope Administration File (SAF)"),(0,o.kt)("p",null,"A ",(0,o.kt)("strong",{parentName:"p"},"Scope Administration File (SAF)")," is a ",(0,o.kt)("a",{parentName:"p",href:"https://yaml.org/"},"YAML")," file, named ",(0,o.kt)("inlineCode",{parentName:"p"},"saf.yaml"),", that provides a centralized record of the resources available in that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", facilitating their access by various tools involved in terminology management. It specifies where its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),", ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries")," etc. live, the relationships it has with other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and the specifications of the different ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curate",title:"Curate: to select, organize, and present Terms, Definitions, and other, related content in a thoughtful and purposeful manner to establish shared understanding among a Community working together on a particular set of Objectives."},"curated")," within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The SAF of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located in its ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),"."),(0,o.kt)("p",null,"The directory within which the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," lives, is the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that it serves."),(0,o.kt)("h2",{id:"scope-administration-file-field-descriptions"},"Scope Administration File Field Descriptions"),(0,o.kt)("p",null,"A ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," has three main parts, which we refer to as 'sections':"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"scope"))," (singular) section defines meta-data concerning the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," itself, both for technical use and human use. It shows where directories and files live that ar part of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and also ways in which people can contribute, raise issues, see what's going on, discuss, etc."),(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"scopes"))," (plural) section contains a mapping between ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," that are used within the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and the associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedirs"),". This enables tools to find the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of these ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes"),", and from there all other directories, files etc. that live within them, e.g. to use/import their data."),(0,o.kt)("li",{parentName:"ol"},"The ",(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"versions"))," section specifies all versions of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that are actively maintained by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and for each of them, the set of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that constitute this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),".")),(0,o.kt)("p",null,"The following sections specify the fields for each of these parts."),(0,o.kt)("h3",{id:"scope-section"},"SAF Terminology - Defining the Scope itself"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `scope` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},"#\n# This is an example of the `scope` section of a Scope Administration File\n#\nscope:\n scopetag: tev2 # identifier that curators have determined for this terminology\n scopedir: https://github.com/tno-terminology-design/tev2-specifications/tree/master/docs # URL of the scope-directory\n curatedir: terms # directory where all curated files are located. Full URL is `scopedir`/`curatedir`\n glossarydir: glossaries # directory where all glossary files and related stuff are located. Full URL is `scopedir`/`glossarydir`\n defaultvsn: latest # vsntag that identifies the default terminology. MRG is located at `scopedir`/`glossarydir`/mrg.`scopetag`.`defaultvsn`.yaml\n website: https://tno-terminology-design.github.io/tev2-specifications/docs-overview # base URL for creating links to rendered versions of Curated Texts\n license: LICENSE.md # file that contains the (default) licensing conditions. Full URL is `scopedir`/`license`\n"))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"scope")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)(n.Z,{mdxType:"APITable"},(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:"left"},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"scopetag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"Scopetag")," that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of this scope have determined for this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". The associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," is specified in the section ",(0,o.kt)("inlineCode",{parentName:"td"},"scopes"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"scopedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"URL of the location of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," associated with the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," listed in the ",(0,o.kt)("inlineCode",{parentName:"td"},"scopetags")," field.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where all ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-file",title:"Curated File: a file that is located in the Scopedir of a specific Scope, and is (therefore) Curated by (one of) the Curators of that Scope."},"curated files")," are located. This directory may contain subdirectories to allow ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," to organize the files in any way they see fit. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},""),"/",(0,o.kt)("inlineCode",{parentName:"td"},""),". ",(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")," may also be an empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"glossarydir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where all ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary"),"-related files are located. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},""),"/",(0,o.kt)("inlineCode",{parentName:"td"},""),". This directory SHOULD contain one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," for every element in the version-section in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". It MAY contain other files, e.g. ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRGs")," or ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," templates, files that contain instructions, headers, footers or other things that are necessary for generating specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossaries"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"defaultvsn")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that identifies the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," for this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". The associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," is located at ",(0,o.kt)("inlineCode",{parentName:"td"},"scopedir"),"/",(0,o.kt)("inlineCode",{parentName:"td"},"glossarydir"),"/mrg.",(0,o.kt)("inlineCode",{parentName:"td"},"scopetag"),".",(0,o.kt)("inlineCode",{parentName:"td"},"defaultvsn"),".yaml")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"defaulttype")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Text that is used to identify the default kind of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," for a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),". It is the default value for the ",(0,o.kt)("inlineCode",{parentName:"td"},"termType"),"-field in ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts"),". Default value for ",(0,o.kt)("inlineCode",{parentName:"td"},"defaulttype")," is ",(0,o.kt)("inlineCode",{parentName:"td"},"concept"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"website")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Base URL for creating links to rendered versions of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),". It should also serve as the home page of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". If not specified, it is assumed to be the empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"navpath")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Path to the directory where ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts")," are rendered, relative to the value of ",(0,o.kt)("inlineCode",{parentName:"td"},"website"),". What ",(0,o.kt)("inlineCode",{parentName:"td"},"curatedir")," is for ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),", is ",(0,o.kt)("inlineCode",{parentName:"td"},"navpath")," for the rendered versions of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"Curated Texts"),". If not specified, it is assumed to be the empty string.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"navid")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"Name of the field in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/front-matter",title:"Front Matter: a section at the top of a file that contains YAML (or similarly formatted) metadata, such as title, description, tags, and more."},"front matter")," of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file"),' used by your static site generator in a URL, to uniquely identify that file (e.g., "id", "slug", "permalink"). If not specified, the filename of the ',(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/body-file",title:"Body File: a file that is located somewhere within the Scopedir, and that contains the Body of a Curated Text."},"body file")," will be used.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"macros")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"Form phrase macro map")," that is to be used (overrides the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map#example",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"macro map"),")")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("inlineCode",{parentName:"td"},"license")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},"File in the root of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," that contains the (default) licensing data.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:"left"},"..."),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:"left"},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators")," are free to add additional, ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),"-specific fields if they like to."))))),(0,o.kt)("h3",{id:"scopes"},"SAF Scopes - Mapping Scopetags and Scopedirs"),(0,o.kt)("p",null,"The ",(0,o.kt)("inlineCode",{parentName:"p"},"scopes")," section is a list that specifies a mapping between a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," as they are used in this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and its associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir"),". If you want to use multiple ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," to refer to one particular (other) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", each of them needs its own mapping."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `scopes` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},"#\n# The second section contains a mapping between scopetags that are used within the scope,\n# and the associated scopedirs. This enables tools to find the SAF of these scopes, and from\n# there all other directories, files etc. that live within them, e.g. to use/import their data.\n#\nscopes:\n- scopetag: essif-lab # define another scopetag for the same scopedir (just because you can)\n scopedir: https://github.com/essif-lab/framework/tree/master/docs # URL of the scope-directory\n- scopetag: ctwg # definition of (scope)tag(s) that are used within this scope to refer to a specific terminology\n scopedir: https://github.com/trustoverip/ctwg # URL of the scope-directory\n"))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"scopes")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"It may be simpler to change the ",(0,o.kt)("inlineCode",{parentName:"p"},"scopetags"),"-field, which is currently a list of scopetags, into a ",(0,o.kt)("inlineCode",{parentName:"p"},"scopetag"),"-field, which would specify a single scopetag. This would encourage curators to use no more than one scopetag for each scope they refer to, but if they really wanted to, they could make multiple entries with different scopetags that refer to the same scopedir.")),(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:null},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:null},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"scopetag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"A (single) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag"),", that the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator(s)")," of this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," has decided to use to refer to (the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of) a specific ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"scopedir")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"URL of the associated ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scopedir",title:"Scopedir: a directory in a computer file system that contains all files that are either being Curated within a particular Scope, or generated to serve some purpose within that Scope."},"scopedir")," (where the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," of that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," is located).")))),(0,o.kt)("h3",{id:"versions"},"SAF Versions - Enabling changes and updates in a scope's Terminology"),(0,o.kt)("p",null,"The third section (called ",(0,o.kt)("inlineCode",{parentName:"p"},"versions"),") in the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF")," specifies the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminologies")," that are actively maintained by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". Each such ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is identified (within that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),") by a (main) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," and optionally also alternative ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags"),". The contents of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is specified by so-called ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions"),". See the ",(0,o.kt)("a",{parentName:"p",href:"/docs/manuals/curator/terminology-construction"},"Terminology Construction page")," and the ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/syntax/term-selection"},"term selection syntax page")," for details."),(0,o.kt)("p",null,"This ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section contains a list of fields that each specify one ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," and some meta-data, e.g., regarding the state/validity of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," over time. This may be of interest to the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of other ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," as they need to decide whether or not to import ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," from such a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,o.kt)("p",null,"There must be at least one such field in the ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section, namely a field that specifies the default ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the scope, i.e., the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," that is identified by the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontag")," that is specified in the ",(0,o.kt)("inlineCode",{parentName:"p"},"defaultvsn")," field of ",(0,o.kt)("a",{parentName:"p",href:"/docs/specs/files/saf#scope-section"},"the ",(0,o.kt)("inlineCode",{parentName:"a"},"scope")," section")," of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),"."),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Example of a `versions` section"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-yaml"},'#\n# The third section specifies the versions that are actively maintained by the curators.\n# For each version, the set of terms is selected that constitute the terminology.\n#\nversions:\n - vsntag: v0.9.4 # a versiontag that identifies this version from all other versions in the SAF\n altvsntags: # alternative verstiontags\n - latest\n - 0x921456\n termselection:\n - "[party,community](@essif-lab:0.9.4)" # import the terms `party` and `community` from the mrg of `essif-lab:0.9.4`.\n - "tags[management]@essif-lab" # import all terms from the mrg of `essif-lab:latest` that have grouptag `management`.\n - "*" # import all terms defined in the scope `tev2`\n status: proposed\n from: 20220312\n to:\n - vsntag: terms # a versiontag that identifies this version from all other versions in the SAF\n termselection:\n - "*" # import all terms that are curated in the current scope.\n'))),(0,o.kt)("p",null,"The following fields are defined for the ",(0,o.kt)("inlineCode",{parentName:"p"},"versions")," section of a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),":"),(0,o.kt)("details",null,(0,o.kt)("summary",null,"Legend"),(0,o.kt)("ol",null,(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Name"))," contains the field name;"),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,o.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,o.kt)("inlineCode",{parentName:"li"},"n"),", or ",(0,o.kt)("inlineCode",{parentName:"li"},"F"),") the field is required to be present as a header field. The ",(0,o.kt)("inlineCode",{parentName:"li"},"F")," means that we reserve this field for Future Use."),(0,o.kt)("li",{parentName:"ol"},(0,o.kt)("strong",{parentName:"li"},(0,o.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,o.kt)(n.Z,{mdxType:"APITable"},(0,o.kt)("table",null,(0,o.kt)("thead",{parentName:"table"},(0,o.kt)("tr",{parentName:"thead"},(0,o.kt)("th",{parentName:"tr",align:null},"Name"),(0,o.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,o.kt)("th",{parentName:"tr",align:null},"Description"))),(0,o.kt)("tbody",{parentName:"table"},(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"vsntag")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"Versiontag")," that that is used to identify this version within the set of all other versions that are maintained within this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),". in this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),". It MUST NOT be changed during the lifetime of this version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"altvsntags")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"List of alternative ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/versiontag",title:"Versiontag: a Tag that is used to identify a specific version of a Terminology from within a specific Scope."},"versiontags")," that may be used to refer to this version of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". A typical use of this field would be to tag a version as the 'latest' version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"termselection")),(0,o.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,o.kt)("td",{parentName:"tr",align:null},"List of ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-selection-instruction",title:"Term Selection Instruction: an instruction that is used to select one or more Terms for the purpose of processing their documentation, e.g., to create an MRG."},"term selection instructions")," that are used to generate (this version of) the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),". See the ",(0,o.kt)("a",{parentName:"td",href:"/docs/manuals/curator/terminology-construction"},"Terminology Construction page")," and the ",(0,o.kt)("a",{parentName:"td",href:"/docs/specs/syntax/term-selection"},"term selection syntax page")," for details.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"license")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"File that contains the (default) licensing conditions. Full URL is ",(0,o.kt)("inlineCode",{parentName:"td"},"scopedir"),"/",(0,o.kt)("inlineCode",{parentName:"td"},"license"),". If not specified, its value defaults to the value of the ",(0,o.kt)("inlineCode",{parentName:"td"},"license")," field in the ",(0,o.kt)("inlineCode",{parentName:"td"},"scope")," section (of this ",(0,o.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),"). The purpose of this field is to allow different versions of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope's")," ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," to have different licenses.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"status")),(0,o.kt)("td",{parentName:"tr",align:"center"},"n"),(0,o.kt)("td",{parentName:"tr",align:null},"Text that identifies the status of the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". (",(0,o.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/community",title:"Community: a Party, consisting of at least two different Parties (the members of the Community) that seek to collaborate with each other so that each of them can achieve its individual Objectives more efficiently and/or effectively."},"Communities")," of) ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes")," may specify values for this field. If not specified, the status SHOULD be assumed to be 'concept', 'draft', 'proposed', or similar. An example is the ",(0,o.kt)("a",{parentName:"td",href:"https://github.com/trustoverip/concepts-and-terminology-wg/blob/master/docs/status-tags.md"},"status tags used by ToIP"),".")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"from")),(0,o.kt)("td",{parentName:"tr",align:"center"},"F"),(0,o.kt)("td",{parentName:"tr",align:null},"Date at which it was decided to establish this version.")),(0,o.kt)("tr",{parentName:"tbody"},(0,o.kt)("td",{parentName:"tr",align:null},(0,o.kt)("inlineCode",{parentName:"td"},"to")),(0,o.kt)("td",{parentName:"tr",align:"center"},"F"),(0,o.kt)("td",{parentName:"tr",align:null},"Date at which this version will expire (or has expired)."))))),(0,o.kt)("admonition",{title:"Editor's note",type:"info"},(0,o.kt)("p",{parentName:"admonition"},"The ",(0,o.kt)("inlineCode",{parentName:"p"},"from")," and ",(0,o.kt)("inlineCode",{parentName:"p"},"to")," dates have been included to (in future) enable one to refer to a specific version of the terminology that was valid at a particular date. This feature needs to be worked out.")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8341015d.b28d4577.js b/assets/js/8341015d.29079251.js similarity index 99% rename from assets/js/8341015d.b28d4577.js rename to assets/js/8341015d.29079251.js index a9eeb7ecd..c7f668f7e 100644 --- a/assets/js/8341015d.b28d4577.js +++ b/assets/js/8341015d.29079251.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7396],{3905:(e,t,i)=>{i.d(t,{Zo:()=>d,kt:()=>l});var n=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function r(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=n.createContext({}),m=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},d=function(e){var t=m(e.components);return n.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),p=m(i),l=s,u=p["".concat(c,".").concat(l)]||p[l]||h[l]||o;return i?n.createElement(u,r(r({ref:t},d),{},{components:i})):n.createElement(u,r({ref:t},d))}));function l(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,r=new Array(o);r[0]=p;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,r[1]=a;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>o,metadata:()=>a,toc:()=>m});var n=i(3117),s=(i(7294),i(3905));const o={id:"ingestion",displayed_sidebar:"tev2SideBar",term:"ingestion",termType:"concept",isa:null,glossaryTerm:"Ingestion (Process)",glossaryText:"the process that is run by a [terms-community](@), in which their members suggest, draft, and discuss [definitions](@) ([terms](@) + [criteria](@)) that are relevant for a particular [scope](@), and converting such contributions into [curated texts](@) that accurately document the [concepts](@) and other [semantic units](@) and that adhere to the [TEv2-specifications](/docs/specs/files/curated-text-file).",grouptags:[],formPhrases:["ingestion-process","ingestion-processes","ingest","ingests","ingested","ingestion"],'status"':"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Ingestion (Process)",a={unversionedId:"terms/ingestion",id:"terms/ingestion",title:"Ingestion (Process)",description:"Ingestion (or the ingestion process) is the process that is run by a terms-community, in which their members suggest, draft, and discuss definitions (terms + associated criteria) that are relevant for a particular scope, and converting such contributions into curated texts that accurately document the concepts and other semantic units and that adhere to the TEv2-specifications.",source:"@site/docs/terms/ingestion.md",sourceDirName:"terms",slug:"/terms/ingestion",permalink:"/tev2-specifications/docs/terms/ingestion",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/ingestion.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"ingestion",displayed_sidebar:"tev2SideBar",term:"ingestion",termType:"concept",isa:null,glossaryTerm:"Ingestion (Process)",glossaryText:"the process that is run by a [terms-community](@), in which their members suggest, draft, and discuss [definitions](@) ([terms](@) + [criteria](@)) that are relevant for a particular [scope](@), and converting such contributions into [curated texts](@) that accurately document the [concepts](@) and other [semantic units](@) and that adhere to the [TEv2-specifications](/docs/specs/files/curated-text-file).",grouptags:[],formPhrases:["ingestion-process","ingestion-processes","ingest","ingests","ingested","ingestion"],'status"':"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],d={toc:m};function h(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,n.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"ingestion-process"},"Ingestion (Process)"),(0,s.kt)("p",null,(0,s.kt)("strong",{parentName:"p"},"Ingestion")," (or the ",(0,s.kt)("strong",{parentName:"p"},"ingestion process"),") is the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + associated criteria) that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("p",null,"It is typical that some of the members of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," are the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is being suggested, discussed and maintained."),(0,s.kt)("p",null,"It is also typical that the members make their contributions in various ways, e.g., using wiki-pages, confluence pages, Google Docs, Word docs, etc. It is important that the members of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," find ways to not only decide on what goes into the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", but also how to efficiently convert such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that comply with the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"specifications"),". The ",(0,s.kt)("a",{parentName:"p",href:"/docs/overview/tev2-architecture"},"TEv2 architecture")," acknowledges that this may require some specific tools, which is referred to as the 'ingress toolbox'."),(0,s.kt)("h2",{id:"examples"},"Examples"),(0,s.kt)("ol",null,(0,s.kt)("li",{parentName:"ol"},"In a collaborative terminology project, community members contribute new terms and their definitions through wiki-pages. The ingestion process involves reviewing these contributions and transforming them into curated texts for incorporation into the glossary."),(0,s.kt)("li",{parentName:"ol"},"The ingestion process may require the use of specialized tools to convert Google Docs' content into standardized curated texts with consistent formatting and metadata.")),(0,s.kt)("h2",{id:"notes"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ingestion process plays a vital role in continuously updating and expanding the terminology to reflect the evolving needs of the community."),(0,s.kt)("li",{parentName:"ul"},"Effective ingestion ensures that the curated texts are up-to-date and aligned with the specifications for consistent and standardized terminology management.")))}h.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7396],{3905:(e,t,i)=>{i.d(t,{Zo:()=>d,kt:()=>l});var n=i(7294);function s(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function r(e){for(var t=1;t=0||(s[i]=e[i]);return s}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(s[i]=e[i])}return s}var c=n.createContext({}),m=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):r(r({},t),e)),i},d=function(e){var t=m(e.components);return n.createElement(c.Provider,{value:t},e.children)},h={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var i=e.components,s=e.mdxType,o=e.originalType,c=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),p=m(i),l=s,u=p["".concat(c,".").concat(l)]||p[l]||h[l]||o;return i?n.createElement(u,r(r({ref:t},d),{},{components:i})):n.createElement(u,r({ref:t},d))}));function l(e,t){var i=arguments,s=t&&t.mdxType;if("string"==typeof e||s){var o=i.length,r=new Array(o);r[0]=p;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:s,r[1]=a;for(var m=2;m{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>r,default:()=>h,frontMatter:()=>o,metadata:()=>a,toc:()=>m});var n=i(3117),s=(i(7294),i(3905));const o={id:"ingestion",displayed_sidebar:"tev2SideBar",term:"ingestion",termType:"concept",isa:null,glossaryTerm:"Ingestion (Process)",glossaryText:"the process that is run by a [terms-community](@), in which their members suggest, draft, and discuss [definitions](@) ([terms](@) + [criteria](@)) that are relevant for a particular [scope](@), and converting such contributions into [curated texts](@) that accurately document the [concepts](@) and other [semantic units](@) and that adhere to the [TEv2-specifications](/docs/specs/files/curated-text-file).",grouptags:[],formPhrases:["ingestion-process","ingestion-processes","ingest","ingests","ingested","ingestion"],'status"':"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},r="Ingestion (Process)",a={unversionedId:"terms/ingestion",id:"terms/ingestion",title:"Ingestion (Process)",description:"Ingestion (or the ingestion process) is the process that is run by a terms-community, in which their members suggest, draft, and discuss definitions (terms + associated criteria) that are relevant for a particular scope, and converting such contributions into curated texts that accurately document the concepts and other semantic units and that adhere to the TEv2-specifications.",source:"@site/docs/terms/ingestion.md",sourceDirName:"terms",slug:"/terms/ingestion",permalink:"/tev2-specifications/docs/terms/ingestion",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/ingestion.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"ingestion",displayed_sidebar:"tev2SideBar",term:"ingestion",termType:"concept",isa:null,glossaryTerm:"Ingestion (Process)",glossaryText:"the process that is run by a [terms-community](@), in which their members suggest, draft, and discuss [definitions](@) ([terms](@) + [criteria](@)) that are relevant for a particular [scope](@), and converting such contributions into [curated texts](@) that accurately document the [concepts](@) and other [semantic units](@) and that adhere to the [TEv2-specifications](/docs/specs/files/curated-text-file).",grouptags:[],formPhrases:["ingestion-process","ingestion-processes","ingest","ingests","ingested","ingestion"],'status"':"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},m=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],d={toc:m};function h(e){let{components:t,...i}=e;return(0,s.kt)("wrapper",(0,n.Z)({},d,i,{components:t,mdxType:"MDXLayout"}),(0,s.kt)("h1",{id:"ingestion-process"},"Ingestion (Process)"),(0,s.kt)("p",null,(0,s.kt)("strong",{parentName:"p"},"Ingestion")," (or the ",(0,s.kt)("strong",{parentName:"p"},"ingestion process"),") is the process that is run by a ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community"),", in which their members suggest, draft, and discuss ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," (",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," + associated criteria) that are relevant for a particular ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope"),", and converting such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that accurately document the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," and other ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," and that adhere to the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"TEv2-specifications"),"."),(0,s.kt)("p",null,"It is typical that some of the members of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," are the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," for which the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," is being suggested, discussed and maintained."),(0,s.kt)("p",null,"It is also typical that the members make their contributions in various ways, e.g., using wiki-pages, confluence pages, Google Docs, Word docs, etc. It is important that the members of the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terms-community",title:"Terms Community: a Community that maintains a Terminology for the purpose of avoiding misunderstandings between its members as they collaborate."},"terms-community")," and the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curators")," find ways to not only decide on what goes into the ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),", but also how to efficiently convert such contributions into ",(0,s.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated texts")," that comply with the ",(0,s.kt)("a",{parentName:"p",href:"/docs/specs/files/curated-text-file"},"specifications"),". The ",(0,s.kt)("a",{parentName:"p",href:"/docs/overview/tev2-architecture"},"TEv2 architecture")," acknowledges that this may require some specific tools, which is referred to as the 'ingress toolbox'."),(0,s.kt)("h2",{id:"examples"},"Examples"),(0,s.kt)("ol",null,(0,s.kt)("li",{parentName:"ol"},"In a collaborative terminology project, community members contribute new terms and their definitions through wiki-pages. The ingestion process involves reviewing these contributions and transforming them into curated texts for incorporation into the glossary."),(0,s.kt)("li",{parentName:"ol"},"The ingestion process may require the use of specialized tools to convert Google Docs' content into standardized curated texts with consistent formatting and metadata.")),(0,s.kt)("h2",{id:"notes"},"Notes"),(0,s.kt)("ul",null,(0,s.kt)("li",{parentName:"ul"},"The ingestion process plays a vital role in continuously updating and expanding the terminology to reflect the evolving needs of the community."),(0,s.kt)("li",{parentName:"ul"},"Effective ingestion ensures that the curated texts are up-to-date and aligned with the specifications for consistent and standardized terminology management.")))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/83d6452b.82226286.js b/assets/js/83d6452b.6ad95a66.js similarity index 98% rename from assets/js/83d6452b.82226286.js rename to assets/js/83d6452b.6ad95a66.js index c87429682..7d914a000 100644 --- a/assets/js/83d6452b.82226286.js +++ b/assets/js/83d6452b.6ad95a66.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1437],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,a=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),f=l(r),m=o,u=f["".concat(c,".").concat(m)]||f[m]||d[m]||a;return r?n.createElement(u,i(i({ref:t},p),{},{components:r})):n.createElement(u,i({ref:t},p))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=r.length,i=new Array(a);i[0]=f;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,i[1]=s;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>d,frontMatter:()=>a,metadata:()=>s,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const a={id:"@",displayed_sidebar:"tev2SideBar",term:"at-character",termType:"error",excludeFromMRG:"yes",glossaryTerm:"@ (unresolvable reference)",glossaryText:"Error - the reference cannot be resolved.",sidebar_label:"Term ref not found"},i="ERROR - The reference cannot be resolved",s={unversionedId:"terms/@",id:"terms/@",title:"ERROR - The reference cannot be resolved",description:"When you are here, you have clicked on a term that hasn't been (properly) defined.",source:"@site/docs/terms/@.md",sourceDirName:"terms",slug:"/terms/@",permalink:"/tev2-specifications/docs/terms/@",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/@.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"@",displayed_sidebar:"tev2SideBar",term:"at-character",termType:"error",excludeFromMRG:"yes",glossaryTerm:"@ (unresolvable reference)",glossaryText:"Error - the reference cannot be resolved.",sidebar_label:"Term ref not found"},sidebar:"tev2SideBar"},c={},l=[{value:"Explanation",id:"explanation",level:2}],p={toc:l};function d(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"error---the-reference-cannot-be-resolved"},"ERROR - The reference cannot be resolved"),(0,o.kt)("p",null,"When you are here, you have clicked on a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that hasn't been (properly) defined."),(0,o.kt)("h2",{id:"explanation"},"Explanation"),(0,o.kt)("p",null,"When a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," ",(0,o.kt)("inlineCode",{parentName:"p"},"someterm")," isn't defined, the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," ",(0,o.kt)("inlineCode",{parentName:"p"},"[someterm](@)")," will product a link to a term with ",(0,o.kt)("inlineCode",{parentName:"p"},"id=@"),". So when you click that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", your browser will navigate to this page, because it is a the location of where the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for ",(0,o.kt)("inlineCode",{parentName:"p"},"@")," would be."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1437],{3905:(e,t,r)=>{r.d(t,{Zo:()=>p,kt:()=>m});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function a(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var c=n.createContext({}),l=function(e){var t=n.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,a=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),f=l(r),m=o,u=f["".concat(c,".").concat(m)]||f[m]||d[m]||a;return r?n.createElement(u,i(i({ref:t},p),{},{components:r})):n.createElement(u,i({ref:t},p))}));function m(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=r.length,i=new Array(a);i[0]=f;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:o,i[1]=s;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>d,frontMatter:()=>a,metadata:()=>s,toc:()=>l});var n=r(3117),o=(r(7294),r(3905));const a={id:"@",displayed_sidebar:"tev2SideBar",term:"at-character",termType:"error",excludeFromMRG:"yes",glossaryTerm:"@ (unresolvable reference)",glossaryText:"Error - the reference cannot be resolved.",sidebar_label:"Term ref not found"},i="ERROR - The reference cannot be resolved",s={unversionedId:"terms/@",id:"terms/@",title:"ERROR - The reference cannot be resolved",description:"When you are here, you have clicked on a term that hasn't been (properly) defined.",source:"@site/docs/terms/@.md",sourceDirName:"terms",slug:"/terms/@",permalink:"/tev2-specifications/docs/terms/@",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/@.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"@",displayed_sidebar:"tev2SideBar",term:"at-character",termType:"error",excludeFromMRG:"yes",glossaryTerm:"@ (unresolvable reference)",glossaryText:"Error - the reference cannot be resolved.",sidebar_label:"Term ref not found"},sidebar:"tev2SideBar"},c={},l=[{value:"Explanation",id:"explanation",level:2}],p={toc:l};function d(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"error---the-reference-cannot-be-resolved"},"ERROR - The reference cannot be resolved"),(0,o.kt)("p",null,"When you are here, you have clicked on a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that hasn't been (properly) defined."),(0,o.kt)("h2",{id:"explanation"},"Explanation"),(0,o.kt)("p",null,"When a ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," ",(0,o.kt)("inlineCode",{parentName:"p"},"someterm")," isn't defined, the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," ",(0,o.kt)("inlineCode",{parentName:"p"},"[someterm](@)")," will product a link to a term with ",(0,o.kt)("inlineCode",{parentName:"p"},"id=@"),". So when you click that ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", your browser will navigate to this page, because it is a the location of where the ",(0,o.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," for ",(0,o.kt)("inlineCode",{parentName:"p"},"@")," would be."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/859087a1.afd8be37.js b/assets/js/859087a1.48ac9743.js similarity index 99% rename from assets/js/859087a1.afd8be37.js rename to assets/js/859087a1.48ac9743.js index 250a990f6..e72070f05 100644 --- a/assets/js/859087a1.afd8be37.js +++ b/assets/js/859087a1.48ac9743.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[982],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var l=a.createContext({}),c=function(e){var t=a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},u=function(e){var t=c(e.components);return a.createElement(l.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},p=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),p=c(r),f=n,m=p["".concat(l,".").concat(f)]||p[f]||d[f]||o;return r?a.createElement(m,s(s({ref:t},u),{},{components:r})):a.createElement(m,s({ref:t},u))}));function f(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,s=new Array(o);s[0]=p;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,s[1]=i;for(var c=2;c{r.d(t,{Z:()=>s});var a=r(7294),n=r(6010);const o="tabItem_Ymn6";function s(e){let{children:t,hidden:r,className:s}=e;return a.createElement("div",{role:"tabpanel",className:(0,n.Z)(o,s),hidden:r},t)}},4866:(e,t,r)=>{r.d(t,{Z:()=>T});var a=r(3117),n=r(7294),o=r(6010),s=r(2466),i=r(6775),l=r(1980),c=r(7392),u=r(12);function d(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:r,attributes:a,default:n}}=e;return{value:t,label:r,attributes:a,default:n}}))}function p(e){const{values:t,children:r}=e;return(0,n.useMemo)((()=>{const e=t??d(r);return function(e){const t=(0,c.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,r])}function f(e){let{value:t,tabValues:r}=e;return r.some((e=>e.value===t))}function m(e){let{queryString:t=!1,groupId:r}=e;const a=(0,i.k6)(),o=function(e){let{queryString:t=!1,groupId:r}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!r)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return r??null}({queryString:t,groupId:r});return[(0,l._X)(o),(0,n.useCallback)((e=>{if(!o)return;const t=new URLSearchParams(a.location.search);t.set(o,e),a.replace({...a.location,search:t.toString()})}),[o,a])]}function h(e){const{defaultValue:t,queryString:r=!1,groupId:a}=e,o=p(e),[s,i]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:r}=e;if(0===r.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!f({value:t,tabValues:r}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${r.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const a=r.find((e=>e.default))??r[0];if(!a)throw new Error("Unexpected error: 0 tabValues");return a.value}({defaultValue:t,tabValues:o}))),[l,c]=m({queryString:r,groupId:a}),[d,h]=function(e){let{groupId:t}=e;const r=function(e){return e?`docusaurus.tab.${e}`:null}(t),[a,o]=(0,u.Nk)(r);return[a,(0,n.useCallback)((e=>{r&&o.set(e)}),[r,o])]}({groupId:a}),b=(()=>{const e=l??d;return f({value:e,tabValues:o})?e:null})();(0,n.useLayoutEffect)((()=>{b&&i(b)}),[b]);return{selectedValue:s,selectValue:(0,n.useCallback)((e=>{if(!f({value:e,tabValues:o}))throw new Error(`Can't select invalid tab value=${e}`);i(e),c(e),h(e)}),[c,h,o]),tabValues:o}}var b=r(2389);const y="tabList__CuJ",g="tabItem_LNqP";function v(e){let{className:t,block:r,selectedValue:i,selectValue:l,tabValues:c}=e;const u=[],{blockElementScrollPositionUntilNextRender:d}=(0,s.o5)(),p=e=>{const t=e.currentTarget,r=u.indexOf(t),a=c[r].value;a!==i&&(d(t),l(a))},f=e=>{let t=null;switch(e.key){case"Enter":p(e);break;case"ArrowRight":{const r=u.indexOf(e.currentTarget)+1;t=u[r]??u[0];break}case"ArrowLeft":{const r=u.indexOf(e.currentTarget)-1;t=u[r]??u[u.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,o.Z)("tabs",{"tabs--block":r},t)},c.map((e=>{let{value:t,label:r,attributes:s}=e;return n.createElement("li",(0,a.Z)({role:"tab",tabIndex:i===t?0:-1,"aria-selected":i===t,key:t,ref:e=>u.push(e),onKeyDown:f,onClick:p},s,{className:(0,o.Z)("tabs__item",g,s?.className,{"tabs__item--active":i===t})}),r??t)})))}function w(e){let{lazy:t,children:r,selectedValue:a}=e;const o=(Array.isArray(r)?r:[r]).filter(Boolean);if(t){const e=o.find((e=>e.props.value===a));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},o.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==a}))))}function k(e){const t=h(e);return n.createElement("div",{className:(0,o.Z)("tabs-container",y)},n.createElement(v,(0,a.Z)({},e,t)),n.createElement(w,(0,a.Z)({},e,t)))}function T(e){const t=(0,b.Z)();return n.createElement(k,(0,a.Z)({key:String(t)},e))}},7508:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>f,frontMatter:()=>s,mark:()=>d,metadata:()=>l,toc:()=>u});var a=r(3117),n=(r(7294),r(3905)),o=r(4996);r(4866),r(5162);const s={id:"termref-selector",sidebar_label:"TermRef Selector",date:20231031},i="TermRef Selector Tool",l={unversionedId:"specs/tools-envisaged/termref-selector",id:"specs/tools-envisaged/termref-selector",title:"TermRef Selector Tool",description:"{let{children:t}=e;return(0,n.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},p={toc:u,mark:d};function f(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"termref-selector-tool"},"TermRef Selector Tool"),(0,n.kt)("img",{alt:"This page is under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,n.kt)("br",null),(0,n.kt)("br",null),(0,n.kt)("p",null,"The ",(0,n.kt)("strong",{parentName:"p"},"TermRef Selector")," tool is a tool that helps you as you create purpose-specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),", such as an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," for every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that you use in a particular (set of) document(s), which you can subsequently use to generate a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," for."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This idea needs to be thought through. One of the questions would be whether you would want the tool to create a set of term-selection instructions (to be inserted in an entry in the ",(0,n.kt)("inlineCode",{parentName:"p"},"termselection"),"-section of a SAF), or whether this tool is another kind of MRGT that simply creates such an MRG.")))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[982],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var a=r(7294);function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function s(e){for(var t=1;t=0||(n[r]=e[r]);return n}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(n[r]=e[r])}return n}var l=a.createContext({}),c=function(e){var t=a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},u=function(e){var t=c(e.components);return a.createElement(l.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},p=a.forwardRef((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),p=c(r),f=n,m=p["".concat(l,".").concat(f)]||p[f]||d[f]||o;return r?a.createElement(m,s(s({ref:t},u),{},{components:r})):a.createElement(m,s({ref:t},u))}));function f(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,s=new Array(o);s[0]=p;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,s[1]=i;for(var c=2;c{r.d(t,{Z:()=>s});var a=r(7294),n=r(6010);const o="tabItem_Ymn6";function s(e){let{children:t,hidden:r,className:s}=e;return a.createElement("div",{role:"tabpanel",className:(0,n.Z)(o,s),hidden:r},t)}},4866:(e,t,r)=>{r.d(t,{Z:()=>T});var a=r(3117),n=r(7294),o=r(6010),s=r(2466),i=r(6775),l=r(1980),c=r(7392),u=r(12);function d(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:r,attributes:a,default:n}}=e;return{value:t,label:r,attributes:a,default:n}}))}function p(e){const{values:t,children:r}=e;return(0,n.useMemo)((()=>{const e=t??d(r);return function(e){const t=(0,c.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,r])}function f(e){let{value:t,tabValues:r}=e;return r.some((e=>e.value===t))}function m(e){let{queryString:t=!1,groupId:r}=e;const a=(0,i.k6)(),o=function(e){let{queryString:t=!1,groupId:r}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!r)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return r??null}({queryString:t,groupId:r});return[(0,l._X)(o),(0,n.useCallback)((e=>{if(!o)return;const t=new URLSearchParams(a.location.search);t.set(o,e),a.replace({...a.location,search:t.toString()})}),[o,a])]}function h(e){const{defaultValue:t,queryString:r=!1,groupId:a}=e,o=p(e),[s,i]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:r}=e;if(0===r.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!f({value:t,tabValues:r}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${r.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const a=r.find((e=>e.default))??r[0];if(!a)throw new Error("Unexpected error: 0 tabValues");return a.value}({defaultValue:t,tabValues:o}))),[l,c]=m({queryString:r,groupId:a}),[d,h]=function(e){let{groupId:t}=e;const r=function(e){return e?`docusaurus.tab.${e}`:null}(t),[a,o]=(0,u.Nk)(r);return[a,(0,n.useCallback)((e=>{r&&o.set(e)}),[r,o])]}({groupId:a}),b=(()=>{const e=l??d;return f({value:e,tabValues:o})?e:null})();(0,n.useLayoutEffect)((()=>{b&&i(b)}),[b]);return{selectedValue:s,selectValue:(0,n.useCallback)((e=>{if(!f({value:e,tabValues:o}))throw new Error(`Can't select invalid tab value=${e}`);i(e),c(e),h(e)}),[c,h,o]),tabValues:o}}var b=r(2389);const y="tabList__CuJ",g="tabItem_LNqP";function v(e){let{className:t,block:r,selectedValue:i,selectValue:l,tabValues:c}=e;const u=[],{blockElementScrollPositionUntilNextRender:d}=(0,s.o5)(),p=e=>{const t=e.currentTarget,r=u.indexOf(t),a=c[r].value;a!==i&&(d(t),l(a))},f=e=>{let t=null;switch(e.key){case"Enter":p(e);break;case"ArrowRight":{const r=u.indexOf(e.currentTarget)+1;t=u[r]??u[0];break}case"ArrowLeft":{const r=u.indexOf(e.currentTarget)-1;t=u[r]??u[u.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,o.Z)("tabs",{"tabs--block":r},t)},c.map((e=>{let{value:t,label:r,attributes:s}=e;return n.createElement("li",(0,a.Z)({role:"tab",tabIndex:i===t?0:-1,"aria-selected":i===t,key:t,ref:e=>u.push(e),onKeyDown:f,onClick:p},s,{className:(0,o.Z)("tabs__item",g,s?.className,{"tabs__item--active":i===t})}),r??t)})))}function w(e){let{lazy:t,children:r,selectedValue:a}=e;const o=(Array.isArray(r)?r:[r]).filter(Boolean);if(t){const e=o.find((e=>e.props.value===a));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},o.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==a}))))}function k(e){const t=h(e);return n.createElement("div",{className:(0,o.Z)("tabs-container",y)},n.createElement(v,(0,a.Z)({},e,t)),n.createElement(w,(0,a.Z)({},e,t)))}function T(e){const t=(0,b.Z)();return n.createElement(k,(0,a.Z)({key:String(t)},e))}},7508:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>f,frontMatter:()=>s,mark:()=>d,metadata:()=>l,toc:()=>u});var a=r(3117),n=(r(7294),r(3905)),o=r(4996);r(4866),r(5162);const s={id:"termref-selector",sidebar_label:"TermRef Selector",date:20231031},i="TermRef Selector Tool",l={unversionedId:"specs/tools-envisaged/termref-selector",id:"specs/tools-envisaged/termref-selector",title:"TermRef Selector Tool",description:"{let{children:t}=e;return(0,n.kt)("span",{style:{color:"black",backgroundColor:"yellow",padding:"0.2rem",borderRadius:"2px"}},t)},p={toc:u,mark:d};function f(e){let{components:t,...r}=e;return(0,n.kt)("wrapper",(0,a.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"termref-selector-tool"},"TermRef Selector Tool"),(0,n.kt)("img",{alt:"This page is under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,n.kt)("br",null),(0,n.kt)("br",null),(0,n.kt)("p",null,"The ",(0,n.kt)("strong",{parentName:"p"},"TermRef Selector")," tool is a tool that helps you as you create purpose-specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRGs"),", such as an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," that contains an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/mrg-entry",title:"MRG Entry: A machine-readable (and interpretable) artifact that contains (pointers to) data and meta-data about a particular Semantic Unit, such as the associated Term(s), its Definition, etc., to make it easy for IT-tools to create, e.g. documentation, Glossaries, Dictionaries, whitepapers, etc. that uses such Terms (Definitions, etc.)."},"MRG entry")," for every ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that you use in a particular (set of) document(s), which you can subsequently use to generate a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/hrg",title:"Human Readable Glossary: a Glossary that is designed to be easily understandable and accessible to humans. HRGs present terms and their meanings in a format that prioritizes human comprehension and may include additional contextual information to aid understanding."},"HRG")," for."),(0,n.kt)("admonition",{type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This idea needs to be thought through. One of the questions would be whether you would want the tool to create a set of term-selection instructions (to be inserted in an entry in the ",(0,n.kt)("inlineCode",{parentName:"p"},"termselection"),"-section of a SAF), or whether this tool is another kind of MRGT that simply creates such an MRG.")))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/85bdfa30.cd3ef5ac.js b/assets/js/85bdfa30.69514acf.js similarity index 99% rename from assets/js/85bdfa30.cd3ef5ac.js rename to assets/js/85bdfa30.69514acf.js index de55646a5..a82e90ea2 100644 --- a/assets/js/85bdfa30.cd3ef5ac.js +++ b/assets/js/85bdfa30.69514acf.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3658],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>u});var n=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function o(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=n.createContext({}),p=function(e){var t=n.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},l=function(e){var t=p(e.components);return n.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},h=n.forwardRef((function(e,t){var a=e.components,i=e.mdxType,r=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),h=p(a),u=i,d=h["".concat(c,".").concat(u)]||h[u]||m[u]||r;return a?n.createElement(d,o(o({ref:t},l),{},{components:a})):n.createElement(d,o({ref:t},l))}));function u(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:i,o[1]=s;for(var p=2;p{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>p});var n=a(3117),i=(a(7294),a(3905));const r={id:"property",displayed_sidebar:"tev2SideBar",term:"property",termType:"concept",isa:null,glossaryTerm:"Property (of a Concept)",glossaryText:"a connection or association between a [concept](@) and a primitive data element, such as a text or a number, that represents some characteristic that instances of the [concept](@) may have.",grouptags:["conceptual-modeling"],formPhrases:["propert{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Property (of a Concept)",s={unversionedId:"terms/property",id:"terms/property",title:"Property (of a Concept)",description:"A property (of a concept) is a connection or association between that concept and a primitive data element, such as a text, a number, a boolean value, etc., that represents some characteristic that (instances of) the concept may have.",source:"@site/docs/terms/property.md",sourceDirName:"terms",slug:"/terms/property",permalink:"/tev2-specifications/docs/terms/property",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/property.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"property",displayed_sidebar:"tev2SideBar",term:"property",termType:"concept",isa:null,glossaryTerm:"Property (of a Concept)",glossaryText:"a connection or association between a [concept](@) and a primitive data element, such as a text or a number, that represents some characteristic that instances of the [concept](@) may have.",grouptags:["conceptual-modeling"],formPhrases:["propert{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],l={toc:p};function m(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,n.Z)({},l,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"property-of-a-concept"},"Property (of a Concept)"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"property (of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),")")," is a connection or association between that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text, a number, a boolean value, etc., that represents some characteristic that (instances of) the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,i.kt)("p",null,"Where ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," describe connections or associations between ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", properties describe characteristics of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in terms of data attributes or values."),(0,i.kt)("p",null,"Properties are crucial for capturing and representing specific characteristics, attributes, or features of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in a model. They enable the inclusion of essential metadata and descriptive information associated with ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,i.kt)("h2",{id:"examples"},"Examples"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},'In a product database, the "Price" property relates the "Product" concept to a numeric value representing its cost.'),(0,i.kt)("li",{parentName:"ol"},'The "Color" property of an "Apple" concept links it to a text value indicating its visual appearance.'),(0,i.kt)("li",{parentName:"ol"},'"Gender" can be a property of a "Person" (or "Animal") concept, as can "being a parent".')),(0,i.kt)("h2",{id:"notes"},"Notes"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Properties play a significant role in enriching the conceptual model with detailed attribute information for each concept."),(0,i.kt)("li",{parentName:"ul"},"Defining properties accurately is essential for maintaining consistency and accuracy in the conceptual model.")))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[3658],{3905:(e,t,a)=>{a.d(t,{Zo:()=>l,kt:()=>u});var n=a(7294);function i(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function o(e){for(var t=1;t=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=n.createContext({}),p=function(e){var t=n.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},l=function(e){var t=p(e.components);return n.createElement(c.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},h=n.forwardRef((function(e,t){var a=e.components,i=e.mdxType,r=e.originalType,c=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),h=p(a),u=i,d=h["".concat(c,".").concat(u)]||h[u]||m[u]||r;return a?n.createElement(d,o(o({ref:t},l),{},{components:a})):n.createElement(d,o({ref:t},l))}));function u(e,t){var a=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:i,o[1]=s;for(var p=2;p{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>o,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>p});var n=a(3117),i=(a(7294),a(3905));const r={id:"property",displayed_sidebar:"tev2SideBar",term:"property",termType:"concept",isa:null,glossaryTerm:"Property (of a Concept)",glossaryText:"a connection or association between a [concept](@) and a primitive data element, such as a text or a number, that represents some characteristic that instances of the [concept](@) may have.",grouptags:["conceptual-modeling"],formPhrases:["propert{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Property (of a Concept)",s={unversionedId:"terms/property",id:"terms/property",title:"Property (of a Concept)",description:"A property (of a concept) is a connection or association between that concept and a primitive data element, such as a text, a number, a boolean value, etc., that represents some characteristic that (instances of) the concept may have.",source:"@site/docs/terms/property.md",sourceDirName:"terms",slug:"/terms/property",permalink:"/tev2-specifications/docs/terms/property",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/property.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"property",displayed_sidebar:"tev2SideBar",term:"property",termType:"concept",isa:null,glossaryTerm:"Property (of a Concept)",glossaryText:"a connection or association between a [concept](@) and a primitive data element, such as a text or a number, that represents some characteristic that instances of the [concept](@) may have.",grouptags:["conceptual-modeling"],formPhrases:["propert{yies}"],status:"proposed",created:20230731,updated:20230731,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[{value:"Examples",id:"examples",level:2},{value:"Notes",id:"notes",level:2}],l={toc:p};function m(e){let{components:t,...a}=e;return(0,i.kt)("wrapper",(0,n.Z)({},l,a,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"property-of-a-concept"},"Property (of a Concept)"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"property (of a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept"),")")," is a connection or association between that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," and a primitive data element, such as a text, a number, a boolean value, etc., that represents some characteristic that (instances of) the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," may have."),(0,i.kt)("p",null,"Where ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/relation",title:"Relation (between Concepts): a (significant) connection or association between two or more Concepts."},"relations")," describe connections or associations between ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", properties describe characteristics of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in terms of data attributes or values."),(0,i.kt)("p",null,"Properties are crucial for capturing and representing specific characteristics, attributes, or features of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," in a model. They enable the inclusion of essential metadata and descriptive information associated with ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,i.kt)("h2",{id:"examples"},"Examples"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},'In a product database, the "Price" property relates the "Product" concept to a numeric value representing its cost.'),(0,i.kt)("li",{parentName:"ol"},'The "Color" property of an "Apple" concept links it to a text value indicating its visual appearance.'),(0,i.kt)("li",{parentName:"ol"},'"Gender" can be a property of a "Person" (or "Animal") concept, as can "being a parent".')),(0,i.kt)("h2",{id:"notes"},"Notes"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Properties play a significant role in enriching the conceptual model with detailed attribute information for each concept."),(0,i.kt)("li",{parentName:"ul"},"Defining properties accurately is essential for maintaining consistency and accuracy in the conceptual model.")))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8602ac2f.3fe4f150.js b/assets/js/8602ac2f.d4e6c203.js similarity index 99% rename from assets/js/8602ac2f.3fe4f150.js rename to assets/js/8602ac2f.d4e6c203.js index 437229e12..7488ebaf2 100644 --- a/assets/js/8602ac2f.3fe4f150.js +++ b/assets/js/8602ac2f.d4e6c203.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4436],{3905:(e,t,r)=>{r.d(t,{Zo:()=>h,kt:()=>p});var a=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var d=a.createContext({}),c=function(e){var t=a.useContext(d),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},h=function(e){var t=c(e.components);return a.createElement(d.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var r=e.components,i=e.mdxType,n=e.originalType,d=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),f=c(r),p=i,u=f["".concat(d,".").concat(p)]||f[p]||l[p]||n;return r?a.createElement(u,o(o({ref:t},h),{},{components:r})):a.createElement(u,o({ref:t},h))}));function p(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=r.length,o=new Array(n);o[0]=f;var s={};for(var d in t)hasOwnProperty.call(t,d)&&(s[d]=t[d]);s.originalType=e,s.mdxType="string"==typeof e?e:i,o[1]=s;for(var c=2;c{r.r(t),r.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>l,frontMatter:()=>n,metadata:()=>s,toc:()=>c});var a=r(3117),i=(r(7294),r(3905));const n={id:"renderable-ref",displayed_sidebar:"tev2SideBar",term:"renderable-ref",termType:"concept",isa:null,glossaryTerm:"Renderable Ref",glossaryText:"a text with which the [TRRT](@) replaces a [TermRef](@), that can be processed by specific third party rendering tools, the result of which is a rendering of the original [TermRef](@) that has additional characteristics that help [readers](@) to (better) understand the intention of its [author](@).",grouptags:[],formPhrases:["renderable-ref{ss}","renderableref{ss}","renderable-reference{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Renderable Ref",s={unversionedId:"terms/renderable-ref",id:"terms/renderable-ref",title:"Renderable Ref",description:"Summary",source:"@site/docs/terms/renderable-ref.md",sourceDirName:"terms",slug:"/terms/renderable-ref",permalink:"/tev2-specifications/docs/terms/renderable-ref",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/renderable-ref.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"renderable-ref",displayed_sidebar:"tev2SideBar",term:"renderable-ref",termType:"concept",isa:null,glossaryTerm:"Renderable Ref",glossaryText:"a text with which the [TRRT](@) replaces a [TermRef](@), that can be processed by specific third party rendering tools, the result of which is a rendering of the original [TermRef](@) that has additional characteristics that help [readers](@) to (better) understand the intention of its [author](@).",grouptags:[],formPhrases:["renderable-ref{ss}","renderableref{ss}","renderable-reference{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},d={},c=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],h={toc:c};function l(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,a.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"renderable-ref"},"Renderable Ref"),(0,i.kt)("h3",{id:"summary"},"Summary"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"Renderable Ref(erence)")," is a text with which the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,i.kt)("p",null,"For example, when rendering a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"for a static website, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref")," might contain texts that would produce the effect that, when a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader")," browses to that website and hovers its mouse over a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref"),", this will produce a popup that contains its ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,i.kt)("li",{parentName:"ul"},"for a PDF, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref")," might contain texts that would enable generator tools to produce a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of all ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that were referenced within the paper, which could then automatically be inserted as an appendix to the PDF.")),(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators"),", which are expected to control the ways in which authored texts are further processed (into rendered texts), will need to know the options provided by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT tool")," in order to ensure that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that are used in an authored text are rendered with the kind of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs")," that produce the envisaged rendering effects.",(0,i.kt)("h3",{id:"purpose"},"Purpose"),(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"Renderable refs")," enable authored texts to be rendered in various ways, depending on the kind of target towards which is rendered.")}l.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4436],{3905:(e,t,r)=>{r.d(t,{Zo:()=>h,kt:()=>p});var a=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,a)}return r}function o(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var d=a.createContext({}),c=function(e){var t=a.useContext(d),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},h=function(e){var t=c(e.components);return a.createElement(d.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},f=a.forwardRef((function(e,t){var r=e.components,i=e.mdxType,n=e.originalType,d=e.parentName,h=s(e,["components","mdxType","originalType","parentName"]),f=c(r),p=i,u=f["".concat(d,".").concat(p)]||f[p]||l[p]||n;return r?a.createElement(u,o(o({ref:t},h),{},{components:r})):a.createElement(u,o({ref:t},h))}));function p(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=r.length,o=new Array(n);o[0]=f;var s={};for(var d in t)hasOwnProperty.call(t,d)&&(s[d]=t[d]);s.originalType=e,s.mdxType="string"==typeof e?e:i,o[1]=s;for(var c=2;c{r.r(t),r.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>l,frontMatter:()=>n,metadata:()=>s,toc:()=>c});var a=r(3117),i=(r(7294),r(3905));const n={id:"renderable-ref",displayed_sidebar:"tev2SideBar",term:"renderable-ref",termType:"concept",isa:null,glossaryTerm:"Renderable Ref",glossaryText:"a text with which the [TRRT](@) replaces a [TermRef](@), that can be processed by specific third party rendering tools, the result of which is a rendering of the original [TermRef](@) that has additional characteristics that help [readers](@) to (better) understand the intention of its [author](@).",grouptags:[],formPhrases:["renderable-ref{ss}","renderableref{ss}","renderable-reference{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},o="Renderable Ref",s={unversionedId:"terms/renderable-ref",id:"terms/renderable-ref",title:"Renderable Ref",description:"Summary",source:"@site/docs/terms/renderable-ref.md",sourceDirName:"terms",slug:"/terms/renderable-ref",permalink:"/tev2-specifications/docs/terms/renderable-ref",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/renderable-ref.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"renderable-ref",displayed_sidebar:"tev2SideBar",term:"renderable-ref",termType:"concept",isa:null,glossaryTerm:"Renderable Ref",glossaryText:"a text with which the [TRRT](@) replaces a [TermRef](@), that can be processed by specific third party rendering tools, the result of which is a rendering of the original [TermRef](@) that has additional characteristics that help [readers](@) to (better) understand the intention of its [author](@).",grouptags:[],formPhrases:["renderable-ref{ss}","renderableref{ss}","renderable-reference{ss}"],status:"proposed",created:20220606,updated:20220804,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},d={},c=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3}],h={toc:c};function l(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,a.Z)({},h,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"renderable-ref"},"Renderable Ref"),(0,i.kt)("h3",{id:"summary"},"Summary"),(0,i.kt)("p",null,"A ",(0,i.kt)("strong",{parentName:"p"},"Renderable Ref(erence)")," is a text with which the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," replaces a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),", that can be processed by specific third party rendering tools, the result of which is a rendering of the original ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," that has additional characteristics that help ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"readers")," to (better) understand the intention of its ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author"),"."),(0,i.kt)("p",null,"For example, when rendering a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"for a static website, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref")," might contain texts that would produce the effect that, when a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader")," browses to that website and hovers its mouse over a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref"),", this will produce a popup that contains its ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definition"),"."),(0,i.kt)("li",{parentName:"ul"},"for a PDF, the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable ref")," might contain texts that would enable generator tools to produce a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/glossary",title:"Glossary: an alphabetically sorted list of Terms with the (single) meaning it has in (at least) one context."},"glossary")," of all ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," that were referenced within the paper, which could then automatically be inserted as an appendix to the PDF.")),(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"Curators"),", which are expected to control the ways in which authored texts are further processed (into rendered texts), will need to know the options provided by the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT tool")," in order to ensure that the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that are used in an authored text are rendered with the kind of ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs")," that produce the envisaged rendering effects.",(0,i.kt)("h3",{id:"purpose"},"Purpose"),(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"Renderable refs")," enable authored texts to be rendered in various ways, depending on the kind of target towards which is rendered.")}l.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8677fb48.21e7c562.js b/assets/js/8677fb48.e37eb99b.js similarity index 99% rename from assets/js/8677fb48.21e7c562.js rename to assets/js/8677fb48.e37eb99b.js index b03793c5e..8459448bb 100644 --- a/assets/js/8677fb48.21e7c562.js +++ b/assets/js/8677fb48.e37eb99b.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7711],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>h});var o=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},u=o.forwardRef((function(e,t){var r=e.components,i=e.mdxType,s=e.originalType,c=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),u=p(r),h=i,d=u["".concat(c,".").concat(h)]||u[h]||f[h]||s;return r?o.createElement(d,n(n({ref:t},l),{},{components:r})):o.createElement(d,n({ref:t},l))}));function h(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=r.length,n=new Array(s);n[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,n[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>s,metadata:()=>a,toc:()=>p});var o=r(3117),i=(r(7294),r(3905));const s={id:"interpreter",displayed_sidebar:"tev2SideBar",term:"interpreter",termType:"concept",isa:null,glossaryTerm:"Interpreter",glossaryText:"a [regex](@) that is used to locate a particular text construct (such as a [TermRef](@) or [MRGRef](@)) in a text, and that populates [named capturing groups](@) as specified in the [interpreter profile](@) of the particular [text conversion tool](@) for which it is designed.",grouptags:[],formPhrases:["interpreter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Interpreter",a={unversionedId:"terms/interpreter",id:"terms/interpreter",title:"Interpreter",description:"An interpreter is a regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates named capturing groups as specified in the interpreter profile of the particular text conversion tool for which it is designed.",source:"@site/docs/terms/interpreter.md",sourceDirName:"terms",slug:"/terms/interpreter",permalink:"/tev2-specifications/docs/terms/interpreter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/interpreter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"interpreter",displayed_sidebar:"tev2SideBar",term:"interpreter",termType:"concept",isa:null,glossaryTerm:"Interpreter",glossaryText:"a [regex](@) that is used to locate a particular text construct (such as a [TermRef](@) or [MRGRef](@)) in a text, and that populates [named capturing groups](@) as specified in the [interpreter profile](@) of the particular [text conversion tool](@) for which it is designed.",grouptags:[],formPhrases:["interpreter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],l={toc:p};function f(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"interpreter"},"Interpreter"),(0,i.kt)("p",null,"An ",(0,i.kt)("strong",{parentName:"p"},"interpreter")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,i.kt)("p",null,"The ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"specifications")," of the particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," tell you which ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreters")," are predefined for that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool"),", and what the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," is that a customized ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," may use."),(0,i.kt)("admonition",{title:"Editor's note",type:"info"},(0,i.kt)("p",{parentName:"admonition"},"We could perhaps add references to appropriate sections of relevant tools, so that readers can see examples of this.")),(0,i.kt)("p",null,"The generic workings of interpreters is documented in the ",(0,i.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"TEv2 Text Conversion pattern"),"."))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7711],{3905:(e,t,r)=>{r.d(t,{Zo:()=>l,kt:()=>h});var o=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function n(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var s=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=o.createContext({}),p=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):n(n({},t),e)),r},l=function(e){var t=p(e.components);return o.createElement(c.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},u=o.forwardRef((function(e,t){var r=e.components,i=e.mdxType,s=e.originalType,c=e.parentName,l=a(e,["components","mdxType","originalType","parentName"]),u=p(r),h=i,d=u["".concat(c,".").concat(h)]||u[h]||f[h]||s;return r?o.createElement(d,n(n({ref:t},l),{},{components:r})):o.createElement(d,n({ref:t},l))}));function h(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var s=r.length,n=new Array(s);n[0]=u;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,n[1]=a;for(var p=2;p{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>f,frontMatter:()=>s,metadata:()=>a,toc:()=>p});var o=r(3117),i=(r(7294),r(3905));const s={id:"interpreter",displayed_sidebar:"tev2SideBar",term:"interpreter",termType:"concept",isa:null,glossaryTerm:"Interpreter",glossaryText:"a [regex](@) that is used to locate a particular text construct (such as a [TermRef](@) or [MRGRef](@)) in a text, and that populates [named capturing groups](@) as specified in the [interpreter profile](@) of the particular [text conversion tool](@) for which it is designed.",grouptags:[],formPhrases:["interpreter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Interpreter",a={unversionedId:"terms/interpreter",id:"terms/interpreter",title:"Interpreter",description:"An interpreter is a regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates named capturing groups as specified in the interpreter profile of the particular text conversion tool for which it is designed.",source:"@site/docs/terms/interpreter.md",sourceDirName:"terms",slug:"/terms/interpreter",permalink:"/tev2-specifications/docs/terms/interpreter",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/interpreter.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"interpreter",displayed_sidebar:"tev2SideBar",term:"interpreter",termType:"concept",isa:null,glossaryTerm:"Interpreter",glossaryText:"a [regex](@) that is used to locate a particular text construct (such as a [TermRef](@) or [MRGRef](@)) in a text, and that populates [named capturing groups](@) as specified in the [interpreter profile](@) of the particular [text conversion tool](@) for which it is designed.",grouptags:[],formPhrases:["interpreter{ss}"],status:"proposed",created:20230731,updated:20240108,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},p=[],l={toc:p};function f(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,o.Z)({},l,r,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"interpreter"},"Interpreter"),(0,i.kt)("p",null,"An ",(0,i.kt)("strong",{parentName:"p"},"interpreter")," is a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/regex",title:"Regular Expression: a sequence of characters that specifies a text pattern that can be searched for within other, larger texts, for the purpose of, e.g., replacing the text pattern with some other text."},"regex")," that is used to locate a particular text construct (such as a ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," or ",(0,i.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef"),") in a text, and that populates ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/named-capturing-group",title:"Named Capturing Group: a sub-pattern within a Regex (called a 'Capturing Group') that has been given a name, allowing one to refer to that sub-pattern."},"named capturing groups")," as specified in the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," of the particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"text conversion tool")," for which it is designed."),(0,i.kt)("p",null,"The ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-toolbox",title:"TEv2 Toolbox: the collection of tools designed to support and facilitate the process of terminology management following the TEv2 Specifications."},"specifications")," of the particular ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool")," tell you which ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreters")," are predefined for that ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-text-conversion-tool",title:"TEv2 Text Conversion Tool: a TEv2 Tool whose purpose is to convert particular text constructs (such as TermRefs or MRGRefs) that exist in one or more files with other texts, the contents of which consists of some fixed construct that is populated with elements derived from existing text constructs and/or other resources."},"tool"),", and what the ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter-profile",title:"Interpreter Profile: the set of Named Capturing Groups that are an Interpreter is expected to populate when it is used in the context of a specific TEv2 Tool (such as the TRRT or HRGT)."},"interpreter profile")," is that a customized ",(0,i.kt)("a",{href:"/tev2-specifications/docs/terms/interpreter",title:"Interpreter: a Regex that is used to locate a particular text construct (such as a TermRef or MRGRef) in a text, and that populates Named Capturing Groups as specified in the Interpreter Profile of the particular Text Conversion Tool for which it is designed."},"interpreter")," may use."),(0,i.kt)("admonition",{title:"Editor's note",type:"info"},(0,i.kt)("p",{parentName:"admonition"},"We could perhaps add references to appropriate sections of relevant tools, so that readers can see examples of this.")),(0,i.kt)("p",null,"The generic workings of interpreters is documented in the ",(0,i.kt)("a",{parentName:"p",href:"/docs/overview/tev2-text-conversion"},"TEv2 Text Conversion pattern"),"."))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8c68bf8b.104b7f46.js b/assets/js/8c68bf8b.067b2d64.js similarity index 99% rename from assets/js/8c68bf8b.104b7f46.js rename to assets/js/8c68bf8b.067b2d64.js index 4a59a8910..c74b7a7d9 100644 --- a/assets/js/8c68bf8b.104b7f46.js +++ b/assets/js/8c68bf8b.067b2d64.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7552],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>f});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=i.createContext({}),c=function(e){var t=i.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=c(e.components);return i.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=c(a),f=n,u=h["".concat(l,".").concat(f)]||h[f]||p[f]||r;return a?i.createElement(u,o(o({ref:t},d),{},{components:a})):i.createElement(u,o({ref:t},d))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var c=2;c{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),l=a(1980),c=a(7392),d=a(12);function p(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??p(a);return function(e){const t=(0,c.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function f(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function u(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,l._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function m(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!f({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[l,c]=u({queryString:a,groupId:i}),[p,m]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),k=(()=>{const e=l??p;return f({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{k&&s(k)}),[k]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!f({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),c(e),m(e)}),[c,m,r]),tabValues:r}}var k=a(2389);const y="tabList__CuJ",b="tabItem_LNqP";function g(e){let{className:t,block:a,selectedValue:s,selectValue:l,tabValues:c}=e;const d=[],{blockElementScrollPositionUntilNextRender:p}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=c[a].value;i!==s&&(p(t),l(i))},f=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},c.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:f,onClick:h},o,{className:(0,r.Z)("tabs__item",b,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function v(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function w(e){const t=m(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(g,(0,i.Z)({},e,t)),n.createElement(v,(0,i.Z)({},e,t)))}function T(e){const t=(0,k.Z)();return n.createElement(w,(0,i.Z)({key:String(t)},e))}},9050:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>l,default:()=>f,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var i=a(3117),n=(a(7294),a(3905)),r=(a(4996),a(4866)),o=a(5162);const s={id:"term-refs",sidebar_label:"Term References (TermRefs)",date:20220303},l="TermRefs - Syntax",c={unversionedId:"specs/syntax/term-refs",id:"specs/syntax/term-refs",title:"TermRefs - Syntax",description:"As an author or curator, you want to be able to mark words or phrases and have them refer to (the documentation of) a particular concept or other semantic unit. Such marked-up words or phrases are called TermRefs.",source:"@site/docs/specs/syntax/10-term-refs.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/term-refs",permalink:"/tev2-specifications/docs/specs/syntax/term-refs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/10-term-refs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:10,frontMatter:{id:"term-refs",sidebar_label:"Term References (TermRefs)",date:20220303},sidebar:"tev2SideBar",previous:{title:"Specifications - Syntax",permalink:"/tev2-specifications/docs/categories/specs-syntax"},next:{title:"Term Identifiers",permalink:"/tev2-specifications/docs/specs/syntax/term-identifiers"}},d={},p=[{value:"Default TermRef Syntax",id:"default",level:2},{value:"Examples",id:"examples",level:3},{value:"Motivation for the chosen syntax",id:"motivation-for-the-chosen-syntax",level:3},{value:"Alternative TermRef Syntax",id:"alt",level:2},{value:"Customizing TermRef Syntax (#customize)",id:"customizing-termref-syntax-customize",level:2}],h={toc:p};function f(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"termrefs---syntax"},"TermRefs - Syntax"),(0,n.kt)("p",null,"As an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),", you want to be able to mark words or phrases and have them refer to (the documentation of) a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Such marked-up words or phrases are called ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," can be converted (by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),") into so-called ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs"),", which are texts that are being rendered in a way that helps readers better understand the words/phrases that you marked up. For example, when the document you authored is used in a website, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," could be rendered en an emphasized way, and have a popup balloon that has its definition when a reader hovers its mouse over it.",(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#term-ref-resolution",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT specifications")," specify"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"how ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," are converted;"),(0,n.kt)("li",{parentName:"ul"},"how you can customize the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," syntax to your needs;"),(0,n.kt)("li",{parentName:"ul"},"how you can customize the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs")," to look like what you want.")),(0,n.kt)("p",null,"The following tabs-table tells you which syntaxes are predefined:"),(0,n.kt)(r.Z,{defaultValue:"default",values:[{label:"`default` TermRef syntax",value:"default"},{label:"`alternative` TermRef syntax",value:"alternative"}],mdxType:"Tabs"},(0,n.kt)(o.Z,{value:"default",mdxType:"TabItem"},(0,n.kt)("h2",{id:"default"},"Default TermRef Syntax"),(0,n.kt)("p",null,"By default a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," can be thought of as a special kind of ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown link"),". It link-part does not contain a URL or fragment, but contains text that refers to (a specific trait of) a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", as defined in a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,n.kt)("p",null,"The most general form of the default syntax is:"),(0,n.kt)("p",null,"["," ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," ","]","( ",(0,n.kt)("inlineCode",{parentName:"p"},"termType"),":",(0,n.kt)("inlineCode",{parentName:"p"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"p"},"trait"),"@",(0,n.kt)("inlineCode",{parentName:"p"},"terminology-identifier")," )"),(0,n.kt)("p",null,"where: "),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"show text")," (required) is the text that will be highlighted/emphasized to indicate it is linked. It must not contain the characters ",(0,n.kt)("inlineCode",{parentName:"li"},"@")," or ",(0,n.kt)("inlineCode",{parentName:"li"},"]")," (this is needed to distinguish ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," from regular ",(0,n.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/#links"},"markdown links"),")."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"termType")," (optional) is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"term type"),". When not specified, it is given the default type for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", which usually would be ",(0,n.kt)("inlineCode",{parentName:"li"},"concept"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"term")," (optional) is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". If not specified, its value is constructed based on the value of ",(0,n.kt)("inlineCode",{parentName:"li"},"showtext"),", as specified in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#id",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"trait")," (optional) refers to a particular characteristic of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". If specified, it must be the ",(0,n.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/extended-syntax/#heading-ids"},"heading id")," of the section in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that describes the characteristic. If not specified it refers to the whole of (the documentation of) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"terminology-identifier")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier"),". If not specified, its value is taken to be the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("h3",{id:"examples"},"Examples"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"vanaf hier tekst reviseren.\nMerk op dat de conversie spullen naar de TRRT specs moeten verhuizen!")),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"[TermRef Examples](term-ref#example)")," ")),(0,n.kt)("p",null,"This ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," refers to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is identified by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," ",(0,n.kt)("inlineCode",{parentName:"p"},":@"),". When all optional fields are specified, this "),(0,n.kt)("p",null,"The par"),(0,n.kt)("p",null," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," in which ",(0,n.kt)("inlineCode",{parentName:"p"},"termid")," identifies a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,n.kt)("p",null,"Here is an example of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),": ",(0,n.kt)("inlineCode",{parentName:"p"},"[definitions](definition@)"),". When this text is rendered into a human readable form, it will show the text ",(0,n.kt)("inlineCode",{parentName:"p"},"definitions")," (plural) enhanced, and it will link to the text that describes (or defines) the term ",(0,n.kt)("inlineCode",{parentName:"p"},"definition")," (singular). If you would want to use this term as it is defined in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," called ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab"),", you could do that by writing ",(0,n.kt)("inlineCode",{parentName:"p"},"[definitions](definition@essif-lab)")," (provided that ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab")," is a defined ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," within the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that you operate in)."),(0,n.kt)("h3",{id:"motivation-for-the-chosen-syntax"},"Motivation for the chosen syntax"),(0,n.kt)("p",null,"We want to enable ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," to use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," pervasively, which means it must be easy to use, and mistakes should be (relatively) hard to make, yet easy to detect, identify, and correct. ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown links")," are of the form ","[",(0,n.kt)("inlineCode",{parentName:"p"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"p"},"ref-text"),"), where ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," is the text that is rendered and emphasized so that a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader")," knows it can be clicked, and ",(0,n.kt)("inlineCode",{parentName:"p"},"ref-text")," is a (relative or absolute) URL, or a ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/extended-syntax/#linking-to-heading-ids"},"heading ID"),", that identifies the resource (e.g. web page, or place therein) that is being referenced. So, we need a syntax for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that is",(0,n.kt)("br",null),"- sufficiently similar to a ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown link"),",",(0,n.kt)("br",null),"- 'humanly interpretable' when it isn't processed by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),",",(0,n.kt)("br",null),"- easy to use for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors"),", and",(0,n.kt)("br",null),"- sufficiently distinct from a Markdown link so that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," will not process Markdown links yet will process the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,n.kt)(o.Z,{value:"alternative",mdxType:"TabItem"},(0,n.kt)("h2",{id:"alt"},"Alternative TermRef Syntax"),(0,n.kt)("p",null,"It is convenient for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," to be able to use the '@",(0,n.kt)("inlineCode",{parentName:"p"},"scopetag"),"' part of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," immediately behind the ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," within the square brackets (",(0,n.kt)("inlineCode",{parentName:"p"},"[")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"]"),"), and leave out the parentheses and the text in between if all the other items are omitted."),(0,n.kt)("p",null,"This is particularly useful in the vast majority of cases, where the default processing of ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," results in ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"trait")," is absent. Examples of this are ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)"),", or ",(0,n.kt)("inlineCode",{parentName:"p"},"[TermRef](@)"),"."),(0,n.kt)("p",null,"The usefulness becomes even greater as the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," also implements more sophisticated ways to derive a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," from a ",(0,n.kt)("inlineCode",{parentName:"p"},"show text"),", e.g. to accommodate for plural forms (of nouns), or conjugate forms (for verbs)."),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This alternative notation will assume that the ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," part of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," won't contain the ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," character. However, it is likely that some ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," will want to use an email address as the ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," part of a ",(0,n.kt)("em",{parentName:"p"},"regular")," link, e.g. as in ",(0,n.kt)("inlineCode",{parentName:"p"},"[rieks.joosten@tno.nl](mailto:rieks.joosten@tno.nl)"),". However, since ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," should not contain ",(0,n.kt)("inlineCode",{parentName:"p"},"."),"-characters, ",(0,n.kt)("inlineCode",{parentName:"p"},"[rieks.joosten@tno.nl]")," does not qualify as a ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," in our syntax. ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"Authors")," should ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#urls-and-email-addresses"},"use angle brackets to link to email addresses"),", as in ",(0,n.kt)("inlineCode",{parentName:"p"},""),".")),(0,n.kt)("p",null,"This leads to an alternative notation that can be used in addition to the previously specified notation. Here is the alternative syntax and its equivalent counterpart:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"center"},"Alternative syntax"),(0,n.kt)("th",{parentName:"tr",align:"center"},"Equivalent regular syntax"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@","]"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(@)")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),"]"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"showtext"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),")")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),":",(0,n.kt)("inlineCode",{parentName:"td"},"vsntag"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"td"},"trait"),")"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"td"},"trait"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),":",(0,n.kt)("inlineCode",{parentName:"td"},"vsntag"),")")))),(0,n.kt)("p",null,"In the last row of the above table, ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"#trait")," are optional. Thus, ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition@]()")," is equivalent with ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)")," and with ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)"),"."))),(0,n.kt)("h2",{id:"customizing-termref-syntax-customize"},"Customizing TermRef Syntax (#customize)"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"this section needs to be written.")))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7552],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>f});var i=a(7294);function n(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,i)}return a}function o(e){for(var t=1;t=0||(n[a]=e[a]);return n}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(n[a]=e[a])}return n}var l=i.createContext({}),c=function(e){var t=i.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=c(e.components);return i.createElement(l.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},h=i.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),h=c(a),f=n,u=h["".concat(l,".").concat(f)]||h[f]||p[f]||r;return a?i.createElement(u,o(o({ref:t},d),{},{components:a})):i.createElement(u,o({ref:t},d))}));function f(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,o=new Array(r);o[0]=h;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:n,o[1]=s;for(var c=2;c{a.d(t,{Z:()=>o});var i=a(7294),n=a(6010);const r="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return i.createElement("div",{role:"tabpanel",className:(0,n.Z)(r,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>T});var i=a(3117),n=a(7294),r=a(6010),o=a(2466),s=a(6775),l=a(1980),c=a(7392),d=a(12);function p(e){return function(e){return n.Children.map(e,(e=>{if(!e||(0,n.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:i,default:n}}=e;return{value:t,label:a,attributes:i,default:n}}))}function h(e){const{values:t,children:a}=e;return(0,n.useMemo)((()=>{const e=t??p(a);return function(e){const t=(0,c.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function f(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function u(e){let{queryString:t=!1,groupId:a}=e;const i=(0,s.k6)(),r=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,l._X)(r),(0,n.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(i.location.search);t.set(r,e),i.replace({...i.location,search:t.toString()})}),[r,i])]}function m(e){const{defaultValue:t,queryString:a=!1,groupId:i}=e,r=h(e),[o,s]=(0,n.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!f({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const i=a.find((e=>e.default))??a[0];if(!i)throw new Error("Unexpected error: 0 tabValues");return i.value}({defaultValue:t,tabValues:r}))),[l,c]=u({queryString:a,groupId:i}),[p,m]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[i,r]=(0,d.Nk)(a);return[i,(0,n.useCallback)((e=>{a&&r.set(e)}),[a,r])]}({groupId:i}),k=(()=>{const e=l??p;return f({value:e,tabValues:r})?e:null})();(0,n.useLayoutEffect)((()=>{k&&s(k)}),[k]);return{selectedValue:o,selectValue:(0,n.useCallback)((e=>{if(!f({value:e,tabValues:r}))throw new Error(`Can't select invalid tab value=${e}`);s(e),c(e),m(e)}),[c,m,r]),tabValues:r}}var k=a(2389);const y="tabList__CuJ",b="tabItem_LNqP";function g(e){let{className:t,block:a,selectedValue:s,selectValue:l,tabValues:c}=e;const d=[],{blockElementScrollPositionUntilNextRender:p}=(0,o.o5)(),h=e=>{const t=e.currentTarget,a=d.indexOf(t),i=c[a].value;i!==s&&(p(t),l(i))},f=e=>{let t=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return n.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.Z)("tabs",{"tabs--block":a},t)},c.map((e=>{let{value:t,label:a,attributes:o}=e;return n.createElement("li",(0,i.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:f,onClick:h},o,{className:(0,r.Z)("tabs__item",b,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function v(e){let{lazy:t,children:a,selectedValue:i}=e;const r=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=r.find((e=>e.props.value===i));return e?(0,n.cloneElement)(e,{className:"margin-top--md"}):null}return n.createElement("div",{className:"margin-top--md"},r.map(((e,t)=>(0,n.cloneElement)(e,{key:t,hidden:e.props.value!==i}))))}function w(e){const t=m(e);return n.createElement("div",{className:(0,r.Z)("tabs-container",y)},n.createElement(g,(0,i.Z)({},e,t)),n.createElement(v,(0,i.Z)({},e,t)))}function T(e){const t=(0,k.Z)();return n.createElement(w,(0,i.Z)({key:String(t)},e))}},9050:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>l,default:()=>f,frontMatter:()=>s,metadata:()=>c,toc:()=>p});var i=a(3117),n=(a(7294),a(3905)),r=(a(4996),a(4866)),o=a(5162);const s={id:"term-refs",sidebar_label:"Term References (TermRefs)",date:20220303},l="TermRefs - Syntax",c={unversionedId:"specs/syntax/term-refs",id:"specs/syntax/term-refs",title:"TermRefs - Syntax",description:"As an author or curator, you want to be able to mark words or phrases and have them refer to (the documentation of) a particular concept or other semantic unit. Such marked-up words or phrases are called TermRefs.",source:"@site/docs/specs/syntax/10-term-refs.md",sourceDirName:"specs/syntax",slug:"/specs/syntax/term-refs",permalink:"/tev2-specifications/docs/specs/syntax/term-refs",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/syntax/10-term-refs.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:10,frontMatter:{id:"term-refs",sidebar_label:"Term References (TermRefs)",date:20220303},sidebar:"tev2SideBar",previous:{title:"Specifications - Syntax",permalink:"/tev2-specifications/docs/categories/specs-syntax"},next:{title:"Term Identifiers",permalink:"/tev2-specifications/docs/specs/syntax/term-identifiers"}},d={},p=[{value:"Default TermRef Syntax",id:"default",level:2},{value:"Examples",id:"examples",level:3},{value:"Motivation for the chosen syntax",id:"motivation-for-the-chosen-syntax",level:3},{value:"Alternative TermRef Syntax",id:"alt",level:2},{value:"Customizing TermRef Syntax (#customize)",id:"customizing-termref-syntax-customize",level:2}],h={toc:p};function f(e){let{components:t,...a}=e;return(0,n.kt)("wrapper",(0,i.Z)({},h,a,{components:t,mdxType:"MDXLayout"}),(0,n.kt)("h1",{id:"termrefs---syntax"},"TermRefs - Syntax"),(0,n.kt)("p",null,"As an ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"author")," or ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),", you want to be able to mark words or phrases and have them refer to (the documentation of) a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". Such marked-up words or phrases are called ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),"."),(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," can be converted (by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),") into so-called ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs"),", which are texts that are being rendered in a way that helps readers better understand the words/phrases that you marked up. For example, when the document you authored is used in a website, the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," could be rendered en an emphasized way, and have a popup balloon that has its definition when a reader hovers its mouse over it.",(0,n.kt)("p",null,"The ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#term-ref-resolution",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT specifications")," specify"),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},"how ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," are converted;"),(0,n.kt)("li",{parentName:"ul"},"how you can customize the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," syntax to your needs;"),(0,n.kt)("li",{parentName:"ul"},"how you can customize the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/renderable-ref",title:"Renderable Ref: a text with which the TRRT replaces a TermRef, that can be processed by specific third party rendering tools, the result of which is a rendering of the original TermRef that has additional characteristics that help Readers to (better) understand the intention of its Author."},"renderable refs")," to look like what you want.")),(0,n.kt)("p",null,"The following tabs-table tells you which syntaxes are predefined:"),(0,n.kt)(r.Z,{defaultValue:"default",values:[{label:"`default` TermRef syntax",value:"default"},{label:"`alternative` TermRef syntax",value:"alternative"}],mdxType:"Tabs"},(0,n.kt)(o.Z,{value:"default",mdxType:"TabItem"},(0,n.kt)("h2",{id:"default"},"Default TermRef Syntax"),(0,n.kt)("p",null,"By default a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," can be thought of as a special kind of ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown link"),". It link-part does not contain a URL or fragment, but contains text that refers to (a specific trait of) a specific ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or other ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),", as defined in a particular ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology"),"."),(0,n.kt)("p",null,"The most general form of the default syntax is:"),(0,n.kt)("p",null,"["," ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," ","]","( ",(0,n.kt)("inlineCode",{parentName:"p"},"termType"),":",(0,n.kt)("inlineCode",{parentName:"p"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"p"},"trait"),"@",(0,n.kt)("inlineCode",{parentName:"p"},"terminology-identifier")," )"),(0,n.kt)("p",null,"where: "),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"show text")," (required) is the text that will be highlighted/emphasized to indicate it is linked. It must not contain the characters ",(0,n.kt)("inlineCode",{parentName:"li"},"@")," or ",(0,n.kt)("inlineCode",{parentName:"li"},"]")," (this is needed to distinguish ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," from regular ",(0,n.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/basic-syntax/#links"},"markdown links"),")."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"termType")," (optional) is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-type",title:"Term Type: a Text that identifies a particular *kind* of Semantic Unit within a particular Scope. Examples include `concept`, `relation`, `pattern` (or `mental-model`)."},"term type"),". When not specified, it is given the default type for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),", which usually would be ",(0,n.kt)("inlineCode",{parentName:"li"},"concept"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"term")," (optional) is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term"),". If not specified, its value is constructed based on the value of ",(0,n.kt)("inlineCode",{parentName:"li"},"showtext"),", as specified in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt#id",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"trait")," (optional) refers to a particular characteristic of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),". If specified, it must be the ",(0,n.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/extended-syntax/#heading-ids"},"heading id")," of the section in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/body",title:"Body (of a Curated Text): the part of a Curated Text that contains arbitrarily structured documentation about the Semantic Unit that the Curated Text documents."},"body")," of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text")," that describes the characteristic. If not specified it refers to the whole of (the documentation of) the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"terminology-identifier")," is a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/terminology-identifiers",title:"Terminology Identifier: a Text, of the form `:`, that identifies a Terminology from within a particular Scope, and can also be used to find the MRG file (in the Glossarydir of that same Scope) that contains Entries for every Term contained in that Terminology."},"terminology identifier"),". If not specified, its value is taken to be the default ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," of the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/current-scope",title:"Current Scope: the Scope that is the context within which a Curator is acting, or a tool is being called."},"current scope"),".")),(0,n.kt)("h3",{id:"examples"},"Examples"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"vanaf hier tekst reviseren.\nMerk op dat de conversie spullen naar de TRRT specs moeten verhuizen!")),(0,n.kt)("ul",null,(0,n.kt)("li",{parentName:"ul"},(0,n.kt)("inlineCode",{parentName:"li"},"[TermRef Examples](term-ref#example)")," ")),(0,n.kt)("p",null,"This ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," refers to the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit")," that is identified by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/term-identifiers",title:"Term Identifier: a Text, of the form `@`, that is used for identifying a Semantic Unit within a designated Terminology."},"term identifier")," ",(0,n.kt)("inlineCode",{parentName:"p"},":@"),". When all optional fields are specified, this "),(0,n.kt)("p",null,"The par"),(0,n.kt)("p",null," that identifies the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/terminology",title:"Terminology: a set of Terms that are used within a single Scope to refer to Concepts and other Semantic Units of a single Party (e.g. a Community), enabling Parties to reason and communicate ideas they have about one or more specific topics."},"terminology")," in which ",(0,n.kt)("inlineCode",{parentName:"p"},"termid")," identifies a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic unit"),"."),(0,n.kt)("p",null,"Here is an example of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef"),": ",(0,n.kt)("inlineCode",{parentName:"p"},"[definitions](definition@)"),". When this text is rendered into a human readable form, it will show the text ",(0,n.kt)("inlineCode",{parentName:"p"},"definitions")," (plural) enhanced, and it will link to the text that describes (or defines) the term ",(0,n.kt)("inlineCode",{parentName:"p"},"definition")," (singular). If you would want to use this term as it is defined in the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," called ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab"),", you could do that by writing ",(0,n.kt)("inlineCode",{parentName:"p"},"[definitions](definition@essif-lab)")," (provided that ",(0,n.kt)("inlineCode",{parentName:"p"},"essif-lab")," is a defined ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetag")," within the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scope")," that you operate in)."),(0,n.kt)("h3",{id:"motivation-for-the-chosen-syntax"},"Motivation for the chosen syntax"),(0,n.kt)("p",null,"We want to enable ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," to use ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," pervasively, which means it must be easy to use, and mistakes should be (relatively) hard to make, yet easy to detect, identify, and correct. ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown links")," are of the form ","[",(0,n.kt)("inlineCode",{parentName:"p"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"p"},"ref-text"),"), where ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," is the text that is rendered and emphasized so that a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/reader",title:"Reader: a person that reads a text that is authored by another person (its Author), and that tries to understand the meaning of this text in the way its Author intended."},"reader")," knows it can be clicked, and ",(0,n.kt)("inlineCode",{parentName:"p"},"ref-text")," is a (relative or absolute) URL, or a ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/extended-syntax/#linking-to-heading-ids"},"heading ID"),", that identifies the resource (e.g. web page, or place therein) that is being referenced. So, we need a syntax for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs")," that is",(0,n.kt)("br",null),"- sufficiently similar to a ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#links"},"Markdown link"),",",(0,n.kt)("br",null),"- 'humanly interpretable' when it isn't processed by the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT"),",",(0,n.kt)("br",null),"- easy to use for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors"),", and",(0,n.kt)("br",null),"- sufficiently distinct from a Markdown link so that the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," will not process Markdown links yet will process the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRefs"),".")),(0,n.kt)(o.Z,{value:"alternative",mdxType:"TabItem"},(0,n.kt)("h2",{id:"alt"},"Alternative TermRef Syntax"),(0,n.kt)("p",null,"It is convenient for ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," to be able to use the '@",(0,n.kt)("inlineCode",{parentName:"p"},"scopetag"),"' part of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," immediately behind the ",(0,n.kt)("inlineCode",{parentName:"p"},"show text")," within the square brackets (",(0,n.kt)("inlineCode",{parentName:"p"},"[")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"]"),"), and leave out the parentheses and the text in between if all the other items are omitted."),(0,n.kt)("p",null,"This is particularly useful in the vast majority of cases, where the default processing of ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," results in ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"trait")," is absent. Examples of this are ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)"),", or ",(0,n.kt)("inlineCode",{parentName:"p"},"[TermRef](@)"),"."),(0,n.kt)("p",null,"The usefulness becomes even greater as the ",(0,n.kt)("a",{href:"/tev2-specifications/docs/specs/tools/trrt",title:"TermRef Rendering Tool: a TEv2 Tool that is designed to facilitate the visualization and rendering of TermRefs."},"TRRT")," also implements more sophisticated ways to derive a ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," from a ",(0,n.kt)("inlineCode",{parentName:"p"},"show text"),", e.g. to accommodate for plural forms (of nouns), or conjugate forms (for verbs)."),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"This alternative notation will assume that the ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," part of a ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/term-ref",title:"TermRef: a word or phrase that is Marked Up (in A Specific Way) so that it refers to a particular Concept (or other Semantic Unit), enabling it to be rendered in a variety of ways for the purpose of helping Readers to (better) understand the intention of its Author."},"TermRef")," won't contain the ",(0,n.kt)("inlineCode",{parentName:"p"},"@")," character. However, it is likely that some ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"authors")," will want to use an email address as the ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," part of a ",(0,n.kt)("em",{parentName:"p"},"regular")," link, e.g. as in ",(0,n.kt)("inlineCode",{parentName:"p"},"[rieks.joosten@tno.nl](mailto:rieks.joosten@tno.nl)"),". However, since ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/scopetag",title:"Scopetag: a Tag that is used to identify Scopes from within a specific Scope"},"scopetags")," should not contain ",(0,n.kt)("inlineCode",{parentName:"p"},"."),"-characters, ",(0,n.kt)("inlineCode",{parentName:"p"},"[rieks.joosten@tno.nl]")," does not qualify as a ",(0,n.kt)("inlineCode",{parentName:"p"},"showtext")," in our syntax. ",(0,n.kt)("a",{href:"/tev2-specifications/docs/terms/author",title:"Author: a person that creates a text that is meant to be read and understood by others - usually, a particular audience."},"Authors")," should ",(0,n.kt)("a",{parentName:"p",href:"https://www.markdownguide.org/basic-syntax/#urls-and-email-addresses"},"use angle brackets to link to email addresses"),", as in ",(0,n.kt)("inlineCode",{parentName:"p"},""),".")),(0,n.kt)("p",null,"This leads to an alternative notation that can be used in addition to the previously specified notation. Here is the alternative syntax and its equivalent counterpart:"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"center"},"Alternative syntax"),(0,n.kt)("th",{parentName:"tr",align:"center"},"Equivalent regular syntax"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@","]"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(@)")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),"]"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"showtext"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),")")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),":",(0,n.kt)("inlineCode",{parentName:"td"},"vsntag"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"td"},"trait"),")"),(0,n.kt)("td",{parentName:"tr",align:"center"},"[",(0,n.kt)("inlineCode",{parentName:"td"},"show text"),"]","(",(0,n.kt)("inlineCode",{parentName:"td"},"term"),"#",(0,n.kt)("inlineCode",{parentName:"td"},"trait"),"@",(0,n.kt)("inlineCode",{parentName:"td"},"scopetag"),":",(0,n.kt)("inlineCode",{parentName:"td"},"vsntag"),")")))),(0,n.kt)("p",null,"In the last row of the above table, ",(0,n.kt)("inlineCode",{parentName:"p"},"term")," and ",(0,n.kt)("inlineCode",{parentName:"p"},"#trait")," are optional. Thus, ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition@]()")," is equivalent with ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)")," and with ",(0,n.kt)("inlineCode",{parentName:"p"},"[definition](@)"),"."))),(0,n.kt)("h2",{id:"customizing-termref-syntax-customize"},"Customizing TermRef Syntax (#customize)"),(0,n.kt)("admonition",{title:"Editor's note",type:"info"},(0,n.kt)("p",{parentName:"admonition"},"this section needs to be written.")))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8cadb544.09fa420b.js b/assets/js/8cadb544.e62ba719.js similarity index 98% rename from assets/js/8cadb544.09fa420b.js rename to assets/js/8cadb544.e62ba719.js index dd8d11192..6c4b67d52 100644 --- a/assets/js/8cadb544.09fa420b.js +++ b/assets/js/8cadb544.e62ba719.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2879],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>u});var r=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,r)}return i}function n(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=r.createContext({}),l=function(e){var t=r.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(i),u=a,h=m["".concat(c,".").concat(u)]||m[u]||d[u]||o;return i?r.createElement(h,n(n({ref:t},p),{},{components:i})):r.createElement(h,n({ref:t},p))}));function u(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,n=new Array(o);n[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,n[1]=s;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>o,metadata:()=>s,toc:()=>l});var r=i(3117),a=(i(7294),i(3905));const o={id:"dictionary",displayed_sidebar:"tev2SideBar",term:"dictionary",termType:"concept",isa:null,glossaryTerm:"Dictionary",glossaryText:"an alphabetically sorted list of [terms](@) with various meanings that they may have in different contexts.",grouptags:[],formPhrases:["dictionar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Dictionary",s={unversionedId:"terms/dictionary",id:"terms/dictionary",title:"Dictionary",description:"Summary",source:"@site/docs/terms/dictionary.md",sourceDirName:"terms",slug:"/terms/dictionary",permalink:"/tev2-specifications/docs/terms/dictionary",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/dictionary.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"dictionary",displayed_sidebar:"tev2SideBar",term:"dictionary",termType:"concept",isa:null,glossaryTerm:"Dictionary",glossaryText:"an alphabetically sorted list of [terms](@) with various meanings that they may have in different contexts.",grouptags:[],formPhrases:["dictionar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3}],p={toc:l};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,r.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"dictionary"},"Dictionary"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A Dictionary is an alphabetically sorted list of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with explanations. Each term may have multiple such explanations, which come from different ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes/contexts"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," fits in with related ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,a.kt)("h3",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"A dictionary helps people to get introduced in the domain for which the dictionary is created. Usually, this is a larger domain e.g. of some language, or about computer security."),(0,a.kt)("h3",{id:"criteria"},"Criteria"),(0,a.kt)("p",null,"an alphabetical list of words or phrases with possibly multiple, short explanations, that exists for the purpose of helping people to find out what a word may mean in various ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes/contexts"),"."),(0,a.kt)("h3",{id:"examples"},"Examples"),(0,a.kt)("p",null,"Examples include the ",(0,a.kt)("a",{parentName:"p",href:"https://csrc.nist.gov/glossary"},"NIST Computer Security Resource Center"),", ",(0,a.kt)("a",{parentName:"p",href:"https://www.merriam-webster.com/dictionary/"},"Merriam-Webster"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2879],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>u});var r=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,r)}return i}function n(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=r.createContext({}),l=function(e){var t=r.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):n(n({},t),e)),i},p=function(e){var t=l(e.components);return r.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),m=l(i),u=a,h=m["".concat(c,".").concat(u)]||m[u]||d[u]||o;return i?r.createElement(h,n(n({ref:t},p),{},{components:i})):r.createElement(h,n({ref:t},p))}));function u(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,n=new Array(o);n[0]=m;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:a,n[1]=s;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>n,default:()=>d,frontMatter:()=>o,metadata:()=>s,toc:()=>l});var r=i(3117),a=(i(7294),i(3905));const o={id:"dictionary",displayed_sidebar:"tev2SideBar",term:"dictionary",termType:"concept",isa:null,glossaryTerm:"Dictionary",glossaryText:"an alphabetically sorted list of [terms](@) with various meanings that they may have in different contexts.",grouptags:[],formPhrases:["dictionar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},n="Dictionary",s={unversionedId:"terms/dictionary",id:"terms/dictionary",title:"Dictionary",description:"Summary",source:"@site/docs/terms/dictionary.md",sourceDirName:"terms",slug:"/terms/dictionary",permalink:"/tev2-specifications/docs/terms/dictionary",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/dictionary.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"dictionary",displayed_sidebar:"tev2SideBar",term:"dictionary",termType:"concept",isa:null,glossaryTerm:"Dictionary",glossaryText:"an alphabetically sorted list of [terms](@) with various meanings that they may have in different contexts.",grouptags:[],formPhrases:["dictionar{yies}"],status:"proposed",created:20220606,updated:20220606,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Purpose",id:"purpose",level:3},{value:"Criteria",id:"criteria",level:3},{value:"Examples",id:"examples",level:3}],p={toc:l};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,r.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"dictionary"},"Dictionary"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A Dictionary is an alphabetically sorted list of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," with explanations. Each term may have multiple such explanations, which come from different ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes/contexts"),"."),(0,a.kt)("p",null,"The ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/patterns/terminology",title:"Terminology Pattern: a Mental Model that describes the relations between a Community, its (intangible) Knowledge, and the artifacts we use to document that Knowledge, such as Terms, Definitions, Mental Models, Glossaries, etc."},"terminology pattern")," provides an overview of how this ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," fits in with related ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),"."),(0,a.kt)("h3",{id:"purpose"},"Purpose"),(0,a.kt)("p",null,"A dictionary helps people to get introduced in the domain for which the dictionary is created. Usually, this is a larger domain e.g. of some language, or about computer security."),(0,a.kt)("h3",{id:"criteria"},"Criteria"),(0,a.kt)("p",null,"an alphabetical list of words or phrases with possibly multiple, short explanations, that exists for the purpose of helping people to find out what a word may mean in various ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/scope",title:"Scope: the extent of the Terms, Definitions and other documentation that a Community (or Party, which we call the Owner of the Scope) needs to express, communicate and validate its Knowledge as relevant to achieving a specific subset of its Objectives."},"scopes/contexts"),"."),(0,a.kt)("h3",{id:"examples"},"Examples"),(0,a.kt)("p",null,"Examples include the ",(0,a.kt)("a",{parentName:"p",href:"https://csrc.nist.gov/glossary"},"NIST Computer Security Resource Center"),", ",(0,a.kt)("a",{parentName:"p",href:"https://www.merriam-webster.com/dictionary/"},"Merriam-Webster"),"."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8d01272a.40311105.js b/assets/js/8d01272a.fa642db6.js similarity index 98% rename from assets/js/8d01272a.40311105.js rename to assets/js/8d01272a.fa642db6.js index 83a509727..f5d9677c8 100644 --- a/assets/js/8d01272a.40311105.js +++ b/assets/js/8d01272a.fa642db6.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2712],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>y});var o=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function s(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=o.createContext({}),l=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},d=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},f=o.forwardRef((function(e,t){var r=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),f=l(r),y=i,u=f["".concat(c,".").concat(y)]||f[y]||p[y]||n;return r?o.createElement(u,s(s({ref:t},d),{},{components:r})):o.createElement(u,s({ref:t},d))}));function y(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=r.length,s=new Array(n);s[0]=f;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>n,metadata:()=>a,toc:()=>l});var o=r(3117),i=(r(7294),r(3905));const n={id:"body-file",displayed_sidebar:"tev2SideBar",term:"body-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/11-body-file.md",glossaryTerm:"Body File",glossaryText:"a file that is located somewhere within the [scopedir](@), and that contains the [body](@) of a [curated text](@).",glossaryNotes:["The [header](@) of that [curated text](@) has a field `bodyFile` that specifies its location within the [scopedir](@)."],grouptags:[],formPhrases:["body-file{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s=void 0,a={unversionedId:"terms/body-file",id:"terms/body-file",title:"body-file",description:"",source:"@site/docs/terms/body-file.md",sourceDirName:"terms",slug:"/terms/body-file",permalink:"/tev2-specifications/docs/terms/body-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/body-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"body-file",displayed_sidebar:"tev2SideBar",term:"body-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/11-body-file.md",glossaryTerm:"Body File",glossaryText:"a file that is located somewhere within the [scopedir](@), and that contains the [body](@) of a [curated text](@).",glossaryNotes:["The [header](@) of that [curated text](@) has a field `bodyFile` that specifies its location within the [scopedir](@)."],grouptags:[],formPhrases:["body-file{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,o.Z)({},d,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[2712],{3905:(e,t,r)=>{r.d(t,{Zo:()=>d,kt:()=>y});var o=r(7294);function i(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function n(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,o)}return r}function s(e){for(var t=1;t=0||(i[r]=e[r]);return i}(e,t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(i[r]=e[r])}return i}var c=o.createContext({}),l=function(e){var t=o.useContext(c),r=t;return e&&(r="function"==typeof e?e(t):s(s({},t),e)),r},d=function(e){var t=l(e.components);return o.createElement(c.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},f=o.forwardRef((function(e,t){var r=e.components,i=e.mdxType,n=e.originalType,c=e.parentName,d=a(e,["components","mdxType","originalType","parentName"]),f=l(r),y=i,u=f["".concat(c,".").concat(y)]||f[y]||p[y]||n;return r?o.createElement(u,s(s({ref:t},d),{},{components:r})):o.createElement(u,s({ref:t},d))}));function y(e,t){var r=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var n=r.length,s=new Array(n);s[0]=f;var a={};for(var c in t)hasOwnProperty.call(t,c)&&(a[c]=t[c]);a.originalType=e,a.mdxType="string"==typeof e?e:i,s[1]=a;for(var l=2;l{r.r(t),r.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>p,frontMatter:()=>n,metadata:()=>a,toc:()=>l});var o=r(3117),i=(r(7294),r(3905));const n={id:"body-file",displayed_sidebar:"tev2SideBar",term:"body-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/11-body-file.md",glossaryTerm:"Body File",glossaryText:"a file that is located somewhere within the [scopedir](@), and that contains the [body](@) of a [curated text](@).",glossaryNotes:["The [header](@) of that [curated text](@) has a field `bodyFile` that specifies its location within the [scopedir](@)."],grouptags:[],formPhrases:["body-file{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s=void 0,a={unversionedId:"terms/body-file",id:"terms/body-file",title:"body-file",description:"",source:"@site/docs/terms/body-file.md",sourceDirName:"terms",slug:"/terms/body-file",permalink:"/tev2-specifications/docs/terms/body-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/body-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"body-file",displayed_sidebar:"tev2SideBar",term:"body-file",termType:"concept",isa:"curated-file",bodyFile:"/specs/files/11-body-file.md",glossaryTerm:"Body File",glossaryText:"a file that is located somewhere within the [scopedir](@), and that contains the [body](@) of a [curated text](@).",glossaryNotes:["The [header](@) of that [curated text](@) has a field `bodyFile` that specifies its location within the [scopedir](@)."],grouptags:[],formPhrases:["body-file{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[],d={toc:l};function p(e){let{components:t,...r}=e;return(0,i.kt)("wrapper",(0,o.Z)({},d,r,{components:t,mdxType:"MDXLayout"}))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8f890ba0.58e3548a.js b/assets/js/8f890ba0.eef5dc80.js similarity index 99% rename from assets/js/8f890ba0.58e3548a.js rename to assets/js/8f890ba0.eef5dc80.js index c3833e21e..c2dd7d56b 100644 --- a/assets/js/8f890ba0.58e3548a.js +++ b/assets/js/8f890ba0.eef5dc80.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1875],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>p});var o=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,o)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var l=o.createContext({}),d=function(e){var t=o.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},u=function(e){var t=d(e.components);return o.createElement(l.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},c=o.forwardRef((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,l=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),c=d(n),p=a,h=c["".concat(l,".").concat(p)]||c[p]||m[p]||r;return n?o.createElement(h,i(i({ref:t},u),{},{components:n})):o.createElement(h,i({ref:t},u))}));function p(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,i=new Array(r);i[0]=c;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var d=2;d{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>d});var o=n(3117),a=(n(7294),n(3905));n(4996);const r={id:"tev2-requirements",sidebar_label:"Initial Requirements",description:"Some early-time requirements for doing TermRefs.",date:20220303},i="Towards a usable Terminology Tool",s={unversionedId:"overview/tev2-requirements",id:"overview/tev2-requirements",title:"Towards a usable Terminology Tool",description:"Some early-time requirements for doing TermRefs.",source:"@site/docs/overview/90-tev2-requirements.md",sourceDirName:"overview",slug:"/overview/tev2-requirements",permalink:"/tev2-specifications/docs/overview/tev2-requirements",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/90-tev2-requirements.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:90,frontMatter:{id:"tev2-requirements",sidebar_label:"Initial Requirements",description:"Some early-time requirements for doing TermRefs.",date:20220303},sidebar:"tev2SideBar",previous:{title:"Backgrounds",permalink:"/tev2-specifications/docs/overview/tev2-background"},next:{title:"Create and Maintain Terminologies",permalink:"/tev2-specifications/docs/terms/patterns/terminology"}},l={},d=[{value:"Introduction",id:"introduction",level:2},{value:"Helpful for readers",id:"helpful-for-readers",level:2},{value:"Easy to write for non-technical users",id:"easy-to-write-for-non-technical-users",level:2},{value:"Immediate feedback",id:"immediate-feedback",level:2},{value:"Sane defaults",id:"sane-defaults",level:2},{value:"Separation of concerns",id:"separation-of-concerns",level:2},{value:"Reuse of existing tools",id:"reuse-of-existing-tools",level:2},{value:"Extensibility",id:"extensibility",level:2}],u={toc:d};function m(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,o.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"towards-a-usable-terminology-tool"},"Towards a usable Terminology Tool"),(0,a.kt)("p",null,"Referencing terms and concepts within and from outside of eSSIF-lab"),(0,a.kt)("p",null,"Author: Hidde-Jan Jongsma"),(0,a.kt)("admonition",{type:"note"},(0,a.kt)("p",{parentName:"admonition"},"This text has been created prior to the specification and further development of TEv2.\nWe leave it here so that we can look back and see what has come of all this (or not).")),(0,a.kt)("h2",{id:"introduction"},"Introduction"),(0,a.kt)("p",null,"We want a good tool for terminology for a number of reasons, such as"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},"sharing a single, good terminology within a group of people, is that it enables them to use its terms in a single meaning that is understood by all members of the group. It helps coming to grips with, e.g., conflation of terms which is an all too common cause of misunderstandings, inefficiencies, etc."),(0,a.kt)("li",{parentName:"ol"},"terms that are defined using criteria that enable readers to determine whether or not something is an instance (example) of the concept to which the term refers, enables such concepts to be referenced in documents - even if within the context of that document, another term would be used to refer to that concept."),(0,a.kt)("li",{parentName:"ol"},"\u2026")),(0,a.kt)("p",null,"We need a technical solution that"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"is helpful for readers"),(0,a.kt)("li",{parentName:"ul"},"is easy to write for non-technical users"),(0,a.kt)("li",{parentName:"ul"},"provides immediate feedback"),(0,a.kt)("li",{parentName:"ul"},"has sane defaults"),(0,a.kt)("li",{parentName:"ul"},"supports separation of concerns"),(0,a.kt)("li",{parentName:"ul"},"enables reuse of existing tools"),(0,a.kt)("li",{parentName:"ul"},"is extensible")),(0,a.kt)("p",null,"Note: in this document we assume the use of a docusaurus project, in combination with MDX (markdown with JSX)."),(0,a.kt)("p",null,"Note: we use the ",(0,a.kt)("a",{parentName:"p",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"eSSIF-Lab Terminology Pattern")," as the conceptual basis for this tool. In short, this means that:\nevery document is considered part of a scope, the terminology of which it uses by default.\na document may also use terms defined in another scope (to be explicitly annotated as such)"),(0,a.kt)("h2",{id:"helpful-for-readers"},"Helpful for readers"),(0,a.kt)("p",null,"The main reason for using terminology tooling is to improve the process of a reader that attempts to understand the meanings that the document (s)he is reading attempts to convey. It is beneficial to a reader to quickly determine the meaning of a term in a document, especially when reading a highly technical document or a document that concerns complex conceptual models."),(0,a.kt)("p",null,"To this end, we need a terminology tool to enable a user to quickly identify a technical term, to instantly obtain a summary or short description of the term, and to be able to easily reach a place where the term is described in more detail."),(0,a.kt)("p",null,"The most straightforward solution, that builds on established UI components, is some kind of combination of a (distinctly colored) hyperlink in combination with some popup or modal component."),(0,a.kt)("h2",{id:"easy-to-write-for-non-technical-users"},"Easy to write for non-technical users"),(0,a.kt)("p",null,"A solution should minimize the amount of new things users need to learn before being able to use the terminology stack. For a docusaurus-based project, this could mean a few things:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Use a syntax that looks very similar to existing markdown markup. For example, use a link-like syntax ",(0,a.kt)("inlineCode",{parentName:"p"},"[like this](%some-term@scope)")," or ",(0,a.kt)("inlineCode",{parentName:"p"},"%[like that](scope@v1/some-other-term)"),".")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Use a React component with a minimal interface, for example"))),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-react"},"import Term from \u201csome-package\u201d\n\nUse it in MDX like this\n")),(0,a.kt)("p",null,"Both options have positive and negative aspects. The first option would probably be more suitable for people who are unfamiliar with React. However, the second option is more easily implemented, since it does not introduce new markdown syntax. A first step would be to support option 2, then add markdown parsing functionality enabling option 1."),(0,a.kt)("p",null,"What should be clear is that there should be only one syntax that can be used in any context that \u201cnormal\u201d markdown input is acceptable."),(0,a.kt)("p",null,"The syntax should also try to reduce friction and be ergonomic for the writer. For instance, if the referenced term can be inferred from the content of the link, a reader should be allowed to omit an explicit label for the term. The table below gives examples of what such a normalization step could look like:"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:null},"Content"),(0,a.kt)("th",{parentName:"tr",align:null},"Possible inferred label"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"document"),(0,a.kt)("td",{parentName:"tr",align:null},"document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"Mental model"),(0,a.kt)("td",{parentName:"tr",align:null},"mental-model")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"Mental Models"),(0,a.kt)("td",{parentName:"tr",align:null},"mental-model")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID Document"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID-Documents"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID-Document(s)"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID"),(0,a.kt)("td",{parentName:"tr",align:null},"did")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"..."),(0,a.kt)("td",{parentName:"tr",align:null},"...")))),(0,a.kt)("p",null,"Terms should also be able to specify multiple equivalent labels that point to a single term, allowing much used aliases, synonyms or irregular plurals to be used as the content of a reference without needing to add an explicit label. For instance \u201cperson\u201d and \u201cpeople\u201d, or \u201cDID\u201d and \u201cdecentralized identifier\u201d. See ",(0,a.kt)("a",{parentName:"p",href:"https://respec.org/docs/#definitions-and-linking"},"https://respec.org/docs/#definitions-and-linking")," for inspiration."),(0,a.kt)("h2",{id:"immediate-feedback"},"Immediate feedback"),(0,a.kt)("p",null,"An important feature of docusaurus projects is the ability to (hot-)reload a page after a writer has updated the corresponding markdown file. The change is immediately presented back to the writer, providing a very short write-view-revision feedback loop."),(0,a.kt)("p",null,"This means if a term is added to a markdown page, the term should immediately resolve (to the final version) and be visible to the writer. The only thing a writer should have to do is save the markdown file (and possibly) reload the corresponding page."),(0,a.kt)("p",null,"A process that modifies the markdown files or does not work in development mode is unacceptable. Necessary reindexing of terms or regeneration of glossary pages should be done in the background of the development server and should not require extra user interaction."),(0,a.kt)("p",null,"If a term cannot be resolved (a wrong label or typo) then the writer should notice this immediately, without breaking the rendering of the rest of the markdown page. This could mean logging an error in the terminal of the development server and visual feedback on the rendered markdown page (red color, highlighting, or something similar)."),(0,a.kt)("h2",{id:"sane-defaults"},"Sane defaults"),(0,a.kt)("p",null,"When adding the tool to a new (or existing) docusaurus project, the terminology stack \u201cshould just work\u201d, preferring convention over configuration. This means looking for term definitions in sensible default locations and publishing glossary pages at paths that are unlikely to lead to conflicts with existing pages."),(0,a.kt)("p",null,"It should also behave as other docusaurus plugins, being configurable in docusaurus.config.js, in the plugin section. Here a technical savvy user could replace default term locations, glossary page paths, used react components, etc."),(0,a.kt)("h2",{id:"separation-of-concerns"},"Separation of concerns"),(0,a.kt)("p",null,"The terminology plugin should have a modular design that separates the different components and functions into different modules, each with a well defined purpose and boundary. These functions include, but are not limited to:\nExtending markdown syntax and parsing into new AST nodes\nConverting AST nodes to some terminology based react component(s)\nBuilding an index of terms, labels and summaries\nResolving a term from the index and returning needed data for term components\nGenerating glossary related pages from the term index\nGenerating dictionaries from glossaries of different scopes"),(0,a.kt)("h2",{id:"reuse-of-existing-tools"},"Reuse of existing tools"),(0,a.kt)("p",null,"This document assumes that we are working on a docusaurus project. This means that there is a certain tool available already, providing Link components, and possibly popup or modal components. We should not reinvent the wheel and rely on these existing libraries and packages."),(0,a.kt)("p",null,"Furthermore, the current version of docusaurus relies on (an older version of) remark.js for markdown parsing and rendering. Anything dealing with markdown should probably be written as a plugin for that system."),(0,a.kt)("h2",{id:"extensibility"},"Extensibility"),(0,a.kt)("p",null,"The first version of this tool should aim to reproduce and improve upon the capabilities of the existing @docusaurus-terminology/parser package created by GrNet. However, in the future, we would like to support functionality such as external terminology references/glossaries, namespaces and versioning of term/glossaries."))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[1875],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>p});var o=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,o)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var l=o.createContext({}),d=function(e){var t=o.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},u=function(e){var t=d(e.components);return o.createElement(l.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},c=o.forwardRef((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,l=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),c=d(n),p=a,h=c["".concat(l,".").concat(p)]||c[p]||m[p]||r;return n?o.createElement(h,i(i({ref:t},u),{},{components:n})):o.createElement(h,i({ref:t},u))}));function p(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,i=new Array(r);i[0]=c;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var d=2;d{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>d});var o=n(3117),a=(n(7294),n(3905));n(4996);const r={id:"tev2-requirements",sidebar_label:"Initial Requirements",description:"Some early-time requirements for doing TermRefs.",date:20220303},i="Towards a usable Terminology Tool",s={unversionedId:"overview/tev2-requirements",id:"overview/tev2-requirements",title:"Towards a usable Terminology Tool",description:"Some early-time requirements for doing TermRefs.",source:"@site/docs/overview/90-tev2-requirements.md",sourceDirName:"overview",slug:"/overview/tev2-requirements",permalink:"/tev2-specifications/docs/overview/tev2-requirements",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/overview/90-tev2-requirements.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:90,frontMatter:{id:"tev2-requirements",sidebar_label:"Initial Requirements",description:"Some early-time requirements for doing TermRefs.",date:20220303},sidebar:"tev2SideBar",previous:{title:"Backgrounds",permalink:"/tev2-specifications/docs/overview/tev2-background"},next:{title:"Create and Maintain Terminologies",permalink:"/tev2-specifications/docs/terms/patterns/terminology"}},l={},d=[{value:"Introduction",id:"introduction",level:2},{value:"Helpful for readers",id:"helpful-for-readers",level:2},{value:"Easy to write for non-technical users",id:"easy-to-write-for-non-technical-users",level:2},{value:"Immediate feedback",id:"immediate-feedback",level:2},{value:"Sane defaults",id:"sane-defaults",level:2},{value:"Separation of concerns",id:"separation-of-concerns",level:2},{value:"Reuse of existing tools",id:"reuse-of-existing-tools",level:2},{value:"Extensibility",id:"extensibility",level:2}],u={toc:d};function m(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,o.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"towards-a-usable-terminology-tool"},"Towards a usable Terminology Tool"),(0,a.kt)("p",null,"Referencing terms and concepts within and from outside of eSSIF-lab"),(0,a.kt)("p",null,"Author: Hidde-Jan Jongsma"),(0,a.kt)("admonition",{type:"note"},(0,a.kt)("p",{parentName:"admonition"},"This text has been created prior to the specification and further development of TEv2.\nWe leave it here so that we can look back and see what has come of all this (or not).")),(0,a.kt)("h2",{id:"introduction"},"Introduction"),(0,a.kt)("p",null,"We want a good tool for terminology for a number of reasons, such as"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},"sharing a single, good terminology within a group of people, is that it enables them to use its terms in a single meaning that is understood by all members of the group. It helps coming to grips with, e.g., conflation of terms which is an all too common cause of misunderstandings, inefficiencies, etc."),(0,a.kt)("li",{parentName:"ol"},"terms that are defined using criteria that enable readers to determine whether or not something is an instance (example) of the concept to which the term refers, enables such concepts to be referenced in documents - even if within the context of that document, another term would be used to refer to that concept."),(0,a.kt)("li",{parentName:"ol"},"\u2026")),(0,a.kt)("p",null,"We need a technical solution that"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"is helpful for readers"),(0,a.kt)("li",{parentName:"ul"},"is easy to write for non-technical users"),(0,a.kt)("li",{parentName:"ul"},"provides immediate feedback"),(0,a.kt)("li",{parentName:"ul"},"has sane defaults"),(0,a.kt)("li",{parentName:"ul"},"supports separation of concerns"),(0,a.kt)("li",{parentName:"ul"},"enables reuse of existing tools"),(0,a.kt)("li",{parentName:"ul"},"is extensible")),(0,a.kt)("p",null,"Note: in this document we assume the use of a docusaurus project, in combination with MDX (markdown with JSX)."),(0,a.kt)("p",null,"Note: we use the ",(0,a.kt)("a",{parentName:"p",href:"https://essif-lab.github.io/framework/docs/terms/pattern-terminology"},"eSSIF-Lab Terminology Pattern")," as the conceptual basis for this tool. In short, this means that:\nevery document is considered part of a scope, the terminology of which it uses by default.\na document may also use terms defined in another scope (to be explicitly annotated as such)"),(0,a.kt)("h2",{id:"helpful-for-readers"},"Helpful for readers"),(0,a.kt)("p",null,"The main reason for using terminology tooling is to improve the process of a reader that attempts to understand the meanings that the document (s)he is reading attempts to convey. It is beneficial to a reader to quickly determine the meaning of a term in a document, especially when reading a highly technical document or a document that concerns complex conceptual models."),(0,a.kt)("p",null,"To this end, we need a terminology tool to enable a user to quickly identify a technical term, to instantly obtain a summary or short description of the term, and to be able to easily reach a place where the term is described in more detail."),(0,a.kt)("p",null,"The most straightforward solution, that builds on established UI components, is some kind of combination of a (distinctly colored) hyperlink in combination with some popup or modal component."),(0,a.kt)("h2",{id:"easy-to-write-for-non-technical-users"},"Easy to write for non-technical users"),(0,a.kt)("p",null,"A solution should minimize the amount of new things users need to learn before being able to use the terminology stack. For a docusaurus-based project, this could mean a few things:"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Use a syntax that looks very similar to existing markdown markup. For example, use a link-like syntax ",(0,a.kt)("inlineCode",{parentName:"p"},"[like this](%some-term@scope)")," or ",(0,a.kt)("inlineCode",{parentName:"p"},"%[like that](scope@v1/some-other-term)"),".")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Use a React component with a minimal interface, for example"))),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-react"},"import Term from \u201csome-package\u201d\n\nUse it in MDX like this\n")),(0,a.kt)("p",null,"Both options have positive and negative aspects. The first option would probably be more suitable for people who are unfamiliar with React. However, the second option is more easily implemented, since it does not introduce new markdown syntax. A first step would be to support option 2, then add markdown parsing functionality enabling option 1."),(0,a.kt)("p",null,"What should be clear is that there should be only one syntax that can be used in any context that \u201cnormal\u201d markdown input is acceptable."),(0,a.kt)("p",null,"The syntax should also try to reduce friction and be ergonomic for the writer. For instance, if the referenced term can be inferred from the content of the link, a reader should be allowed to omit an explicit label for the term. The table below gives examples of what such a normalization step could look like:"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:null},"Content"),(0,a.kt)("th",{parentName:"tr",align:null},"Possible inferred label"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"document"),(0,a.kt)("td",{parentName:"tr",align:null},"document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"Mental model"),(0,a.kt)("td",{parentName:"tr",align:null},"mental-model")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"Mental Models"),(0,a.kt)("td",{parentName:"tr",align:null},"mental-model")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID Document"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID-Documents"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID-Document(s)"),(0,a.kt)("td",{parentName:"tr",align:null},"did-document")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"DID"),(0,a.kt)("td",{parentName:"tr",align:null},"did")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:null},"..."),(0,a.kt)("td",{parentName:"tr",align:null},"...")))),(0,a.kt)("p",null,"Terms should also be able to specify multiple equivalent labels that point to a single term, allowing much used aliases, synonyms or irregular plurals to be used as the content of a reference without needing to add an explicit label. For instance \u201cperson\u201d and \u201cpeople\u201d, or \u201cDID\u201d and \u201cdecentralized identifier\u201d. See ",(0,a.kt)("a",{parentName:"p",href:"https://respec.org/docs/#definitions-and-linking"},"https://respec.org/docs/#definitions-and-linking")," for inspiration."),(0,a.kt)("h2",{id:"immediate-feedback"},"Immediate feedback"),(0,a.kt)("p",null,"An important feature of docusaurus projects is the ability to (hot-)reload a page after a writer has updated the corresponding markdown file. The change is immediately presented back to the writer, providing a very short write-view-revision feedback loop."),(0,a.kt)("p",null,"This means if a term is added to a markdown page, the term should immediately resolve (to the final version) and be visible to the writer. The only thing a writer should have to do is save the markdown file (and possibly) reload the corresponding page."),(0,a.kt)("p",null,"A process that modifies the markdown files or does not work in development mode is unacceptable. Necessary reindexing of terms or regeneration of glossary pages should be done in the background of the development server and should not require extra user interaction."),(0,a.kt)("p",null,"If a term cannot be resolved (a wrong label or typo) then the writer should notice this immediately, without breaking the rendering of the rest of the markdown page. This could mean logging an error in the terminal of the development server and visual feedback on the rendered markdown page (red color, highlighting, or something similar)."),(0,a.kt)("h2",{id:"sane-defaults"},"Sane defaults"),(0,a.kt)("p",null,"When adding the tool to a new (or existing) docusaurus project, the terminology stack \u201cshould just work\u201d, preferring convention over configuration. This means looking for term definitions in sensible default locations and publishing glossary pages at paths that are unlikely to lead to conflicts with existing pages."),(0,a.kt)("p",null,"It should also behave as other docusaurus plugins, being configurable in docusaurus.config.js, in the plugin section. Here a technical savvy user could replace default term locations, glossary page paths, used react components, etc."),(0,a.kt)("h2",{id:"separation-of-concerns"},"Separation of concerns"),(0,a.kt)("p",null,"The terminology plugin should have a modular design that separates the different components and functions into different modules, each with a well defined purpose and boundary. These functions include, but are not limited to:\nExtending markdown syntax and parsing into new AST nodes\nConverting AST nodes to some terminology based react component(s)\nBuilding an index of terms, labels and summaries\nResolving a term from the index and returning needed data for term components\nGenerating glossary related pages from the term index\nGenerating dictionaries from glossaries of different scopes"),(0,a.kt)("h2",{id:"reuse-of-existing-tools"},"Reuse of existing tools"),(0,a.kt)("p",null,"This document assumes that we are working on a docusaurus project. This means that there is a certain tool available already, providing Link components, and possibly popup or modal components. We should not reinvent the wheel and rely on these existing libraries and packages."),(0,a.kt)("p",null,"Furthermore, the current version of docusaurus relies on (an older version of) remark.js for markdown parsing and rendering. Anything dealing with markdown should probably be written as a plugin for that system."),(0,a.kt)("h2",{id:"extensibility"},"Extensibility"),(0,a.kt)("p",null,"The first version of this tool should aim to reproduce and improve upon the capabilities of the existing @docusaurus-terminology/parser package created by GrNet. However, in the future, we would like to support functionality such as external terminology references/glossaries, namespaces and versioning of term/glossaries."))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/8fb8d401.d8254558.js b/assets/js/8fb8d401.884facd1.js similarity index 98% rename from assets/js/8fb8d401.d8254558.js rename to assets/js/8fb8d401.884facd1.js index 60dfa671b..480d73cba 100644 --- a/assets/js/8fb8d401.d8254558.js +++ b/assets/js/8fb8d401.884facd1.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9345],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function a(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),p=l(r),f=o,d=p["".concat(s,".").concat(f)]||p[f]||m[f]||i;return r?n.createElement(d,a(a({ref:t},u),{},{components:r})):n.createElement(d,a({ref:t},u))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,a=new Array(i);a[0]=p;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,a[1]=c;for(var l=2;l{r.d(t,{Z:()=>g});var n=r(7294),o=r(6010),i=r(3438),a=r(9960),c=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(a.Z,{href:t,className:(0,o.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:i,description:a}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,o.Z)("text--truncate",u),title:i},r," ",i),a&&n.createElement("p",{className:(0,o.Z)("text--truncate",m),title:a},a))}function d(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function b(e){let{item:t}=e;const r=(0,c.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,i.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??o?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(b,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(g,{items:r.items,className:t})}function g(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const a=(0,i.MN)(t);return n.createElement("section",{className:(0,o.Z)("row",r)},a.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(h,{item:e})))))}},8909:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>l,toc:()=>m});var n=r(3117),o=(r(7294),r(3905)),i=r(4996),a=r(2991);const c={id:"manuals-contributor",description:"This section contains the manuals for users in the role of contributor."},s="Manuals for Contributors",l={unversionedId:"categories/manuals-contributor",id:"categories/manuals-contributor",title:"Manuals for Contributors",description:"This section contains the manuals for users in the role of contributor.",source:"@site/docs/categories/24-manuals-contributor.md",sourceDirName:"categories",slug:"/categories/manuals-contributor",permalink:"/tev2-specifications/docs/categories/manuals-contributor",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/24-manuals-contributor.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:24,frontMatter:{id:"manuals-contributor",description:"This section contains the manuals for users in the role of contributor."},sidebar:"tev2SideBar",previous:{title:"Author Overview",permalink:"/tev2-specifications/docs/manuals/author/author-overview"},next:{title:"Contributor Overview",permalink:"/tev2-specifications/docs/manuals/contributor/contributor-overview"}},u={},m=[],p={toc:m};function f(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"manuals-for-contributors"},"Manuals for Contributors"),(0,o.kt)("img",{alt:"This entire section is still under construction",src:(0,i.Z)("images/wip/wip-under-construction.png")}),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("p",null,"This section contains manuals for users in their role of ",(0,o.kt)("a",{parentName:"p",href:"@"},"contributor"),"."),(0,o.kt)(a.Z,{folder:"/docs/manuals/contributor",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9345],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function a(e){for(var t=1;t=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):a(a({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,o=e.mdxType,i=e.originalType,s=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),p=l(r),f=o,d=p["".concat(s,".").concat(f)]||p[f]||m[f]||i;return r?n.createElement(d,a(a({ref:t},u),{},{components:r})):n.createElement(d,a({ref:t},u))}));function f(e,t){var r=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var i=r.length,a=new Array(i);a[0]=p;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,a[1]=c;for(var l=2;l{r.d(t,{Z:()=>g});var n=r(7294),o=r(6010),i=r(3438),a=r(9960),c=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(a.Z,{href:t,className:(0,o.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:i,description:a}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,o.Z)("text--truncate",u),title:i},r," ",i),a&&n.createElement("p",{className:(0,o.Z)("text--truncate",m),title:a},a))}function d(e){let{item:t}=e;const r=(0,i.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function b(e){let{item:t}=e;const r=(0,c.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",o=(0,i.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??o?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(b,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,i.jA)();return n.createElement(g,{items:r.items,className:t})}function g(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const a=(0,i.MN)(t);return n.createElement("section",{className:(0,o.Z)("row",r)},a.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(h,{item:e})))))}},8909:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>l,toc:()=>m});var n=r(3117),o=(r(7294),r(3905)),i=r(4996),a=r(2991);const c={id:"manuals-contributor",description:"This section contains the manuals for users in the role of contributor."},s="Manuals for Contributors",l={unversionedId:"categories/manuals-contributor",id:"categories/manuals-contributor",title:"Manuals for Contributors",description:"This section contains the manuals for users in the role of contributor.",source:"@site/docs/categories/24-manuals-contributor.md",sourceDirName:"categories",slug:"/categories/manuals-contributor",permalink:"/tev2-specifications/docs/categories/manuals-contributor",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/24-manuals-contributor.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:24,frontMatter:{id:"manuals-contributor",description:"This section contains the manuals for users in the role of contributor."},sidebar:"tev2SideBar",previous:{title:"Author Overview",permalink:"/tev2-specifications/docs/manuals/author/author-overview"},next:{title:"Contributor Overview",permalink:"/tev2-specifications/docs/manuals/contributor/contributor-overview"}},u={},m=[],p={toc:m};function f(e){let{components:t,...r}=e;return(0,o.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"manuals-for-contributors"},"Manuals for Contributors"),(0,o.kt)("img",{alt:"This entire section is still under construction",src:(0,i.Z)("images/wip/wip-under-construction.png")}),(0,o.kt)("br",null),(0,o.kt)("br",null),(0,o.kt)("p",null,"This section contains manuals for users in their role of ",(0,o.kt)("a",{parentName:"p",href:"@"},"contributor"),"."),(0,o.kt)(a.Z,{folder:"/docs/manuals/contributor",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/9136c9f6.5f94eab8.js b/assets/js/9136c9f6.0dd240ae.js similarity index 99% rename from assets/js/9136c9f6.5f94eab8.js rename to assets/js/9136c9f6.0dd240ae.js index db2cb83f4..427022db3 100644 --- a/assets/js/9136c9f6.5f94eab8.js +++ b/assets/js/9136c9f6.0dd240ae.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7247],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>f});var n=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),m=l(i),f=a,u=m["".concat(c,".").concat(f)]||m[f]||d[f]||o;return i?n.createElement(u,s(s({ref:t},p),{},{components:i})):n.createElement(u,s({ref:t},p))}));function f(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,s=new Array(o);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>o,metadata:()=>r,toc:()=>l});var n=i(3117),a=(i(7294),i(3905));const o={id:"conceptualization",displayed_sidebar:"tev2SideBar",term:"conceptualization",termType:"concept",isa:null,glossaryTerm:"Conceptualization",glossaryText:"a mental representation or abstract idea formed by a [party](@) to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the [party](@) to recognize similarities and differences between [entities](@) or events.",grouptags:[],formPhrases:["conceptualization{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Conceptualization",r={unversionedId:"terms/conceptualization",id:"terms/conceptualization",title:"Conceptualization",description:"Summary",source:"@site/docs/terms/conceptualization.md",sourceDirName:"terms",slug:"/terms/conceptualization",permalink:"/tev2-specifications/docs/terms/conceptualization",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/conceptualization.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"conceptualization",displayed_sidebar:"tev2SideBar",term:"conceptualization",termType:"concept",isa:null,glossaryTerm:"Conceptualization",glossaryText:"a mental representation or abstract idea formed by a [party](@) to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the [party](@) to recognize similarities and differences between [entities](@) or events.",grouptags:[],formPhrases:["conceptualization{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Background",id:"background",level:3}],p={toc:l};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"conceptualization"},"Conceptualization"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"conceptualization")," is a mental representation or abstract idea formed by a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,a.kt)("h3",{id:"background"},"Background"),(0,a.kt)("p",null,"As individuals, we each possess unique perceptions of the world around us, shaped by our experiences, upbringing, cultural background, and personal beliefs. These individual differences in perceptions of the world naturally lead to variations in the way we ","[conceptualize]","(",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Conceptualization_(information_science)"},"https://en.wikipedia.org/wiki/Conceptualization_(information_science)")," the information we encounter. In cognitive science, ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," refers to the mental process of forming abstract ideas and categories, allowing us to make sense of the vast amount of information we receive."),(0,a.kt)("p",null,"As we interact with the world, our minds construct ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," or ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that represent our understanding of objects, events, and abstract notions. These ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", or ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", are stored in our long-term memories, forming what is known as semantic memories. Since each person's ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," is shaped by their unique experiences, it follows that their semantic memories will contain different representations of the same entities or ideas."),(0,a.kt)("p",null,"As a consequence of these individual differences in ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," and semantic memories, we can expect variations in the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," people use to refer to the same ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". For instance, what one person refers to as a 'chair' might not be perceived as a chair by someone else due to varying cultural norms, design preferences, or functional considerations. This variability in language usage is particularly important to recognize, especially when communication and mutual understanding are essential in various domains of human interaction."),(0,a.kt)("p",null,"To address the challenges arising from diverse ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualizations")," and linguistic representations, it becomes crucial to use precise ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". Each definition should comprise two key components: a criterion that allows individuals to determine whether something qualifies as an instance or example of the concept, and a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is employed to refer to that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or its specific instances."),(0,a.kt)("p",null,"By providing clear and well-defined criteria for ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", we can facilitate effective communication and reduce misunderstandings arising from differences in perceptions and ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualizations"),". Such carefully constructed definitions enable us to bridge the gap between individual perspectives and build a shared understanding of the world, fostering better communication and cooperation among people with diverse backgrounds and viewpoints. As cognitive science continues to explore the intricacies of human cognition, understanding the role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization"),", semantic memories, and the importance of precise ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," remains vital for comprehending the complexities of human thought and communication."))}d.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[7247],{3905:(e,t,i)=>{i.d(t,{Zo:()=>p,kt:()=>f});var n=i(7294);function a(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function o(e,t){var i=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),i.push.apply(i,n)}return i}function s(e){for(var t=1;t=0||(a[i]=e[i]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,i)&&(a[i]=e[i])}return a}var c=n.createContext({}),l=function(e){var t=n.useContext(c),i=t;return e&&(i="function"==typeof e?e(t):s(s({},t),e)),i},p=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var i=e.components,a=e.mdxType,o=e.originalType,c=e.parentName,p=r(e,["components","mdxType","originalType","parentName"]),m=l(i),f=a,u=m["".concat(c,".").concat(f)]||m[f]||d[f]||o;return i?n.createElement(u,s(s({ref:t},p),{},{components:i})):n.createElement(u,s({ref:t},p))}));function f(e,t){var i=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=i.length,s=new Array(o);s[0]=m;var r={};for(var c in t)hasOwnProperty.call(t,c)&&(r[c]=t[c]);r.originalType=e,r.mdxType="string"==typeof e?e:a,s[1]=r;for(var l=2;l{i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>s,default:()=>d,frontMatter:()=>o,metadata:()=>r,toc:()=>l});var n=i(3117),a=(i(7294),i(3905));const o={id:"conceptualization",displayed_sidebar:"tev2SideBar",term:"conceptualization",termType:"concept",isa:null,glossaryTerm:"Conceptualization",glossaryText:"a mental representation or abstract idea formed by a [party](@) to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the [party](@) to recognize similarities and differences between [entities](@) or events.",grouptags:[],formPhrases:["conceptualization{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},s="Conceptualization",r={unversionedId:"terms/conceptualization",id:"terms/conceptualization",title:"Conceptualization",description:"Summary",source:"@site/docs/terms/conceptualization.md",sourceDirName:"terms",slug:"/terms/conceptualization",permalink:"/tev2-specifications/docs/terms/conceptualization",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/terms/conceptualization.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",frontMatter:{id:"conceptualization",displayed_sidebar:"tev2SideBar",term:"conceptualization",termType:"concept",isa:null,glossaryTerm:"Conceptualization",glossaryText:"a mental representation or abstract idea formed by a [party](@) to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the [party](@) to recognize similarities and differences between [entities](@) or events.",grouptags:[],formPhrases:["conceptualization{ss}"],status:"proposed",created:20230723,updated:20230723,contributors:"RieksJ",attribution:"[TNO Terminology Design](https://tno-terminology-design.github.io/tev2-specifications/docs)",originalLicense:"[CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)"},sidebar:"tev2SideBar"},c={},l=[{value:"Summary",id:"summary",level:3},{value:"Background",id:"background",level:3}],p={toc:l};function d(e){let{components:t,...i}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"conceptualization"},"Conceptualization"),(0,a.kt)("h3",{id:"summary"},"Summary"),(0,a.kt)("p",null,"A ",(0,a.kt)("strong",{parentName:"p"},"conceptualization")," is a mental representation or abstract idea formed by a ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/party",title:"Party: an Entity that sets its Objectives, maintains its Knowledge, and uses that Knowledge to pursue its Objectives in an autonomous (sovereign) manner. Humans and Organizations are the typical examples."},"party")," to recognize similarities and differences between ",(0,a.kt)("a",{href:"https://essif-lab.github.io/framework/docs/terms/entity",title:"Entity: someone or something that is known to exist."},"entities")," or events."),(0,a.kt)("h3",{id:"background"},"Background"),(0,a.kt)("p",null,"As individuals, we each possess unique perceptions of the world around us, shaped by our experiences, upbringing, cultural background, and personal beliefs. These individual differences in perceptions of the world naturally lead to variations in the way we ","[conceptualize]","(",(0,a.kt)("a",{parentName:"p",href:"https://en.wikipedia.org/wiki/Conceptualization_(information_science)"},"https://en.wikipedia.org/wiki/Conceptualization_(information_science)")," the information we encounter. In cognitive science, ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," refers to the mental process of forming abstract ideas and categories, allowing us to make sense of the vast amount of information we receive."),(0,a.kt)("p",null,"As we interact with the world, our minds construct ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units")," or ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts")," that represent our understanding of objects, events, and abstract notions. These ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/semantic-unit",title:"Semantic Unit: a basic building block of meaning or representation that exists within the 'mind' of a Party (i.e., in its Knowledge)."},"semantic units"),", or ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", are stored in our long-term memories, forming what is known as semantic memories. Since each person's ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," is shaped by their unique experiences, it follows that their semantic memories will contain different representations of the same entities or ideas."),(0,a.kt)("p",null,"As a consequence of these individual differences in ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization")," and semantic memories, we can expect variations in the ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"terms")," people use to refer to the same ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". For instance, what one person refers to as a 'chair' might not be perceived as a chair by someone else due to varying cultural norms, design preferences, or functional considerations. This variability in language usage is particularly important to recognize, especially when communication and mutual understanding are essential in various domains of human interaction."),(0,a.kt)("p",null,"To address the challenges arising from diverse ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualizations")," and linguistic representations, it becomes crucial to use precise ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," for ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),". Each definition should comprise two key components: a criterion that allows individuals to determine whether something qualifies as an instance or example of the concept, and a ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/term",title:"Term: a word or phrase (i.e.: text) that is used to represent Concepts."},"term")," that is employed to refer to that ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concept")," or its specific instances."),(0,a.kt)("p",null,"By providing clear and well-defined criteria for ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/concept",title:"Concept: a Semantic Unit that captures the ideas/thoughts behind a classification of Entities (what makes Entities in that class 'the same')."},"concepts"),", we can facilitate effective communication and reduce misunderstandings arising from differences in perceptions and ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualizations"),". Such carefully constructed definitions enable us to bridge the gap between individual perspectives and build a shared understanding of the world, fostering better communication and cooperation among people with diverse backgrounds and viewpoints. As cognitive science continues to explore the intricacies of human cognition, understanding the role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/conceptualization",title:"Conceptualization: a mental representation or abstract idea formed by a Party to categorize, organize, and make sense of information, experiences, objects, or abstract notions; it allows the Party to recognize similarities and differences between Entities or events."},"conceptualization"),", semantic memories, and the importance of precise ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/definition",title:"Definition: the combination of a Term and a descriptive text, where the Term refers to a Concept or other Semantic Unit, and the descriptive text enables a set of Parties to have the same understanding about that Concept. Ideally, the descriptive text is a criterion that such Parties can use to determine what is, and what is not, an instance (or example) of that Concept."},"definitions")," remains vital for comprehending the complexities of human thought and communication."))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/93102254.2ca66a95.js b/assets/js/93102254.889ecc8c.js similarity index 98% rename from assets/js/93102254.2ca66a95.js rename to assets/js/93102254.889ecc8c.js index 39fc40b0c..a11dcc183 100644 --- a/assets/js/93102254.2ca66a95.js +++ b/assets/js/93102254.889ecc8c.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9442],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),p=l(r),f=a,d=p["".concat(s,".").concat(f)]||p[f]||m[f]||o;return r?n.createElement(d,i(i({ref:t},u),{},{components:r})):n.createElement(d,i({ref:t},u))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=p;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:a,i[1]=c;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),o=r(3438),i=r(9960),c=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(i.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:o,description:i}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:o},r," ",o),i&&n.createElement("p",{className:(0,a.Z)("text--truncate",m),title:i},i))}function d(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,c.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const i=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},i.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(h,{item:e})))))}},9895:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>l,toc:()=>m});var n=r(3117),a=(r(7294),r(3905)),o=r(4996),i=r(2991);const c={id:"manuals-curator",description:"This section contains the manuals for users in the role of curator."},s="Manuals for Curators",l={unversionedId:"categories/manuals-curator",id:"categories/manuals-curator",title:"Manuals for Curators",description:"This section contains the manuals for users in the role of curator.",source:"@site/docs/categories/26-manuals-curator.md",sourceDirName:"categories",slug:"/categories/manuals-curator",permalink:"/tev2-specifications/docs/categories/manuals-curator",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/26-manuals-curator.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:26,frontMatter:{id:"manuals-curator",description:"This section contains the manuals for users in the role of curator."},sidebar:"tev2SideBar",previous:{title:"Using LaTeX",permalink:"/tev2-specifications/docs/manuals/contributor/contributors-LaTeX"},next:{title:"Curator Overview",permalink:"/tev2-specifications/docs/manuals/curator/curator-overview"}},u={},m=[],p={toc:m};function f(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"manuals-for-curators"},"Manuals for Curators"),(0,a.kt)("img",{alt:"This entire section is still under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,a.kt)("br",null),(0,a.kt)("br",null),(0,a.kt)("p",null,"This section contains manuals for users in their role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),"."),(0,a.kt)(i.Z,{folder:"/docs/manuals/curator",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[9442],{3905:(e,t,r)=>{r.d(t,{Zo:()=>u,kt:()=>f});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),l=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i(i({},t),e)),r},u=function(e){var t=l(e.components);return n.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),p=l(r),f=a,d=p["".concat(s,".").concat(f)]||p[f]||m[f]||o;return r?n.createElement(d,i(i({ref:t},u),{},{components:r})):n.createElement(d,i({ref:t},u))}));function f(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=p;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:a,i[1]=c;for(var l=2;l{r.d(t,{Z:()=>b});var n=r(7294),a=r(6010),o=r(3438),i=r(9960),c=r(3919),s=r(5999);const l="cardContainer_fWXF",u="cardTitle_rnsV",m="cardDescription_PWke";function p(e){let{href:t,children:r}=e;return n.createElement(i.Z,{href:t,className:(0,a.Z)("card padding--lg",l)},r)}function f(e){let{href:t,icon:r,title:o,description:i}=e;return n.createElement(p,{href:t},n.createElement("h2",{className:(0,a.Z)("text--truncate",u),title:o},r," ",o),i&&n.createElement("p",{className:(0,a.Z)("text--truncate",m),title:i},i))}function d(e){let{item:t}=e;const r=(0,o.Wl)(t);return r?n.createElement(f,{href:r,icon:"\ud83d\uddc3\ufe0f",title:t.label,description:t.description??(0,s.I)({message:"{count} items",id:"theme.docs.DocCard.categoryDescription",description:"The default description for a category card in the generated index about how many items this category includes"},{count:t.items.length})}):null}function g(e){let{item:t}=e;const r=(0,c.Z)(t.href)?"\ud83d\udcc4\ufe0f":"\ud83d\udd17",a=(0,o.xz)(t.docId??void 0);return n.createElement(f,{href:t.href,icon:r,title:t.label,description:t.description??a?.description})}function h(e){let{item:t}=e;switch(t.type){case"link":return n.createElement(g,{item:t});case"category":return n.createElement(d,{item:t});default:throw new Error(`unknown item type ${JSON.stringify(t)}`)}}function y(e){let{className:t}=e;const r=(0,o.jA)();return n.createElement(b,{items:r.items,className:t})}function b(e){const{items:t,className:r}=e;if(!t)return n.createElement(y,e);const i=(0,o.MN)(t);return n.createElement("section",{className:(0,a.Z)("row",r)},i.map(((e,t)=>n.createElement("article",{key:t,className:"col col--6 margin-bottom--lg"},n.createElement(h,{item:e})))))}},9895:(e,t,r)=>{r.r(t),r.d(t,{assets:()=>u,contentTitle:()=>s,default:()=>f,frontMatter:()=>c,metadata:()=>l,toc:()=>m});var n=r(3117),a=(r(7294),r(3905)),o=r(4996),i=r(2991);const c={id:"manuals-curator",description:"This section contains the manuals for users in the role of curator."},s="Manuals for Curators",l={unversionedId:"categories/manuals-curator",id:"categories/manuals-curator",title:"Manuals for Curators",description:"This section contains the manuals for users in the role of curator.",source:"@site/docs/categories/26-manuals-curator.md",sourceDirName:"categories",slug:"/categories/manuals-curator",permalink:"/tev2-specifications/docs/categories/manuals-curator",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/categories/26-manuals-curator.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711963588,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:26,frontMatter:{id:"manuals-curator",description:"This section contains the manuals for users in the role of curator."},sidebar:"tev2SideBar",previous:{title:"Using LaTeX",permalink:"/tev2-specifications/docs/manuals/contributor/contributors-LaTeX"},next:{title:"Curator Overview",permalink:"/tev2-specifications/docs/manuals/curator/curator-overview"}},u={},m=[],p={toc:m};function f(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},p,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"manuals-for-curators"},"Manuals for Curators"),(0,a.kt)("img",{alt:"This entire section is still under construction",src:(0,o.Z)("images/wip/wip-under-construction.png")}),(0,a.kt)("br",null),(0,a.kt)("br",null),(0,a.kt)("p",null,"This section contains manuals for users in their role of ",(0,a.kt)("a",{href:"/tev2-specifications/docs/terms/curator",title:"Curator (of a Scope): a person responsible for curating, managing, and maintaining the Terminologies, to ensure shared understanding among a Community working together on a particular set of Objectives."},"curator"),"."),(0,a.kt)(i.Z,{folder:"/docs/manuals/curator",mdxType:"DocCardList"}))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/9493c8af.ece90dd8.js b/assets/js/9493c8af.a0098124.js similarity index 99% rename from assets/js/9493c8af.ece90dd8.js rename to assets/js/9493c8af.a0098124.js index fa179621b..ce27b1a87 100644 --- a/assets/js/9493c8af.ece90dd8.js +++ b/assets/js/9493c8af.a0098124.js @@ -1 +1 @@ -"use strict";(self.webpackChunktev2_specifications=self.webpackChunktev2_specifications||[]).push([[4841],{3905:(e,t,a)=>{a.d(t,{Zo:()=>d,kt:()=>f});var n=a(7294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function o(e){for(var t=1;t=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var l=n.createContext({}),p=function(e){var t=n.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},d=function(e){var t=p(e.components);return n.createElement(l.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var a=e.components,r=e.mdxType,i=e.originalType,l=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),m=p(a),f=r,h=m["".concat(l,".").concat(f)]||m[f]||c[f]||i;return a?n.createElement(h,o(o({ref:t},d),{},{components:a})):n.createElement(h,o({ref:t},d))}));function f(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=a.length,o=new Array(i);o[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:r,o[1]=s;for(var p=2;p{a.d(t,{Z:()=>o});var n=a(7294),r=a(6010);const i="tabItem_Ymn6";function o(e){let{children:t,hidden:a,className:o}=e;return n.createElement("div",{role:"tabpanel",className:(0,r.Z)(i,o),hidden:a},t)}},4866:(e,t,a)=>{a.d(t,{Z:()=>w});var n=a(3117),r=a(7294),i=a(6010),o=a(2466),s=a(6775),l=a(1980),p=a(7392),d=a(12);function c(e){return function(e){return r.Children.map(e,(e=>{if(!e||(0,r.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)}))?.filter(Boolean)??[]}(e).map((e=>{let{props:{value:t,label:a,attributes:n,default:r}}=e;return{value:t,label:a,attributes:n,default:r}}))}function m(e){const{values:t,children:a}=e;return(0,r.useMemo)((()=>{const e=t??c(a);return function(e){const t=(0,p.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,a])}function f(e){let{value:t,tabValues:a}=e;return a.some((e=>e.value===t))}function h(e){let{queryString:t=!1,groupId:a}=e;const n=(0,s.k6)(),i=function(e){let{queryString:t=!1,groupId:a}=e;if("string"==typeof t)return t;if(!1===t)return null;if(!0===t&&!a)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return a??null}({queryString:t,groupId:a});return[(0,l._X)(i),(0,r.useCallback)((e=>{if(!i)return;const t=new URLSearchParams(n.location.search);t.set(i,e),n.replace({...n.location,search:t.toString()})}),[i,n])]}function u(e){const{defaultValue:t,queryString:a=!1,groupId:n}=e,i=m(e),[o,s]=(0,r.useState)((()=>function(e){let{defaultValue:t,tabValues:a}=e;if(0===a.length)throw new Error("Docusaurus error: the component requires at least one children component");if(t){if(!f({value:t,tabValues:a}))throw new Error(`Docusaurus error: The has a defaultValue "${t}" but none of its children has the corresponding value. Available values are: ${a.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return t}const n=a.find((e=>e.default))??a[0];if(!n)throw new Error("Unexpected error: 0 tabValues");return n.value}({defaultValue:t,tabValues:i}))),[l,p]=h({queryString:a,groupId:n}),[c,u]=function(e){let{groupId:t}=e;const a=function(e){return e?`docusaurus.tab.${e}`:null}(t),[n,i]=(0,d.Nk)(a);return[n,(0,r.useCallback)((e=>{a&&i.set(e)}),[a,i])]}({groupId:n}),k=(()=>{const e=l??c;return f({value:e,tabValues:i})?e:null})();(0,r.useLayoutEffect)((()=>{k&&s(k)}),[k]);return{selectedValue:o,selectValue:(0,r.useCallback)((e=>{if(!f({value:e,tabValues:i}))throw new Error(`Can't select invalid tab value=${e}`);s(e),p(e),u(e)}),[p,u,i]),tabValues:i}}var k=a(2389);const g="tabList__CuJ",N="tabItem_LNqP";function b(e){let{className:t,block:a,selectedValue:s,selectValue:l,tabValues:p}=e;const d=[],{blockElementScrollPositionUntilNextRender:c}=(0,o.o5)(),m=e=>{const t=e.currentTarget,a=d.indexOf(t),n=p[a].value;n!==s&&(c(t),l(n))},f=e=>{let t=null;switch(e.key){case"Enter":m(e);break;case"ArrowRight":{const a=d.indexOf(e.currentTarget)+1;t=d[a]??d[0];break}case"ArrowLeft":{const a=d.indexOf(e.currentTarget)-1;t=d[a]??d[d.length-1];break}}t?.focus()};return r.createElement("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,i.Z)("tabs",{"tabs--block":a},t)},p.map((e=>{let{value:t,label:a,attributes:o}=e;return r.createElement("li",(0,n.Z)({role:"tab",tabIndex:s===t?0:-1,"aria-selected":s===t,key:t,ref:e=>d.push(e),onKeyDown:f,onClick:m},o,{className:(0,i.Z)("tabs__item",N,o?.className,{"tabs__item--active":s===t})}),a??t)})))}function y(e){let{lazy:t,children:a,selectedValue:n}=e;const i=(Array.isArray(a)?a:[a]).filter(Boolean);if(t){const e=i.find((e=>e.props.value===n));return e?(0,r.cloneElement)(e,{className:"margin-top--md"}):null}return r.createElement("div",{className:"margin-top--md"},i.map(((e,t)=>(0,r.cloneElement)(e,{key:t,hidden:e.props.value!==n}))))}function v(e){const t=u(e);return r.createElement("div",{className:(0,i.Z)("tabs-container",g)},r.createElement(b,(0,n.Z)({},e,t)),r.createElement(y,(0,n.Z)({},e,t)))}function w(e){const t=(0,k.Z)();return r.createElement(v,(0,n.Z)({key:String(t)},e))}},6287:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>l,default:()=>f,frontMatter:()=>s,metadata:()=>p,toc:()=>c});var n=a(3117),r=(a(7294),a(3905)),i=(a(4996),a(4866)),o=a(5162);const s={id:"configuration-file",sidebar_label:"TEv2 Config Files",date:20231129},l="Configuration Files for TEv2 tools",p={unversionedId:"specs/files/configuration-file",id:"specs/files/configuration-file",title:"Configuration Files for TEv2 tools",description:"Every TEv2 tool execution can be configured using a configuration file that specifies the parameters (arguments) that otherwise would need to be supplied on the command line. The file is supplied by using the command line parameter -c or --config , where `` is the path (including the filename).",source:"@site/docs/specs/files/90-configuration-file.md",sourceDirName:"specs/files",slug:"/specs/files/configuration-file",permalink:"/tev2-specifications/docs/specs/files/configuration-file",draft:!1,editUrl:"https://github.com/tno-terminology-design/tev2-specifications/blob/master/docs/specs/files/90-configuration-file.md",tags:[],version:"current",lastUpdatedBy:"Rieks",lastUpdatedAt:1711961297,formattedLastUpdatedAt:"Apr 1, 2024",sidebarPosition:90,frontMatter:{id:"configuration-file",sidebar_label:"TEv2 Config Files",date:20231129},sidebar:"tev2SideBar",previous:{title:"MRD (Machine Readable Dictionary)",permalink:"/tev2-specifications/docs/specs/files/mrd"},next:{title:"Specifications - Syntax",permalink:"/tev2-specifications/docs/categories/specs-syntax"}},d={},c=[],m={toc:c};function f(e){let{components:t,...a}=e;return(0,r.kt)("wrapper",(0,n.Z)({},m,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"configuration-files-for-tev2-tools"},"Configuration Files for TEv2 tools"),(0,r.kt)("p",null,"Every ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool")," execution can be configured using a configuration file that specifies the parameters (arguments) that otherwise would need to be supplied on the command line. The file is supplied by using the command line parameter ",(0,r.kt)("inlineCode",{parentName:"p"},"-c ")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"--config "),", where ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is the path (including the filename)."),(0,r.kt)("p",null,"The configuration file is in a ",(0,r.kt)("a",{parentName:"p",href:"https://yaml.org/spec/"},"YAML format"),". When the ",(0,r.kt)("inlineCode",{parentName:"p"},"-c")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"--config")," option is specified when calling a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/tev2-tool",title:"TEv2 Tool: any software application or utility designed to support and streamline various tasks related to terminology management following the TEv2 specifications."},"TEv2 tool"),", the tool attempts to read the specified file and evaluates all fields that are not in a specific section, as well as all fields that are in a tool-specific section. A field whose name is defined in the specifications for that tool will be interpreted. All other fields are ignored."),(0,r.kt)("p",null,"The options specified on the command line have precedence over the options specified in the configuration file. Similarly, the options specified in tool specific sections have precedence over the (general) options specified in the 'root' of the configuration file. The tool specific sections are specified in the configuration file by using the command line name of the tool as the section name."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Example configuration file"),"The following file has been used in the context of developing this documentation. Some options like file paths are relative to the directory from which the tools are called, which in this case is the `docs` directory.",(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'# TNO Terminology Design tools configuration file (yaml)\n\n## General\nscopedir: . # path of the scope directory where the SAF is located\nonNotExist: warn # the action in case an MRG was specified, but wasn\'t found in the SAF\noutput: . # (root) directory for output files to be written to\n\n## Machine Readable Glossary Tool\nmrgt:\n vsntag: # versiontag for which the MRG needs to be (re)generated. Leave empty to process all versions\n macros: # macros to be used for formPhrases\n "{ss}": ["", "s", "\'s", "(s)"]\n "{yies}": ["y", "y\'s", "ies"]\n\n## Human Readable Glossary Tool\nhrgt:\n interpreter: default # Type of interpreter, i.e., a regex, or a predefined type (`default`)\n converter: markdown-section-3 # Type of converter, i.e., a mustache/handlebars template, or a predefined type (`markdown-table-row, `markdown-section-2`, `markdown-section-3`)\n input:\n - "*gloss*.md"\n\n## Term Reference Resolution Tool\ntrrt:\n interpreter: default # Type of interpreter, i.e., a regex, or a predefined type (`default`, `alt`)")\n converter: html-hovertext-link # Type of converter, i.e., a mustache/handlebars template, or a predefined type (`markdown-link`, `html-link`, `html-hovertext-link`, `html-glossarytext-link`)")\n input: # glob pattern strings for files to be processed by the TRRT\n - "**/*.md"\n'))),(0,r.kt)("p",null,"Below, you can find all of the possible options you can specify in the various configuration sections. These match the parameters that can be specified on the command line. "),(0,r.kt)("p",null,"If a parameter is specified on the command line, it must be preceded by the ",(0,r.kt)("inlineCode",{parentName:"p"},"--")," (e.g., as in ",(0,r.kt)("inlineCode",{parentName:"p"},"--scopedir"),"), or the alternative short form can be used as described in the specifications of the individual tools."),(0,r.kt)("details",null,(0,r.kt)("summary",null,"Legend"),(0,r.kt)("p",null,"The columns in the following table are defined as follows:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Parameter"))," specifies the parameter and further specifications."),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Req'd"))," specifies whether (",(0,r.kt)("inlineCode",{parentName:"li"},"Y"),") or not (",(0,r.kt)("inlineCode",{parentName:"li"},"n"),") the parameter is required to be present when the tool is being called for actual processing (so not in case a ",(0,r.kt)("inlineCode",{parentName:"li"},"help")," or ",(0,r.kt)("inlineCode",{parentName:"li"},"version")," parameter is specified). If ",(0,r.kt)("inlineCode",{parentName:"li"},"Y"),", the parameter MUST either be present in the configuration file, or as a command line parameter."),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("strong",{parentName:"li"},(0,r.kt)("inlineCode",{parentName:"strong"},"Description"))," specifies the meaning of the ",(0,r.kt)("inlineCode",{parentName:"li"},"Value")," field, and other things you may need to know, e.g. why it is needed, a required syntax, etc."))),(0,r.kt)(i.Z,{defaultValue:"generic",values:[{label:"Generic",value:"generic"},{label:"MRG Import",value:"mrg-import"},{label:"MRGT",value:"mrgt"},{label:"HRGT",value:"hrgt"},{label:"TRRT",value:"trrt"}],mdxType:"Tabs"},(0,r.kt)(o.Z,{value:"generic",mdxType:"TabItem"},(0,r.kt)("p",null,"Parameters that can be used by most, if not all tools can be put both in tool-specific sections, or in the 'root' of the YAML file."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Generic Parameters"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"scopedir: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,r.kt)("td",{parentName:"tr",align:"left"},"Path of the scope directory where the SAF is located.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"onNotExist: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"The action in case something that is necessary for further processing didn't exist.")))),(0,r.kt)("p",null,"The ",(0,r.kt)("inlineCode",{parentName:"p"},"")," parameter can take the following values."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"th"},"")),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'throw'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"An error is thrown (an exception is raised), and processing will stop.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'warn'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is displayed (and logged) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'log'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is written to a log(file) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'ignore'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"Processing continues as if nothing happened."))))),(0,r.kt)(o.Z,{value:"mrg-import",mdxType:"TabItem"},(0,r.kt)("p",null,"Parameters that are specific to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrg-import",title:"MRG Import (Tool): is a tool in the TEv2 toolbox that is run within a particular Scope for the purpose of obtaining MRGs from other Scopes, as specified in the Scope's SAF, and putting them in the Scope's Glossarydir."},"MRG Import tool")," can be put in the YAML section ",(0,r.kt)("inlineCode",{parentName:"p"},"mrg-import"),"."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"MRG Import Parameters"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"onNotExist: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"The action in case an MRG file unexpectedly does not exist.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"prune: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"If ",(0,r.kt)("inlineCode",{parentName:"td"},"")," is ",(0,r.kt)("inlineCode",{parentName:"td"},"true"),", remove all ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/mrg",title:"Machine Readable Glossary: a Glossary for a particular (version of a) Terminology that is formatted in YAML, according to the TEv2 MRG Specifications, to enable automated processing and integration with software systems."},"MRG")," files in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/glossarydir",title:"Glossarydir: a directory within a Scopedir within which the different versions of its (Machine Readable and Human Readable) Glossaries are created and maintained."},"glossarydir")," where the scopetag is not administered in the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/files/saf",title:"Scope Administration File: a YAML file that contains essential data about a particular Scope (e.g., specifying where its Curated Texts, Glossaries etc. live), the relationships this Scope has with other Scopes, and the specifications of the different Terminologies that are Curated within that Scope. The SAF of a Scope is located in its Scopedir."},"SAF"),".")))),(0,r.kt)("p",null,"The ",(0,r.kt)("inlineCode",{parentName:"p"},"")," parameter can take the following values."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"th"},"")),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'throw'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"An error is thrown (an exception is raised), and processing will stop.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'warn'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is displayed (and logged) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'log'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is written to a log(file) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'ignore'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"Processing continues as if nothing happened."))))),(0,r.kt)(o.Z,{value:"mrgt",mdxType:"TabItem"},(0,r.kt)("p",null,"Parameters that are specific to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/mrgt",title:"Machine Readable Glossary Tool: a software tool designed to create, manage, and process Machine Readable Glossaries (MRGs), as Specified By TEv2."},"MRGT")," can be put in the YAML section ",(0,r.kt)("inlineCode",{parentName:"p"},"mrgt"),"."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Key"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"onNotExist: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"The action in case an MRG file unexpectedly does not exist.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"vsntag: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"Versiontag for which the MRG needs to be (re)generated.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"macros: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"A ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"map of form-phrase macros")," to be used to evaluate the ",(0,r.kt)("inlineCode",{parentName:"td"},"formPhrases")," field of a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/curated-text",title:"Curated Text: a text that documents a Concept or other Semantic Unit of a particular Party, and specifies, e.g., the Term(s) by which the Party refers thereto, its Definition, and any other relevant information."},"curated text"),".")))),(0,r.kt)("p",null,"The ",(0,r.kt)("inlineCode",{parentName:"p"},"")," parameter can take the following values."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"th"},"")),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'throw'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"An error is thrown (an exception is raised), and processing will stop.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'warn'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is displayed (and logged) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'log'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"A message is written to a log(file) and processing continues.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"'ignore'")),(0,r.kt)("td",{parentName:"tr",align:"left"},"Processing continues as if nothing happened.")))),(0,r.kt)("p",null,"The ",(0,r.kt)("inlineCode",{parentName:"p"},"")," parameter"),(0,r.kt)("p",null,"The ",(0,r.kt)("inlineCode",{parentName:"p"},"")," parameter is a (YAML) list of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro",title:"Form Phrase Macro: a sequence of characters (the macro name) that identifies a sequence (map) of character strings that specify typical variations of a Form Phrase, such as plural forms, possessie extensions, verb-conjugation forms, etc."},"form phrase macros")," (it is a [form phrase macro map(@)). "),(0,r.kt)("p",null,"Here is an example of the ",(0,r.kt)("inlineCode",{parentName:"p"},"mrgt")," section of the config file that contains a ",(0,r.kt)("a",{href:"/tev2-specifications/docs/terms/form-phrase-macro-map",title:"Form Phrase Macro Map: a list of Form Phrase Macros that the MRGT will use to expand Form Phrases as specified for Curated Texts into Form Phrases as specified for MRGs."},"macro map"),"."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-yaml"},'## Machine Readable Glossary Tool\nmrgt:\n vsntag: # versiontag of MRG to generate. Default: all MRGs\n macros: # macros to be used for formPhrases\n "{ss}": ["", "s", "\'s", "(s)"]\n "{yies}": ["y", "y\'s", "ies"]\n'))),(0,r.kt)(o.Z,{value:"hrgt",mdxType:"TabItem"},(0,r.kt)("p",null,"Parameters that are specific to the ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/tools/hrgt",title:"Human Readable Glossary Tool: a software tool designed to create, manage, and process Human Readable Glossaries (HRGs), as Specified By TEv2. HRGTs offer features for selecting Terms that are Curated within the Scope it is run in, or from other Scopes."},"hrgt")," can be put in the YAML section ",(0,r.kt)("inlineCode",{parentName:"p"},"hrgt"),":"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Req'd"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"output: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,r.kt)("td",{parentName:"tr",align:"left"},"(Root) directory for output files to be written.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"input: ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"Y"),(0,r.kt)("td",{parentName:"tr",align:"left"},"Glob pattern string for files to be processed by the HRGT.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"interpreter: or ")),(0,r.kt)("td",{parentName:"tr",align:"center"},"n"),(0,r.kt)("td",{parentName:"tr",align:"left"},"Type of ",(0,r.kt)("a",{href:"/tev2-specifications/docs/specs/syntax/mrg-refs",title:"MRGRef: a text that is Marked Up (in A Specific Way) so that it refers to a particular Terminology, as well as to a specific way for creating an associated HRG."},"MRGRef")," interpreter, i.e., a ",(0,r.kt)("a",{parentName:"td",href:"https://www.debuggex.com/cheatsheet/regex/pcre"},"(PCRE) regex"),", or a ",(0,r.kt)("a",{parentName:"td",href:"/docs/specs/syntax/mrg-refs#predefined-mrgref-interpreters"},"predefined type")," (",(0,r.kt)("inlineCode",{parentName:"td"},"default"),").")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("inlineCode",{parentName:"td"},"converter: