Skip to content

Commit 69768dd

Browse files
committed
Improved wording: use -> call, access
1 parent 0c6420f commit 69768dd

File tree

1 file changed

+13
-9
lines changed

1 file changed

+13
-9
lines changed

contributing/code/bc.rst

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ that:
3434

3535
* You can safely type hint against the interface.
3636

37-
* You can safely use any of the methods provided by the interface.
37+
* You can safely call any of the methods provided by the interface.
3838

3939
However:
4040

@@ -70,7 +70,7 @@ The following table summarizes the safe operations when using our interfaces:
7070
Operation Normal API
7171
============================================== ============== ==============
7272
Type hint against Safe Safe
73-
Use method Safe Safe
73+
Call method Safe Safe
7474
**In Implementing Classes**
7575
Implement method Not Safe [1]_ Safe
7676
Add custom method Not Safe [1]_ Safe
@@ -97,7 +97,9 @@ All classes in the ``Symfony`` namespace are **safe for use**. That means that:
9797

9898
* You can safely extend the class.
9999

100-
* You can safely use public properties and methods.
100+
* You can safely access public properties.
101+
102+
* You can safely call public methods.
101103

102104
When extending the class:
103105

@@ -118,11 +120,13 @@ API Classes
118120
All classes tagged with ``@api`` are also **safe for extension**. That means
119121
that:
120122

121-
* You can safely use protected properties and methods.
123+
* You can safely access protected properties and methods.
124+
125+
* You can safely call protected methods.
122126

123127
* You can safely override protected properties.
124128

125-
* You can safely override public or protected methods.
129+
* You can safely override public and protected methods.
126130

127131

128132
Internal Classes
@@ -143,11 +147,11 @@ Operation Normal API
143147
Type hint against Safe Safe
144148
Create instance Safe Safe
145149
Extend Safe Safe
146-
Use public property Safe Safe
147-
Use public method Safe Safe
150+
Access public property Safe Safe
151+
Call public method Safe Safe
148152
**In Extending Classes**
149-
Use protected property Not Safe [1]_ Safe
150-
Use protected method Not Safe [1]_ Safe
153+
Access protected property Not Safe [1]_ Safe
154+
Call protected method Not Safe [1]_ Safe
151155
Override public property Safe Safe
152156
Override protected property Not Safe [1]_ Safe
153157
Override public method Not Safe [1]_ Safe

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy