Skip to content

Document maintenance scope for clients sharing a schema - #1371

Draft
yafi-s wants to merge 1 commit into
riverqueue:masterfrom
yafi-s:docs/shared-schema-maintenance
Draft

Document maintenance scope for clients sharing a schema#1371
yafi-s wants to merge 1 commit into
riverqueue:masterfrom
yafi-s:docs/shared-schema-maintenance

Conversation

@yafi-s

@yafi-s yafi-s commented Sep 7, 2026

Copy link
Copy Markdown

Clients configured for different queues still share schema-wide maintenance by default. This can surprise users with separate worker registries: the elected leader's rescuer discards a stuck job if its kind is unknown to that leader.

Add a short section beside client setup explaining maintenance scope, the need for shared job-kind registration, and separate schemas for independent applications. This documents current behavior and does not attempt the leadership-domain implementation in #1113.

Related to #1105.

Validation: checked the wording against JobRescuer.getStuckJobs, makeRetryDecision, Config.Schema, and the migration schema option. git diff --check passed. Documentation only; no Go code or tests changed.

AI-assisted contribution, opened as a draft for contributor review.

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