add usage docs

Author: aaronsteers

airbyte_cdk/test/standard_tests/__init__.py

@@ -1,8 +1,31 @@
 # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
-"""Declarative test suites.
+'''FAST Airbyte Standard Tests
 
-Here we have base classes for a robust set of declarative connector test suites.
-"""
+This module provides a set of base classes for declarative connector test suites.
+The goal of this module is to provide a robust and extensible framework for testing Airbyte
+connectors.
+
+Example usage:
+
+```python
+# `test_airbyte_standards.py`
+from airbyte_cdk.test import standard_tests
+
+pytest_plugins = [
+    "airbyte_cdk.test.standard_tests.pytest_hooks",
+]
+
+
+class TestSuiteSourcePokeAPI(standard_tests.DeclarativeSourceTestSuite):
+    """Test suite for the source."""
+```
+
+Available test suites base classes:
+- `DeclarativeSourceTestSuite`: A test suite for declarative sources.
+- `SourceTestSuiteBase`: A test suite for sources.
+- `DestinationTestSuiteBase`: A test suite for destinations.
+
+'''
 
 from airbyte_cdk.test.standard_tests.connector_base import (
     ConnectorTestScenario,

airbyte_cdk/test/standard_tests/connector_base.py

@@ -28,7 +28,6 @@
 MANIFEST_YAML = "manifest.yaml"
 
 
-
 class ConnectorTestSuiteBase(abc.ABC):
     """Base class for connector test suites."""