Chore: Update docs for airbyte.logs (#352)

Author: aaronsteers

airbyte/__init__.py

@@ -107,6 +107,7 @@
 - **`airbyte.exceptions`** - Definitions of all exception and warning classes used in PyAirbyte.
 - **`airbyte.experimental`** - Experimental features and utilities that do not yet have a stable
     API.
+- **`airbyte.logs`** - Logging functionality and configuration.
 - **`airbyte.records`** - Internal record handling classes.
 - **`airbyte.results`** - Documents the classes returned when working with results from
     `Source.read` and `Destination.write`
@@ -130,6 +131,7 @@
     documents,
     exceptions,  # noqa: ICN001  # No 'exc' alias for top-level module
     experimental,
+    logs,
     records,
     results,
     secrets,
@@ -159,6 +161,7 @@
     "documents",
     "exceptions",
     "experimental",
+    "logs",
     "records",
     "registry",
     "results",

airbyte/logs.py

@@ -1,5 +1,13 @@
 # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
-"""PyAirbyte Logging Configuration."""
+"""PyAirbyte Logging features and related configuration.
+
+By default, PyAirbyte main logs are written to a file in the `AIRBYTE_LOGGING_ROOT` directory, which
+defaults to a system-created temporary directory. PyAirbyte also maintains connector-specific log
+files within the same directory, under a subfolder with the name of the connector.
+
+PyAirbyte supports structured JSON logging, which is disabled by default. To enable structured
+logging in JSON, set `AIRBYTE_STRUCTURED_LOGGING` to `True`.
+"""
 
 from __future__ import annotations