Skip to content

Commit

Permalink
readability
Browse files Browse the repository at this point in the history
  • Loading branch information
hauntsaninja committed Sep 26, 2023
1 parent d7597cd commit b2a0598
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/source/typing_anti_pitch.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,10 @@ in Python::
multi-paradigm language that generally allows you to do things in the way that best suits your
needs, as best determined by you.

* Type annotations can both help and hurt readability. While type annotations can serve both
humans and machines, particularly complex annotations or changes to idioms serve machines more
than they do humans. Readability counts.

* The cost-benefit ratio isn't good enough. Pleasing static type checkers requires a non-zero amount
of busy work. If this isn't worth the extra confidence you get, you shouldn't add static type
checking.
Expand Down

0 comments on commit b2a0598

Please sign in to comment.