Add Event Writer docstrings and industrial section to block docs (#2214)

* Add Event Writer docstrings and industrial section to block docs (#ENT-1106)

- Add docstrings to BlockManifest, EventWriterSinkBlockV1, and run() so
  mkdocstrings renders content on the API reference page
- Add "industrial" entry to BLOCK_SECTIONS so industrial blocks (Event
  Writer, OPC Writer, MQTT Writer, PLC Ethernet/IP, PLC Modbus) appear
  in the workflow block docs nav and index

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Move Event Writer block from industrial to data_storage section

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Trim Event Writer docstrings to match PLC block style

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* List Event Writer in both data_storage and industrial doc sections

Adds additional_sections support to build_block_docs.py so a block can
appear in multiple doc sections. Event Writer uses this to show up under
both Data Storage (its primary section) and Industrial.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Use industrial section for Event Writer, drop additional_sections logic

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>

Author: rvirani1

development/docs/build_block_docs.py

@@ -249,6 +249,11 @@ def render_template(template_name, **kwargs):
             "title": "Advanced",
             "id": "advanced",
             "colorScheme": "orange"
+        },
+        {
+            "title": "Industrial",
+            "id": "industrial",
+            "colorScheme": "gray"
         }
     ]
 

inference/enterprise/workflows/enterprise_blocks/sinks/event_writer/v1.py

@@ -95,6 +95,14 @@
 
 
 class BlockManifest(WorkflowBlockManifest):
+    """Manifest for the Event Writer sink block.
+
+    Sends structured events to the Event Ingestion Service via its v2 API.
+    Each event includes a schema (quality_check, inventory_count, safety_alert,
+    or custom), schema-specific data, one image entry with optional annotations,
+    and optional flat key-value custom metadata.
+    """
+
     model_config = ConfigDict(
         json_schema_extra={
             "name": "Event Writer",
@@ -294,6 +302,13 @@ def get_execution_engine_compatibility(cls) -> Optional[str]:
 
 
 class EventWriterSinkBlockV1(WorkflowBlock):
+    """Sends structured events to the Event Ingestion Service via its v2 API.
+
+    Supports fire-and-forget (default) or synchronous execution modes.
+    In fire-and-forget mode the HTTP request runs in the background and
+    ``event_id`` will be empty. In synchronous mode the block waits for
+    the response and returns the created ``event_id``.
+    """
 
     def __init__(
         self,
@@ -336,6 +351,19 @@ def run(
         instance_segmentations: Optional[Any] = None,
         keypoint_detections: Optional[Any] = None,
     ) -> BlockResult:
+        """Build and send a v2 event to the Event Ingestion Service.
+
+        Args:
+            event_ingestion_url (str): Base URL of the Event Ingestion Service.
+            event_schema (str): One of 'quality_check', 'inventory_count', 'safety_alert', or 'custom'.
+            output_image (WorkflowImageData): The output/visualization image sent as the primary display image.
+            fire_and_forget (bool): When True the request runs in the background and event_id will be empty.
+            disable_sink (bool): When True the block is skipped entirely.
+            request_timeout (int): HTTP request timeout in seconds.
+
+        Returns:
+            dict: A dictionary with ``error_status`` (bool), ``event_id`` (str), and ``message`` (str).
+        """
         if disable_sink:
             return {
                 "error_status": False,