Use cross references for internal links

javiereguiluz · javiereguiluz · commit 8e41b9806b22 · 2018-09-19T13:25:28.000+02:00
diff --git a/best_practices/forms.rst b/best_practices/forms.rst
@@ -148,9 +148,10 @@ view layer:
 Validation
 ----------
 
-The `constraints`_ option allows you to attach `validation constraints`_ to any
-form field. However, doing that prevents the validation from being reused in
-other forms or other places where the mapped object is used.
+The :ref:`constraints <reference-form-option-constraints>` option allows you to
+attach :doc:`validation constraints </reference/constraints>` to any form field.
+However, doing that prevents the validation from being reused in other forms or
+other places where the mapped object is used.
 
 .. best-practice::
 
@@ -235,6 +236,3 @@ like the form is *always* processed (even on the GET request).
 ----
 
 Next: :doc:`/best_practices/i18n`
-
-.. _`constraints`: https://symfony.com/doc/current/reference/forms/types/form.html#constraints
-.. _`validation constraints`: https://symfony.com/doc/current/reference/constraints.html
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
@@ -73,6 +73,8 @@ option on the form.
 
 .. include:: /reference/forms/types/options/compound.rst.inc
 
+.. _reference-form-option-constraints:
+
 .. include:: /reference/forms/types/options/constraints.rst.inc
 
 .. include:: /reference/forms/types/options/data.rst.inc
