Skip to content

docs: add production checklist and troubleshooting - #67

Draft
ihippik wants to merge 2 commits into
masterfrom
docs/production-checklist-and-troubleshooting
Draft

docs: add production checklist and troubleshooting#67
ihippik wants to merge 2 commits into
masterfrom
docs/production-checklist-and-troubleshooting

Conversation

@ihippik

@ihippik ihippik commented Apr 18, 2026

Copy link
Copy Markdown
Owner

Summary

Improve operational documentation for WAL-Listener with a stronger production-oriented README and clearer example configuration comments.

Changes

  • add production checklist
  • document at-least-once delivery semantics in more detail
  • add common pitfalls and troubleshooting section
  • add Kubernetes and observability notes
  • improve comments in config_example.yml

Why

These changes are intentionally small but high leverage:

  • reduce repeated support questions
  • make production behavior easier to understand
  • help users adopt the service more safely
  • clarify expectations around replication slots, DataOld, probes, and duplicate delivery

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