Add support for alternative section names in Google docstrings

[ntamas]

This PR adds support for specifying alternative section names in Google docstrings that are to be interpreted as sections-of-lists, similarly to the standard "Args" section. Right now the PR aliases "Parameters" and "Params" to "Args"; these names are not standard but are often seen in the wild, especially in codebases that mix NumPy and Google-style docstrings (NumPy uses "Parameters" by default).

The PR could also partially fix the issue raised in #466 if we decided to add "Keyword Arguments" and "Keyword Args" such that "Keyword Args" is handled as-is and "Keyword Arguments" is aliased to "Keyword Args". That would require an additional commit that I'm happy to do if the maintainer agrees with the general direction of this PR.

[mhils]

Thanks for the PR! I could see some people being surprised that their sections are renamed by pdoc. Would it make more sense to add those alternatives to GOOGLE_LIST_SECTIONS ?

[ntamas]

It definitely would; I went for this approach because currently the function also remaps Args to Arguments so I was thinking that the goal is to use "Arguments" as a sort-of standard section header. If you think that leaving the headings as-is is a better approach, I can update the PR to do so instead.

[mhils]

That's actually a fair point. Let's use "Arguments" for everything as you suggested and see if someone complains. While we're at it, would it make sense to add Arguments as an alias as well?

(also please add a changelog entry, thanks!)

[mhils]

Awesome, thanks! 🍰