Fix bulleted list indentation in docstrings

[andersy005]

• Closes Appearance of bulleted lists in docs #5248
• Passes pre-commit run --all-files

As I understand it, the issue described in #5248 is caused by bad indentation... With this PR, we get the following:

@max-sixty, let me know if there are other instances that need to be fixed as part of this PR....

[max-sixty]

That looks great! Thanks!

If there's a way of auto-failing anything that violates this, that would keep it good. But maybe the previous text is indistinguishable from normal prose...

Not worth worrying about at all — really — FYI this looks a tiny bit inconsistent:

[andersy005]

@max-sixty, the inconsistencies are now fixed...

[andersy005]

If there's a way of auto-failing anything that violates this, that would keep it good. But maybe the previous text is indistinguishable from normal prose...

Not sure there's a way to automatically detect these issues :(

[max-sixty]

Perfect!

[keewis]

the initial issue, at least, would have been caught by velin

[andersy005]

the initial issue, at least, would have been caught by velin

Right... In a previous comment #4872 (comment) you mentioned that the primary reason the velin hook was deactivated is because of the package maturity. Have you had a chance to test drive it lately? Is there a timeline on when we should activate it?

xarray/.pre-commit-config.yaml

Lines 27 to 30 in 9f11862

	# - repo: https://github.com/Carreau/velin
	# rev: 0.0.8
	# hooks:
	# - id: velin

[max-sixty]

Maybe it's time to let Velin spring free! @keewis up to you, as ever

[max-sixty]

@andersy005 I'll hit the button here, if that's OK with you?

[andersy005]

Thanks, @max-sixty

[max-sixty]

Thank you @andersy005 !

[keewis]

Have you had a chance to test drive it lately?

no, I didn't.

Maybe it's time to let Velin spring free!

I'll need to investigate more, but I think we should probably do that soon. There should be standard rst linters, too, but those might need more configuration: sphinx adds a lot of new directives.