* Add narrative docs for type annotations * Better wording * Use better code-block types * Add newsfragment for #238 that refers to these docs