Aren&#x27;t type annotations in python just documentation that&#x27;s designed to look like it&#x27;s not? Seems like it would make more sense to just create a documentation standard than develop a brand new syntax for documentation. Another idea that makes more sense to me is to use @decorators. I really don&#x27;t understand why this syntactic hack is supposed to be a good idea.