Skip to content

Concepts: Type hints

Short essays on the ideas behind type hinting. Read these once, come back to them when you're deciding whether to reach for types in a given project rather than how.

Essays in this section

  • When type hints help — the situations where annotations genuinely reduce bugs and the ones where they mostly add noise. A taxonomy of "annotate here, skip there".
  • Gradual typing — the philosophy behind Python's type system: partial annotations, Any as an escape hatch, and why you don't have to annotate everything at once.