New submission from Ville Skyttä <ville.sky...@iki.fi>:

The documentation of typing.Optional seems to promote practices for not 
specifying Optional that are recommended against in PEP 484:

https://www.python.org/dev/peps/pep-0484/#union-types -- end of chapter 
recommends against inferring Optional.

https://docs.python.org/3.8/library/typing.html#typing.Optional -- second 
paragraph promotes the possibility of leaving out Optional.

I'm not sure how to improve the typing.Optional doc wording, perhaps it would 
be better to just remove the second paragraph altogether.

----------
assignee: docs@python
components: Documentation
messages: 323132
nosy: docs@python, scop
priority: normal
severity: normal
status: open
title: Don't promote possibility to omit Optional on optional/defaulted 
arguments
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue34336>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to