[dagster-airbyte][docs] Update airbyte API docs with asset decorator,…

… factory and materialization method (#26583)

## Summary & Motivation

As title.

## How I Tested These Changes

Docs preview

docs/sphinx/sections/api/apidocs/libraries/dagster-airbyte.rst

@@ -17,6 +17,10 @@ Assets (Airbyte API)
 
 .. autofunction:: load_airbyte_cloud_asset_specs
 
+.. autodecorator:: airbyte_assets
+
+.. autofunction:: build_airbyte_assets_definitions
+
 
 Legacy
 ======

python_modules/libraries/dagster-airbyte/dagster_airbyte/asset_defs.py

@@ -1062,6 +1062,7 @@ def build_airbyte_assets_definitions(
 
     Examples:
         Sync the tables of a Airbyte connection:
+
         .. code-block:: python
 
             from dagster_airbyte import AirbyteCloudWorkspace, build_airbyte_assets_definitions
@@ -1083,6 +1084,7 @@ def build_airbyte_assets_definitions(
             )
 
         Sync the tables of a Airbyte connection with a custom translator:
+
         .. code-block:: python
 
             from dagster_airbyte import (

python_modules/libraries/dagster-airbyte/dagster_airbyte/resources.py

@@ -21,7 +21,7 @@
     get_dagster_logger,
     resource,
 )
-from dagster._annotations import experimental
+from dagster._annotations import experimental, public
 from dagster._config.pythonic_config import infer_schema_from_config_class
 from dagster._core.definitions.asset_spec import AssetSpec
 from dagster._core.definitions.definitions_load_context import StateBackedDefinitionsLoader
@@ -1258,6 +1258,7 @@ def _generate_materialization(
                     metadata=stream_asset_spec.metadata,
                 )
 
+    @public
     @experimental
     def sync_and_poll(self, context: AssetExecutionContext):
         """Executes a sync and poll process to materialize Airbyte Cloud assets.