Merge pull request #592 from adam-vessey/7.x-1.5-hook-doc

Expand on documentation of hook_islandora_edit_datastream_registry().

islandora.api.php

@@ -361,9 +361,22 @@ function hook_cmodel_pid_islandora_datastream_purged(AbstractObject $object, $ds
  * @param AbstractObject $object
  *   The object to check.
  * @param string $dsid
- *   todo
+ *   A string indicating the datastream for which to get the registry.
+ *
+ * @return array
+ *   An array of associative arrays, each mapping:
+ *   - name: A string containg a human-readable name for the entry.
+ *   - url: A string containing the URL to which to the user will be routed.
  */
 function hook_islandora_edit_datastream_registry($object, $dsid) {
+  $routes = array();
+
+  $routes[] = array(
+    'name' => t('My Awesome Edit Route'),
+    'url' => "go/edit/here/{$object->id}/{$dsid}",
+  );
+
+  return $routes;
 }
 
 /**