Inconsistent documentation of function parameter

We have multiple different documentation styles applied to describe function parameter and return in ogstools.

1. :param parameter_name: Description of parameter / :returns: Description of return-value
2. Args: name and description / Returns: Value and description
3. Mostly from ogstools: Parameters ---------- name : str coords : list values : list

Maybe we can agree on one format and be consistent about it?

I would vote for 1.