Skip to content

Commit a47852e

Browse files
committed
expand Rationale
1 parent 0ab6557 commit a47852e

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

peps/pep-0791.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,9 @@ Rationale
6666
Why not fix the :external+py3.14:mod:`math` module documentation instead?
6767
Sure, we can be much more vague in the module preamble (i.e. roughly say
6868
that "the :external+py3.14:mod:`math` module contains some mathematical
69-
functions") and we can accurately describe input/output for each function.
69+
functions"), we can accurately describe input/output for each function
70+
and it's behavior (e.g. whether the :external+py3.14:func:`~math.factorial`
71+
output is exact or not, like e.g. the `scipy.special.factorial <https://docs.scipy.org/doc/scipy/reference/generated/scipy.special.factorial.html#scipy.special.factorial>`_, per default).
7072

7173
But the major issue is that the current module mixes different, almost non-interlaced
7274
application domains. Adding more documentation will just highlight this and

0 commit comments

Comments
 (0)