Integrate/dlt: Pull README and usage guide from upstream repository

[amotl]

About

Pull and enhance documentation from dlt-cratedb ¹. It includes:

• Overview about supported features
• Usage guide based on the canonical dlt init chess example

Preview

• https://cratedb-guide--493.org.readthedocs.build/integrate/dlt/
• https://cratedb-guide--493.org.readthedocs.build/integrate/dlt/usage.html

References

• Improve README by referring to canonical documentation dlt-cratedb#35

/cc @karynzv, @zolbatar, @grbade

Footnotes

1. https://github.com/crate/dlt-cratedb/blob/v0.0.2/docs/cratedb.md. ↩

[coderabbitai]

Walkthrough

Documentation-only updates for the dlt CrateDB integration: expanded docs/integrate/dlt/index.md with a "Supported features" section, updated links and resources, and added a new docs/integrate/dlt/usage.md providing step-by-step installation, configuration, Docker usage, and example commands.

Changes

Cohort / File(s)	Summary
dlt integration index edits docs/integrate/dlt/index.md	Replaced "Learn" with "Supported features"; added multi-section feature blocks (Data loading, Datasets, File formats, Column types, Column hints, File staging, dbt support, dlt state sync); updated "See also" grid and Resources wording (e.g., dlt-cratedb, related ingestr); added toctree and CrateDB-specific create-schema note (CRATEDB-14601); updated external link captions/targets and minor wording tweaks.
New usage guide docs/integrate/dlt/usage.md	Added a comprehensive usage guide covering installation (pip install dlt-cratedb), dlt init project setup, editing pipeline code (dataset name, dlt_cratedb import), .dlt/secrets.toml configuration and connection-string alternative, Docker instructions to start CrateDB, example run commands, and exploration/notes for CrateDB schema limitations and known errors.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Documentation-only changes, consistent pattern and no code edits.
• Review focus:
  • Verify command snippets and Docker examples in docs/integrate/dlt/usage.md.
  • Validate TOML snippets and connection-string alternatives in .dlt/secrets.toml examples.
  • Check updated external links and CRATEDB-14601 note in docs/integrate/dlt/index.md.

Possibly related PRs

• Integrate: Add sections about dlt and ingestr #268 — Overlapping edits to docs/integrate/dlt/index.md and related dlt integration docs.

Suggested labels

new content

Suggested reviewers

• hammerhead
• surister
• kneth

Poem

🐰 A rabbit hops through README glades,
Pip installs and Docker aids,
Secrets.toml tucked in a nook,
Pipelines run — the data's took,
Hooray for docs that lay the blades!

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: pulling and enhancing dlt documentation from the upstream dlt-cratedb repository into the CrateDB guide, covering README and usage guide content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description clearly relates to the changeset, describing the integration of dlt-cratedb documentation with specific references to supported features overview and usage guide.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dlt

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[surister]

LGTM