Fix contradictory note about duplicate Stage weights

[promptless-for-oss]

Open this suggestion in Promptless to view citations and reasoning process

Corrects the "Moving Contacts between Stages" note, which incorrectly stated that multiple Stages across funnels could share the same weight. The unique-weight constraint added in mautic/mautic#15404 (and already documented in the Weight field description) makes each Stage's weight unique across all funnels. Targets the 7.2 user-docs branch.

Trigger Events

• mautic/api-library PR #348: Stage weight must be unique to pass the validation

---

Tip: Tag @Promptless in a GitHub issue to turn it into a documentation update 🐙

[escopecz]

This is related to #758 resp mautic/mautic#15404

@andersonjeccel can you please check if the change is correct?

[adiati98]

@andersonjeccel, can you please follow up? Thanks!

[promptless-for-oss]

We double-checked this against the source change. The unique-weight constraint from mautic/mautic#15404 is a class-level UniqueEntity scoped by the weight field alone — there's no funnel, category, or project scoping — so a Stage's weight must be unique across all funnels, exactly as the corrected note now states. This is also consistent with the Weight field description added in #758.

One note for completeness: this uniqueness is enforced at the application/validation layer (no DB-level unique index), which is an app-level guarantee and appropriate for the user-facing docs. The edit reads correctly as-is.

[andersonjeccel]

OK

[promptless-for-oss]

Thanks @adiati98 — we're on it. We'll apply your suggested wording for the Stage weight note and push an update to this branch.

[promptless-for-oss]

Update: applied your suggested wording verbatim to docs/stages/stages.rst and pushed to the branch. Ready for another look when you have a moment.

[promptless-for-oss]

@adiati98 done — applied your suggested wording verbatim to the 'Moving Contacts between Stages' note in docs/stages/stages.rst (comma after 'For example') and pushed it to the branch. The note's substance (each Stage must have a unique weight across all funnels) was already correct, so this was just the punctuation fix. Ready for another look.

[adiati98]

/aside

Thanks for the review, @andersonjeccel! 🚀