diff -r a9f1ba451247 -r 5c878a53d3ed data/dictionary.xsd
--- a/data/dictionary.xsd Mon Jun 22 21:59:38 2020 +0200
+++ b/data/dictionary.xsd Mon Jun 22 23:11:14 2020 +0200
@@ -25,8 +25,18 @@
+
-
+
+
+
+ Concept is an item of a dictionary – a term.
+ If an abbreviation or a word have two different meanings
+ it is two different concepts i.e. different meaning should not be mixed in a single concept.
+ Example: CLI (command-line interface) and CLI (call level interface) are two different concepts.
+
+
+
@@ -37,13 +47,29 @@
-
+
+
+
+ Tag IDs are not globally unique
+ (they are short and simple, so they can be easily added to concepts while editing the document by hand)
+ so when the disctionary is merged into another XML document, theese IDs should be prefixed e.g. with the dictionary ID.
+
+
+
+
+
+
+ This should be globally unique ID of the concept.
+ Concepts shared among multiple dictionaries should have same ID.
+
+
+
@@ -77,5 +103,18 @@
+
+
+
+
+ UUID, but must start with a letter, to comply with XML ID rules;
+ use e.g. uuidgen | grep ^[a-f];
+ Never reuse the ID if one chapter/item is removed and another with different meaning is added.
+
+
+
+
+
+
\ No newline at end of file