doc: improve docstring in web.views.basecontrollers

cubicweb/server/hook.py

@@ -803,7 +803,7 @@ class Operation(object):
         return -(i + 1)
 
     def handle_event(self, event):
-        """delegate event handling to the opertaion"""
+        """delegate event handling to the operation"""
         getattr(self, event)()
 
     def precommit_event(self):

cubicweb/web/views/basecontrollers.py

@@ -203,6 +203,16 @@ def _validation_error(req, ex):
 
 
 def _validate_form(req, vreg):
+    """
+    helper function for FormValidatorController.publish()
+
+    return (status, args, entity) that will be passed as argument
+    result to `cubicweb.edition.js:handleFormValidationResult(..., result, ...)`
+
+    status: bool True if valid else False
+    args: target location if status is True else error message
+    entity: entity being edited
+    """
     # XXX should use the `RemoteCallFailed` mechanism
     try:
         ctrl = vreg["controllers"].select("edit", req=req)