Add description field #3

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - The country can be an ISO 3166-1 country code
+- New field `description`
 
 ### Changed
 

README.md

@@ -20,6 +20,7 @@ which itself is inspired by [ISO 19115](https://www.iso.org/standard/53798.html)
 ## Fields
 
 The fields in the table below can be used in these parts of STAC documents:
+
 - [x] Catalogs
 - [x] Collections
 - [x] Item Properties (incl. Summaries in Collections)
@@ -41,6 +42,7 @@ Either the field `name` or the field `organization` must be provided (or both).
 | organization        | string                               | **REQUIRED if `name` is missing**.Organization/affiliation of the contact. |
 | identifier          | string                               | A value uniquely identifying a contact. |
 | position            | string                               | The name of the role or position of the responsible person taken from the organization's formal organizational hierarchy or chart. |
+| description         | string                               | Detailed multi-line description to fully explain the STAC entity. [CommonMark 0.29](https://commonmark.org/) syntax MAY be used for rich text representation. |
 | logo                | [Link Object](#link-object)          | Graphic identifying a contact. The link relation must be `icon` and the media type must be an image media type. |
 | phones              | \[[Info Object](#info-object)]       | Telephone numbers at which contact can be made. |
 | emails              | \[[Info Object](#info-object)]       | Email address at which contact can be made. |

examples/collection.json

@@ -12,6 +12,7 @@
     {
       "name": "John Doe",
       "position": "CEO",
+      "description": "John Doe is the CEO of Doe Chemicals, overseeing all operations and strategic direction.",
       "organization": "Doe Chemicals",
       "logo": {
         "href": "https://doe.com/images/logo.png",
@@ -62,6 +63,7 @@
     },
     {
       "organization": "Doe Chemicals - Support Team",
+      "name": "English and German speaking support available",
       "logo": {
         "href": "https://doe.com/images/logo.png",
         "rel": "icon",

json-schema/schema.json

@@ -117,6 +117,10 @@
               "organization": {
                 "type": "string"
               },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
               "logo": {
                 "allOf": [
                   {