fix: document idempotency requirements for plugin callbacks

Summary

• fix: document idempotency requirements for plugin callbacks

---

• Close #727 (closed)
• Cherry-pick to: none
• Docs follow-up: docs#463 (closed)
• Changelog is updated