Skip to content

Commit bf6e928

Browse files
authored
Add a note with adoption guidance on positional-only parameters (#38)
1 parent 2d34b1d commit bf6e928

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

spec/API_specification/function_and_method_signatures.md

+7
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,13 @@ Function signatures in this standard adhere to the following:
1111
_Rationale: existing libraries have incompatible conventions, and using names
1212
of positional parameters is not normal/recommended practice._
1313

14+
.. note::
15+
16+
Positional-only parameters are only available in Python >= 3.8. Libraries
17+
still supporting 3.7 or 3.6 may consider making the API standard-compliant
18+
namespace >= 3.8. Alternatively, they can add guidance to their users in the
19+
documentation to use the functions as if they were positional-only.
20+
1421
2. Optional parameters must be
1522
[keyword-only](https://www.python.org/dev/peps/pep-3102/) arguments.
1623

0 commit comments

Comments
 (0)