fix_docs

Overhaul all @param and @author tags for rst API documentation (@param x --> :param x: and @author --> :author:)

Authors:

• Caroline De Brouwer (Ghent University)