Rename "jsonPointer" to "reference" to better describe what it actual is

src/ErrorCatalog.php

@@ -42,7 +42,7 @@ public function addItem(ErrorCatalogItem $error)
 
     /**
      * @param $name
-     * @return ErrorCatalogItem
+     * @return ErrorCatalogItem|null
      */
     public function getItem($name)
     {
@@ -51,5 +51,7 @@ public function getItem($name)
                 return $error;
             }
         }
+
+        return null;
     }
 }

src/ErrorCatalogItem.php

@@ -65,11 +65,11 @@ public function getIssueById($id)
         return $return;
     }
 
-    public function getIssueByJsonPointer($jsonPointer)
+    public function getIssueByReference($reference)
     {
         $return = [];
         foreach ($this->issues as $issue) {
-            if ($issue->getJsonPointer() == $jsonPointer) {
+            if ($issue->getReference() == $reference) {
                 $return[] = $issue;
             }
         }

src/ErrorSpecIssue.php

@@ -10,32 +10,47 @@ class ErrorSpecIssue
     protected $id;
 
     /**
-     * @var string The JSON pointer to identify the issue
+     * @var string A reference to identify the issue by. Can be used to retrieve the issue but normally not shown in the catalog
      */
-    protected $jsonPointer;
+    protected $reference;
 
     /**
      * @var string $issue Use String Formatter syntax to format the issue as a parameterized string. Localize the string.
      */
     protected $issue;
 
-    public function __construct($id, $jsonPointer, $issue)
+    /**
+     * ErrorSpecIssue constructor.
+     * @param string $id
+     * @param string $reference
+     * @param string $issue
+     */
+    public function __construct($id, $reference, $issue)
     {
         $this->id = $id;
-        $this->jsonPointer = $jsonPointer;
+        $this->reference = $reference;
         $this->issue = $issue;
     }
 
+    /**
+     * @return string
+     */
     public function getId()
     {
         return $this->id;
     }
 
-    public function getJsonPointer()
+    /**
+     * @return string
+     */
+    public function getReference()
     {
-        return $this->jsonPointer;
+        return $this->reference;
     }
 
+    /**
+     * @return string
+     */
     public function getIssue()
     {
         return $this->issue;