Review normative and non-normative words in schema, open-contracting/ocds-extensions#101

Author: jpmckinney

README.md

@@ -60,6 +60,10 @@ Report issues for this extension in the [ocds-extensions repository](https://git
 
 ## Changelog
 
+### Unreleased
+
+* Review normative and non-normative words
+
 ### v1.1.4
 
 * Remove Sphinx directives from readme

release-schema.json

@@ -40,7 +40,7 @@
         },
         "author": {
           "title": "Question author",
-          "description": "The identifier and name of the party asking this question. Questioners may be listed in the parties array with a role of 'enquirer'. Procurement policies vary on whether or not the identity of those asking questions should be disclosed, or at which stage this information may be disclosed. When the identity of the questioner cannot be disclosed leave the author section blank. Display systems should interpret this as an anonymous question.",
+          "description": "The party asking this question. The corresponding entry in the `parties` array should have 'enquirer' in its `roles` array. Procurement policies vary on whether or not the identity of those asking questions is disclosed, or at which stage this information is disclosed.",
           "$ref": "#/definitions/OrganizationReference"
         },
         "title": {
@@ -94,7 +94,7 @@
         },
         "threadID": {
           "title": "Thread identifier",
-          "description": "If this question and answer forms part of a discussion thread (e.g. the question is a follow up to a previous answer) an optional thread identifier can be used to associate together multiple enquiries.",
+          "description": "If this question and answer forms part of a discussion thread (e.g. the question is a follow-up to a previous answer) a thread identifier can be used to associate multiple enquiries.",
           "type": [
             "string",
             "null"