API-doc has run-on sentences

[purva-thakre]

As we rely on google-style docstrings, there is no convention to allow lists in the description of the different sections of a docstring. Portions of our API-doc have run-on sentences because someone used a list in the section description which appears as badly formatted sentences publicly.

Intended	in API-doc

[purva-thakre]

@natestemen Is this what you were referring to?

[natestemen]

Not really. I was thinking we could take inspiration from how numpy documents kwargs objects, but I haven't been able to find what I was looking for. One thing I did find, however, was that for numpy.clip they redirect to a different page for info on what kwargs can look like. Not necessarily suggesting we do that, just worth noting.

[cosenal]

See #2472 for a related issue and potentially a solution that could fix both. 🐦‍⬛🐦‍⬛ 🥌

[Kuzay3t]

I want to help, how can i assist?

[natestemen]

The goal here is to go through the docstrings and ensure kwargs variables are formatted properly. You can find an example where this is not the case in the issue description.