Improve documentation

[suned]

The documentation still has a few phrases that are left from a previous version of the Effect api. While not strictly incorrect, they can be made more clear.

Moreover, the pytkdocs wheel used to collect api documentation doesn't collect accurate api documentation in all cases for the cython code. A cython mkdocstrings handler should be implemented that collects accurate information.