docs(jira): show both client call forms in the class docstring

The class docstring still demonstrated the pre-syncify async call, which no
longer works as written. It now shows the async form with .aio() and the
blocking form under a plain `with`, and says which belongs where.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VKZrTNjjWVzTZUxDFbn4Nk

Signed-off-by: Niels Bantilan <niels.bantilan@gmail.com>

Author: cosmicBboy

plugins/jira/src/flyteplugins/jira/_client.py

@@ -102,13 +102,22 @@ def _simplify_issue(issue: dict[str, Any], base_url: str = "") -> dict[str, Any]
 class JiraClient:
     """Async client for the Jira Cloud REST API v3.
 
-    Use as an async context manager:
+    Every method has two call forms. Use the async one on an event loop — in
+    `async def` tasks, app handlers, and MCP tools:
 
     ```python
     from flyteplugins.jira import JiraClient
 
     async with JiraClient() as client:
-        issue = await client.get_issue("PROJ-123")
+        issue = await client.get_issue.aio("PROJ-123")
+    ```
+
+    Use the blocking one in plain `def` tasks and scripts. It parks the calling
+    thread until the call returns, so never reach for it on an event loop:
+
+    ```python
+    with JiraClient() as client:
+        issue = client.get_issue("PROJ-123")
     ```
 
     Args: