CONTRIBUTING.md

Contributing to plex-language-sync

The shared rules for commits, releases, synced files and checks apply here.

Rules

• Change a log message or field that alerts/logql.yaml matches or names, such as deep analysis completed, with its rule and docs/monitoring.md in one commit. Only the Go side has tests, so a one-sided change passes and the alert breaks.
• Log each failure the app retries at WARN. Log ERROR only once the failure needs the operator, as the WebSocket reconnect loop does after repeated failures. A retried failure at ERROR can fire PlexLanguageSyncErrorLog for something that heals itself.
• Add a new ERROR failure to the list in docs/monitoring.md and to the PlexLanguageSyncErrorLog description in alerts/logql.yaml. An unlisted ERROR fires the alert without telling the operator what failed.