model: Resource: Document raised exceptions for advanced operations

Author: davidfstr

src/crystal/model.py

@@ -3388,6 +3388,9 @@ def try_normalize_url(self) -> bool:
         """
         Tries to alter this resource's URL to be in normal form,
         unless there is already an existing resource with that URL.
+        
+        Raises:
+        * ProjectReadOnlyError
         """
         new_url = self.normalized_url
         if new_url == self._url:
@@ -3398,6 +3401,9 @@ def _try_alter_url(self, new_url: str) -> bool:
         """
         Tries to alter this resource's URL to new specified URL,
         unless there is already an existing resource with that URL.
+        
+        Raises:
+        * ProjectReadOnlyError
         """
         project = self.project  # cache
 
@@ -3419,6 +3425,11 @@ def _try_alter_url(self, new_url: str) -> bool:
 
     # NOTE: Only used from a Python REPL at the moment
     def delete(self) -> None:
+        """
+        Raises:
+        * ProjectReadOnlyError
+        * ValueError -- if this resource is referenced by a RootResource
+        """
         project = self.project
 
         if project.readonly: