tidy up cli help text declarations

Author: aaronsteers

airbyte_cdk/cli/airbyte_cdk/__init__.py

@@ -49,7 +49,7 @@
 
 
 @click.group(
-    help=__doc__.replace("\n", "\n\n"),  # Workaround to format help text correctly
+    help=__doc__.replace("\n", "\n\n"),  # Render docstring as help text (markdown)
     invoke_without_command=True,
 )
 @click.option(

airbyte_cdk/cli/airbyte_cdk/_connector.py

@@ -88,7 +88,10 @@
 '''
 
 
-@click.group(name="connector")
+@click.group(
+    name="connector",
+    help=__doc__.replace("\n", "\n\n"),  # Render docstring as help text (markdown)
+)
 def connector_cli_group() -> None:
     """Connector related commands."""
     pass

airbyte_cdk/cli/airbyte_cdk/_image.py

@@ -1,10 +1,19 @@
 # Copyright (c) 2025 Airbyte, Inc., all rights reserved.
-"""Docker image commands."""
+"""Docker image commands.
+
+Coming soon.
+
+This module is planned to provide a command line interface (CLI) for building
+Docker images for Airbyte CDK connectors.
+"""
 
 import click
 
 
-@click.group(name="image")
+@click.group(
+    name="image",
+    help=__doc__.replace("\n", "\n\n"),  # Render docstring as help text (markdown)
+)
 def image_cli_group() -> None:
     """Docker image commands."""
     pass

airbyte_cdk/cli/airbyte_cdk/_manifest.py

@@ -7,13 +7,14 @@
 Airbyte CDK manifests.
 """
 
-import click
+import rich_click as click
 
 
-@click.group(name="manifest")
-def manifest_cli_group(
-    help=__doc__,
-) -> None:
+@click.group(
+    name="manifest",
+    help=__doc__.replace("\n", "\n\n"),  # Render docstring as help text (markdown)
+)
+def manifest_cli_group() -> None:
     """Manifest related commands."""
     pass
 

airbyte_cdk/cli/airbyte_cdk/_secrets.py

@@ -30,7 +30,7 @@
 
 @click.group(
     name="secrets",
-    help=__doc__.replace("\n", "\n\n"),
+    help=__doc__.replace("\n", "\n\n"),  # Render docstring as help text (markdown)
 )
 def secrets_cli_group() -> None:
     """Secret management commands."""