[docs] [issue17232] Improve -O docs

[Cheryl Sabella]

Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +5616
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17232>
_______________________________________