Improved formatting of parameters in reference docs

[philippjfr]

The current formatting for parameters in Sphinx API reference documentation is downright terrible, e.g. see:

Most of the attributes are either something no one really cares about OR it displays the default values which definitely no one cares about. This is an attempt to improve the formatting a bit and remove useless information. Admittedly this is a different theme so ignore the styling but the content is much more relevant using this new scheme:

One of the main issues is that this hardcodes the parameter attributes someone might care about, which won't work for user defined parameters which might have additional attributes.

[jbednar]

Can it not instead hard-code the parameter attributes to suppress?

I'm curious why you say no one cares about the default values; isn't that the main thing most people care about? I.e., they look at the parameter, look at the value it has, and decide whether to change it? Maybe I'm misunderstanding what bit of the docs you're talking about.

[philippjfr]

Can it not instead hard-code the parameter attributes to suppress?

That seems like a good idea.

I'm curious why you say no one cares about the default values; isn't that the main thing most people care about?

We are talking about different default values, I'm talking about the default values of the parameter attributes like allow_None, precedence, compute_default_fn, etc., that probably wasn't clear.

[jbednar]

Ah, right; nobody cares about those. :-)

[philippjfr]

Going to merge.