bump schema-salad version, document narrowing types

Author: mr-c

Makefile

@@ -34,7 +34,7 @@ COVBASE=coverage run --append
 
 # Updating the Major & Minor version below?
 # Don't forget to update setup.py as well
-VERSION=8.2.$(shell date +%Y%m%d%H%M%S --utc --date=`git log --first-parent \
+VERSION=8.3.$(shell date +%Y%m%d%H%M%S --utc --date=`git log --first-parent \
 	--max-count=1 --format=format:%cI`)
 
 ## all         : default task

schema_salad/metaschema/metaschema.yml

@@ -309,7 +309,8 @@ $graph:
       type: boolean?
       doc: |
         If true, this record is abstract and may be used as a base for other
-        records, but is not valid on its own.
+        records, but is not valid on its own. Inherited fields may be
+        re-specified to narrow their type.
 
     - name: extends
       type:
@@ -321,7 +322,7 @@ $graph:
         refScope: 1
       doc: |
         Indicates that this record inherits fields from one or more base records.
-
+        Inherited fields may be re-specified to narrow their type.
     - name: specialize
       type:
         - SpecializeDef[]?

schema_salad/metaschema/salad.md

@@ -9,6 +9,7 @@ Contributors:
 * The developers of Apache Avro
 * The developers of JSON-LD
 * Nebojša Tijanić <[email protected]>, Seven Bridges Genomics
+* Michael R. Crusoe, ELIXIR-DE
 
 # Abstract
 
@@ -86,6 +87,12 @@ specification, the following changes have been made:
   is poorly documented, not included in conformance testing,
   and not widely supported.
 
+## Introduction to v1.2
+
+This is the fourth version of the Schema Salad specification. It was created to
+ease the development of extensions to CWL v1.2. The only change is that
+inherited records can narrow the types of fields.
+
 ## References to Other Specifications
 
 **Javascript Object Notation (JSON)**: http://json.org

schema_salad/tests/metaschema-pre.yml

@@ -90,7 +90,7 @@
 
 setup(
     name="schema-salad",
-    version="8.2",  # update the VERSION prefix in the Makefile as well 🙂
+    version="8.3",  # update the VERSION prefix in the Makefile as well 🙂
     description="Schema Annotations for Linked Avro Data (SALAD)",
     long_description=open(README).read(),
     long_description_content_type="text/x-rst",