Merge pull request #3 from lambda-feedback/tr158-demonstrate-responses-per-student-per-response-area

Added description of how to display number of submitted responses to …

Author: KarlLundengaard

app/docs/dev.md

@@ -14,6 +14,17 @@ This function requires a parameter to function properly:
 
 ```
 
+When a student submits a response to a response area the number of previously submitted responses submitted to the same response area byt the same student will be sent to the evaluation function. The following format is used:
+```json
+{
+    "submission_context": {
+        "submissions_per_student_per_response_area": # non-negative integer that represent the number of previously processed responses
+    }
+}
+```
+
+The total number of submitted responses (i.e. the number of processed response + 1) can be displayed in the feedback by setting adding a field named `display_submission_count` to `params` and set its value to true.
+
 ## Outputs
 Outputs to the `grade` command will feature:
 
@@ -34,17 +45,22 @@ Outputs to the `grade` command will feature:
 ```python
 {
   "answer": "hydrophobic",
-  "response" "hydrophobic",
+  "response": "hydrophobic",
   "params": {
     "type": "str"
   }
 }
 ```
 
+### Displaying number of submitted responses in the feedback
+
 ```python
 {
-  "example": {
-    "Something": "something"
+  "answer": 1,
+  "response": 1,
+  "params": {
+    "type": "int",
+    "display_submission_count": true
   }
 }
 ```