franta-hg@0: franta-hg@1: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@5: franta-hg@152: franta-hg@5: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: Concept is an item of a dictionary – a term. franta-hg@152: If an abbreviation or a word have two different meanings franta-hg@152: it is two different concepts i.e. different meaning should not be mixed in a single concept. franta-hg@152: Example: CLI (command-line interface) and CLI (call level interface) are two different concepts. franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: Tag IDs are not globally unique franta-hg@152: (they are short and simple, so they can be easily added to concepts while editing the document by hand) franta-hg@152: so when the disctionary is merged into another XML document, theese IDs should be prefixed e.g. with the dictionary ID. franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@5: franta-hg@0: franta-hg@0: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: This should be globally unique ID of the concept. franta-hg@152: Concepts shared among multiple dictionaries should have same ID. franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@0: franta-hg@0: franta-hg@6: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@6: franta-hg@6: franta-hg@6: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@0: franta-hg@6: franta-hg@6: franta-hg@6: franta-hg@6: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: UUID, but must start with a letter, to comply with XML ID rules; franta-hg@152: use e.g. uuidgen | grep ^[a-f]; franta-hg@152: Never reuse the ID if one chapter/item is removed and another with different meaning is added. franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@152: franta-hg@0: franta-hg@0: