Add taxonomies related documentation

Author: danielfdsilva

docs/CONFIGURATION.md

@@ -17,6 +17,15 @@ datasets: './datasets/*.data.mdx'
 discoveries: './discoveries/*.discoveries.mdx'
 ```
 
+### Taxonomy Index file
+
+Links to a `json` or `yml` file containing a list of [taxonomies](./TAXONOMY.md) to be used in the app.  
+
+The default configuration is:
+```js
+  taxonomiesIndex: './taxonomies.yml',
+```
+
 ### Page overrides
 To adapt the Veda dashboard to the individual needs of you instance, some content/component overrides are provided. These overrides allow you to alter certain parts of the application, or inject code without having to fork the UI part of veda.
 

docs/CONTENT.md

@@ -48,6 +48,7 @@ description: string
 media: Media
 
 thematics: string[]
+sources: string[]
 featured: boolean
 
 layers: Layer[]
@@ -90,14 +91,25 @@ Image to identify this resource. See [media.md](./frontmatter/media.md).
 
 **thematics**  
 `string[]`  
-List of thematic areas this dataset belongs to.
+List of thematic areas this dataset belongs to.  
+Must be a list of ids as defined in the [taxonomies index file](./TAXONOMY.md).
 Example:
 ```yaml
 thematics:
   - covid-19
   - agriculture
 ```
 
+**sources**  
+`string[]`  
+List of sources for this dataset.  
+Must be a list of ids as defined in the [taxonomies index file](./TAXONOMY.md).
+Example:
+```yaml
+sources:
+  - devseed
+```
+
 **featured**  
 `boolean`  
 Whether this dataset is featured
@@ -175,6 +187,7 @@ media: Media
 pubDate: string
 
 thematics: string[]
+sources: string[]
 featured: boolean
 
 related: Related[]
@@ -217,13 +230,24 @@ Publication date for this discovery. Should be in YYYY-MM-DD format.
 **thematics**  
 `string[]`  
 List of thematic areas this discovery belongs to.
+Must be a list of ids as defined in the [taxonomies index file](./TAXONOMY.md).
 Example:
 ```yaml
 thematics:
   - covid-19
   - agriculture
 ```
 
+**sources**  
+`string[]`  
+List of sources for this dataset.  
+Must be a list of ids as defined in the [taxonomies index file](./TAXONOMY.md).
+Example:
+```yaml
+sources:
+  - devseed
+```
+
 **featured**  
 `boolean`  
 Whether this discovery is featured

docs/TAXONOMY.md

@@ -0,0 +1,59 @@
+# Content
+
+- [Content](#content)
+  - [Taxonomy Index file](#taxonomy-index-file)
+  - [Using a taxonomy in a content type](#using-a-taxonomy-in-a-content-type)
+
+Some of veda content types properties are taxonomies.  
+These are identified by their id and linked to the full taxonomy definition on the taxonomy index file.
+
+##  Taxonomy Index file
+
+The location of the taxonomy index file is defined through `veda.config.js` and can either be a `json` or `yml` file.  
+
+The different taxonomies are defined as a id keyed list. Each taxonomy item must, at least, have an `id` and `name` properties.  
+
+Example:
+```yml
+# Key of the taxonomy is thematics.
+thematics:
+  - id: water
+    name: Water Quality
+  - id: air
+    name: Air Quality
+
+# Key of the taxonomy is sources.
+sources:
+  - id: devseed
+    name: Development Seed
+    url: https://developmentseed.org
+```
+
+## Using a taxonomy in a content type
+
+To link a content type to a taxonomy, you need to list the different item's `id` under the taxonomy key on your content type.
+
+Example adding `sources` to a dataset:  
+```yaml
+---
+id: my-data
+name: My example dataset
+description: A dataset with sources
+
+sources:
+  - devseed
+  - another-source
+
+layers: # ...
+---
+
+<Block>
+  <Prose>
+    ## This is a Dataset
+
+    Once upon a time there was a content string
+  </Prose>
+</Block>
+```
+
+If you want to use a taxonomy item that doesn't exist (e.g. a new source) you will need to add it to the taxonomy index file.

taxonomies.yml

@@ -0,0 +1,19 @@
+thematics:
+  - id: eis
+    name: EIS
+  - id: air-quality
+    name: Air Quality
+  - id: water-quality
+    name: Water Quality
+  - id: environmental-justice
+    name: Environmental Justice
+  - id: covid-19
+    name: Covid 19
+  - id: agriculture
+    name: Agriculture
+  - id: biomass
+    name: Biomass
+
+# sources:
+#   - id: eis
+#     name: EIS

veda.config.js

@@ -9,6 +9,11 @@ module.exports = {
    */
   discoveries: './discoveries/*.discoveries.mdx',
 
+  /**
+   * File path for the taxonomy index file.
+   */
+  taxonomiesIndex: './taxonomies.yml',
+
   // App component and content overrides.
   // See docs/CONFIGURATION.md for more information.
   pageOverrides: {