Add in stub for metadata documentation. #1171.

Author: sangwinc

doc/en/Authoring/Metadata.md

@@ -0,0 +1,3 @@
+# Question metadata
+
+STACK questions support flexible metadata.

doc/en/Authoring/index.md

@@ -17,6 +17,7 @@ A  "question" is the basic object in the system. The following table shows the f
 | [Inputs](Inputs/index.md)                                        | The inputs are the things, such as form boxes, with which the student actually interacts.
 | [Potential response trees](Potential_response_trees.md)    | These are the algorithms which establish the mathematical properties of the students' answers and generate feedback.
 | [Options](Question_options.md)                                      | Many behaviours can be changed with the options.
+| [Metadata](Metadata.md)                                      | STACK questions support flexible metadata.
 
 The authoring documentation also covers topics on:
 

doc/en/Developer/Development_track.md

@@ -12,6 +12,7 @@ Issues with [github milestone 4.13.0](https://github.com/maths/moodle-qtype_stac
 1. Remove all "cte" code from Maxima - mostly install.
 2. Support for Maxima 5.47.0, 5.48.0, and 5.49.0.  This includes a fix for issue #1281 from 5.48.0.
 3. Question tests can now test the whole route through a PRT, rather than just the final node.  This is a significant improvement on the ability to test questions.  This is back-compatible with older questions.
+4. Add in flexible [question metadata](../Authoring/Metadata.md).  This fixes issue #1171.
 
 --------------------------------------
 

doc/en/Developer/Future_plans.md

@@ -137,7 +137,6 @@ Basic reports now work.
 * Text based potential response trees (would allow for easier copying of complicated trees, etc).
 * Changes to preset feedback to certain answer tests which might be more appropriate for different audiences. Could a 'simplified' English language pack allow for this (future changes might allow this to be done on a question-by-question basis).
 * Check for potential issues with default correct/incorrect feedback for different languages (defaults can already be set on the server level by a Moodle administrator).
-* Metadata on language for questions.
 * Tools for language integrity (e.g. making it easier to identify what languages are in each question).
 * Making sure Maxima knows the intended language (will allow for Maxima code to choose from the available languages).
 * May want to have further discussions on how scores and penalties are handled (there is already a new feature in the latest version of STACK so that you can include functions in the "score" field.

doc/en/STACK_question_admin/Authoring_workflow.md

@@ -69,7 +69,11 @@ In theory one test case should be created for each anticipated response which ge
 
 When updating a PRT at this stage we would _expect_ test cases added in step 2 to fail.  This is reassuring as it indicates something significant has changed!  You can easily confirm the new behaviour of the testcase is now what is intended.
 
-### 6. Use data obtained from one cycle of attempts by students.
+### 6. Add accurate metadata.
+
+Check and add accurate [question metadata](../Authoring/Metadata.md).
+
+### 7. Use data obtained from one cycle of attempts by students.
 
 Rather than second-guess what students _might_ get wrong it is more effective to look at what they _do_.  See the section on [reporting](Reporting.md) for documentation on how to review students' answers.  When feedback/marks are delayed (e.g. online exam) this can be done between students taking the assessment and results being released.  If feedback/marks are immediate then better quality feedback can still be usefully added later.
 

doc/meta_en.json

@@ -463,6 +463,11 @@
         "description":"Information on writing STACK questions for several languages."
         },
         {
+        "file":"Metadata.md",
+        "title":"Question Metadata - STACK Documentation",
+        "description":"Information on STACK question metadata."
+        },
+        {
         "file":"Question_options.md",
         "title":"Options - STACK Documentation",
         "description":"Documentation for the Option section in a STACK question."