[Validator] Missing information about payload in callback

[alamirault]

Fix #18787

[alamirault]

I'm not sure about the :ref: I used. When I build locally it's broken: href is Sequentially.html#payload

What syntax should I use?

---

It's in .. include:: /reference/constraints/_payload-option.rst.inc

[javiereguiluz]

This is tricky:

• RST creates the anchors based on the section titles
• We're including a RST doc with a section title called Payload
• So, the payload cross reference exists and it's valid

But, I don't like this automatic references much because if you change the title, then the reference breaks. To avoid this, while merging I've added a explicit reference name in the included file and used it in the links. See 61fcb40

[alamirault]

So, the payload cross reference exists and it's valid

This behavior is very strange, and can confuse user because it redirect to another page. https://symfony.com/doc/current/reference/constraints/Ip.html#reference-constraints-payload for example

Do you know if we can improve this, in which repository ?

[javiereguiluz]

Not sure if it's fixable in symfony-tools repository or in the underlying RST parser 😐

[alamirault]

I created issue doctrine/rst-parser#275 with a reproducer and fix proposal (I hope 😄 )

[javiereguiluz]

Antoine, thanks for fixing this bug!