airbytehq / airbytehq/airbyte

Improve CDK documentation around caching and child streams

Open
#11,076 2 comments 0 reactions 0 assignees View on GitHub
area/documentation CDK team/documentation type/enhancement
Dominant language
Python
Stars
22.1k
Forks
5.3k
PR merge metrics
PR metrics pending

Description

### Tell us about the documentation you'd like us to add or update.
[These docs ](https://docs.airbyte.com/connector-development/cdk-python/http-streams#nested-streams-and-caching) don't provide enough guidance on how a user should interact with substreams.

For example:
1. How could a child stream "become incremental" if its own endpoint doesn't support incremental syncs, but the parent supports incremental syncs?
2. What does inheriting from `HttpSubStream` do as opposed to just inheriting `HttpStream`?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.