Bug 32942: (QA follow-up) Document possible values

Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
(cherry picked from commit 54c8aa9471)
Signed-off-by: Fridolin Somers <fridolin.somers@biblibre.com>

api/v1/swagger/definitions/suggestion.yaml

@@ -64,7 +64,16 @@ properties:
     description: date the suggestion was last modified
   status:
     type: string
-    description: Suggestion status
+    description: |
+      Suggestion status. Possible values are:
+
+      * `ASKED`
+      * `CHECKED`
+      * `ACCEPTED`
+      * `REJECTED`
+      * `ORDERED`
+      * `AVAILABLE`
+      * Values from the `SUGGEST_STATUS` av cateogry
   note:
     type:
       - string