Address code review feedback on documentation

- Update test comment with actual reproduction repo link
- Add clarification about 'properties' keyword in SCHEMA_KEYWORDS
- Improve documentation for better understanding

Co-authored-by: DannyvdSluijs <618940+DannyvdSluijs@users.noreply.github.com>

Author: Copilot

src/JsonSchema/SchemaStorage.php

@@ -16,7 +16,10 @@ class SchemaStorage implements SchemaStorageInterface
 
     /**
      * JSON Schema keywords that indicate an object is a schema with validation rules,
-     * not a pure container (like definitions, properties)
+     * not a pure container (like the value of definitions or properties keywords).
+     * 
+     * Note: 'properties' is a schema keyword (e.g., {"type": "object", "properties": {...}}).
+     * The properties *container* (the value) won't have these keywords, so it won't match.
      */
     private const SCHEMA_KEYWORDS = [
         'type', 'properties', 'items', 'additionalProperties', 'additionalItems',

tests/SchemaStorageTest.php

@@ -308,7 +308,8 @@ public function testNoDoubleResolve(): void
 
     /**
      * Test that definitions named 'enum' or 'const' are properly resolved
-     * Regression test for: https://github.com/jsonrainbow/json-schema/issues/XXX
+     * Regression test for UnresolvableJsonPointerException when definitions are named 'enum' or 'const'
+     * Related to: https://github.com/mxr576/oas-validation-issue-on-v6
      */
     public function testDefinitionNamedEnumIsResolved(): void
     {