docs: add OpenAPI-first wiki (overview, components, use cases for templates/client/codegen, design, security, error handling, testing) and refresh lib docs index

openapi_first/client.py

@@ -50,6 +50,20 @@ class OpenAPIClient:
     """
     OpenAPI-first HTTP client (`httpx`-based).
 
+    Args:
+        spec (dict[str, Any]):
+            Parsed OpenAPI 3.x specification.
+        base_url (str | None):
+            Base URL of the target service. If omitted, the first entry in the
+            OpenAPI `servers` list is used.
+        client (httpx.Client | None):
+            Optional preconfigured httpx client instance.
+
+    Raises:
+        OpenAPIClientError:
+            If no servers are defined, spec has no paths, operationIds are
+            missing/duplicate, or required parameters are missing.
+
     Notes:
         **Responsibilities:**
 
@@ -92,21 +106,6 @@ class OpenAPIClient:
         base_url: str | None = None,
         client: httpx.Client | None = None,
     ) -> None:
-        """
-        Initialize the OpenAPI client.
-
-        Args:
-            spec (dict[str, Any]):
-                Parsed OpenAPI 3.x specification.
-            base_url (str | None):
-                Base URL of the target service. If omitted, the first entry in the OpenAPI `servers` list is used.
-            client (httpx.Client | None):
-                Optional preconfigured httpx client instance.
-
-        Raises:
-            OpenAPIClientError:
-                If no servers are defined, spec has no paths, operationIds are missing/duplicate, or required parameters are missing.
-        """
         self.spec = spec
         self.base_url = base_url or self._resolve_base_url(spec)
         self.client = client or httpx.Client(base_url=self.base_url)