Cl() is not properly documented

[arsenovic]

https://github.com/pygae/clifford/blob/master/clifford/__init__.py#L352

this is possibly the most used function in this package.

[eric-wieser]

In what sense do you mean "properly"?

[arsenovic]

dont most functions have their parameters listed under

Parameters
-----------------

[eric-wieser]

That's true, but I think describing p, q, r in the main text works fine anyway. The function is messy to document because it supports multiple unrelated calling conventions...

We should probably at least add an example of each one to the docstring.

https://clifford.readthedocs.io/en/latest/api/clifford.Cl.html#clifford.Cl

[hugohadfield]

Yeah I think it definitely needs a bit of a flesh out documentation-wise