diff --git a/components/lock.rst b/components/lock.rst index c1ceabd4438..bce846ef0b7 100644 --- 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 ` 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 index a659666c2ec..6cef3400384 100644 --- 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 `; * 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 ` 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/