add link to glossary

q

@@ -0,0 +1,35 @@
+
+src/common-principles.md
+
+──────────────┐
+514: Example: │
+──────────────┘
+│ 514│```                                                        │ 514│```
+│ 515│                                                           │ 515│
+│ 516│Each level can be described with a string as in the exampl↴│ 516│Each level can be described with a string as in the exampl↴
+│    │                                                  …e above,│    │                                                  …e above,
+│ 517│or with an object containing the fields `Description` and ↴│ 517│or with an object containing the fields [`Description`](..↵
+│    │                                                 …`TermURL`│    │/glossary.md#description-metadata)
+│    │                                                           │ 518│and [`TermURL`](../glossary.md#termurl-metadata)
+│ 518│like in the example below.                                 │ 519│like in the example below.
+│ 519│                                                           │ 520│
+│ 520│```JSON                                                    │ 521│```JSON
+
+src/schema/objects/metadata.yaml
+
+───────────────┐
+3371: TermURL: │
+───────────────┘
+│3371│  name: TermURL                                            │3371│  name: TermURL
+│3372│  display_name: TermURL                                    │3372│  display_name: TermURL
+│3373│  description: |                                           │3373│  description: |
+│3374│    URL pointing to a formal definition of this type of da↴│3374│    URL pointing to a formal definition of this type of da↵
+│    │                                         …ta in an ontology│    │ta in an ontology available on the web.
+│3375│    available on the web.                                  │    │
+│    │                                                           │3375│    For example: https://www.ncbi.nlm.nih.gov/mesh/6800829↴
+│    │                                                           │    │                                             …7 for "male".
+│3376│  type: string                                             │3376│  type: string
+│    │                                                           │3377│  format: uri
+│3377│TimeZero:                                                  │3378│TimeZero:
+│3378│  name: TimeZero                                           │3379│  name: TimeZero
+│3379│  display_name: Time Zero                                  │3380│  display_name: Time Zero

src/common-principles.md

@@ -514,7 +514,8 @@ Example:
 ```
 
 Each level can be described with a string as in the example above,
-or with an object containing the fields `Description` and `TermURL`
+or with an object containing the fields [`Description`](../glossary.md#description-metadata)
+and [`TermURL`](../glossary.md#termurl-metadata)
 like in the example below.
 
 ```JSON

src/schema/objects/metadata.yaml

@@ -3371,9 +3371,10 @@ TermURL:
   name: TermURL
   display_name: TermURL
   description: |
-    URL pointing to a formal definition of this type of data in an ontology
-    available on the web.
+    URL pointing to a formal definition of this type of data in an ontology available on the web.
+    For example: https://www.ncbi.nlm.nih.gov/mesh/68008297 for "male".
   type: string
+  format: uri
 TimeZero:
   name: TimeZero
   display_name: Time Zero