diff --git a/content/en/docs/reference/score-spec-reference.md b/content/en/docs/reference/score-spec-reference.md
index 99da5b74..c0ef12a7 100644
--- a/content/en/docs/reference/score-spec-reference.md
+++ b/content/en/docs/reference/score-spec-reference.md
@@ -83,24 +83,24 @@ resources:
 **`resource-name`**: a required property that specifies the resource name.
 
 - **Type**: string.
-- **Constraints**: alphanumeric string.
+- **Constraints**: alphanumeric characters and dashes "-".
 
 **`metadata`**: an optional property that specifies additional resource metadata.
 
 - **`Type`**: object.
   - **`annotations`**: an optional property that specifies metadata annotations.
     - **`Type`**: object.
-    - **`Constraints`**: alphanumeric string key-value pairs.
+    - **`Constraints`**: key-value pairs with alphanumeric characters and dashes "-".
 
 `type`: specifies the resource type.
 
 - **Type**: string.
-- **Constraints**: alphanumeric string.
+- **Constraints**: alphanumeric characters and dashes "-".
 
-`class`: a specialisation of the resource type. For example, a workload that needs an externally accessible resource might set the class to external while the workload that requires an encrypted resource might have a class of sensitive.
+`class`: a specialisation of the resource type. For example, a workload that needs an externally accessible storage bucket might set the class to external while the workload that requires an encrypted resource might have a class of sensitive.
 
 - **Type**: string.
-- **Constraints**: alphanumeric string.
+- **Constraints**: alphanumeric characters and dashes "-".
 
 ### Reserved resource types