symfony · javiereguiluz · Jan 24, 2023 · Jan 24, 2023
diff --git a/components/lock.rst b/components/lock.rst
@@ -310,7 +310,7 @@ will fallback to a write lock by calling the ``acquire()`` method.
 The Owner of The Lock
 ---------------------

-Locks that are acquired for the first time are owned [1]_ by the ``Lock`` instance that acquired
+Locks that are acquired for the first time are :ref:`owned <lock-owner-technical-details>` by the ``Lock`` instance that acquired
 it. If you need to check whether the current ``Lock`` instance is (still) the owner of
 a lock, you can use the ``isAcquired()`` method::

@@ -347,7 +347,11 @@ lose the lock it acquired automatically::
    you have to use ``acquire()`` for this. The ``isAcquired()`` method is used to check
    if the lock has been acquired by the **current process** only.

-.. [1] Technically, the true owners of the lock are the ones that share the same instance of ``Key``,
+.. _lock-owner-technical-details:
+
+.. note::
+
+    Technically, the true owners of the lock are the ones that share the same instance of ``Key``,
    not ``Lock``. But from a user perspective, ``Key`` is internal and you will likely only be working
    with the ``Lock`` instance so it's easier to think of the ``Lock`` instance as being the one that
    is the owner of the lock.

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
@@ -146,7 +146,7 @@ Pull Request Merging Policy

 A pull request **can be merged** if:

-* It is a minor change [1]_;
+* It is a :ref:`minor change <core-team_minor-changes>`;

 * Enough time was given for peer reviews;

@@ -162,7 +162,8 @@ Pull Request Merging Process
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 All code must be committed to the repository through pull requests, except for
-minor changes [1]_ which can be committed directly to the repository.
+:ref:`minor change <core-team_minor-changes>` which can be committed directly
+to the repository.

 **Mergers** must always use the command-line ``gh`` tool provided by the
 **Project Leader** to merge the pull requests.
@@ -178,8 +179,12 @@ Symfony Core Rules and Protocol Amendments
 The rules described in this document may be amended at any time at the
 discretion of the **Project Leader**.

-.. [1] Minor changes comprise typos, DocBlock fixes, code standards
-       violations, and minor CSS, JavaScript and HTML modifications.
+.. _core-team_minor-changes:
+
+.. note::
+
+    Minor changes comprise typos, DocBlock fixes, code standards
+    violations, and minor CSS, JavaScript and HTML modifications.

 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
 .. _`fabpot`: https://github.com/fabpot/