Skip to content

docs: say when to use it, and when something else fits better - #72

Merged
AlexeyShalaev merged 1 commit into
masterfrom
docs/when-to-use
Oct 27, 2026
Merged

AlexeyShalaev merged 1 commit into
masterfrom
docs/when-to-use

Conversation

@AlexeyShalaev

Copy link
Copy Markdown
Member

Summary

Adds a "When to use it, and when not" section to the README and the docs home page.

It says what omni-box is for (async Python 3.12+, PostgreSQL through SQLAlchemy, Kafka, outbox and inbox from one library, per-key order across relays) and names the better fit for the other cases: django-outbox-pattern and django-jaiminho on Django, faststream-outbox for FastStream users and non-Kafka brokers, CDC when Debezium is already there, eventsourcing for event sourcing, and custom repositories for Python below 3.12 or other databases.

Type of change

  • Documentation update

Checklist

  • zensical build --clean passes locally, no warnings

@AlexeyShalaev
AlexeyShalaev merged commit 5121165 into master Oct 27, 2026
6 checks passed
@AlexeyShalaev
AlexeyShalaev deleted the docs/when-to-use branch October 27, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant