Use typing

[Thomas VINCENT]

Let's add typing to the API and leverage it in the documentation with sphinx-autodoc-typehints

[V. Armando Solé]

I know some people like it, but I find the code less readable.