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

+13-9
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)