doc update

Author: forman

docs/api.md

@@ -31,7 +31,7 @@ This chapter provides a plain reference for the XRLint Python API.
   [Processor][xrlint.processor.Processor] comprising processor metadata
   [ProcessorMeta][xrlint.processor.ProcessorMeta] 
   and the processor operation [ProcessorOp][xrlint.processor.ProcessorOp].
-  Decorator [define_processor][xrlint.rule.define_rule] allows defining 
+  Decorator [define_processor][xrlint.processor.define_processor] allows defining 
   processors.
 - The `result` module provides data classes that are used to 
   represent validation results:

xrlint/plugin.py

@@ -56,6 +56,12 @@ def define_rule(
         docs_url: str | None = None,
         op_class: Type[RuleOp] | None = None,
     ) -> Callable[[Any], Type[RuleOp]] | None:
+        """Decorator to define a plugin rule.
+        The method registers a new rule with the plugin.
+
+        Refer to [define_rule][xrlint.rule.define_rule]
+        for details.
+        """
         return define_rule(
             name=name,
             version=version,
@@ -73,6 +79,12 @@ def define_processor(
         version: str = "0.0.0",
         op_class: Type[ProcessorOp] | None = None,
     ):
+        """Decorator to define a plugin processor.
+        The method registers a new processor with the plugin.
+
+        Refer to [define_processor][xrlint.processor.define_processor]
+        for details.
+        """
         return define_processor(
             name=name,
             version=version,