diff --git a/openapi/components/schemas/grade.yaml b/openapi/components/schemas/grade.yaml
index 1ce2a68..07b6a7b 100644
--- a/openapi/components/schemas/grade.yaml
+++ b/openapi/components/schemas/grade.yaml
@@ -11,7 +11,7 @@ properties:
   name:
     type: string
     description: >
-      Unique but short name of the grade, like "Excellent" or "To reject".
+      Unique and short name of the grade, like "Excellent" or "To reject".
     example: Good
   description:
     type: string
diff --git a/openapi/components/schemas/poll-properties.yaml b/openapi/components/schemas/poll-properties.yaml
index e9c2874..cced618 100644
--- a/openapi/components/schemas/poll-properties.yaml
+++ b/openapi/components/schemas/poll-properties.yaml
@@ -1,3 +1,4 @@
+# These properties are shared between poll schemes
 id:
   readOnly: true
   type: string