Add sphinx documentation style to pydocstyle config

[Eutropios]

Addition of sphinx documentation style to pydocstyle config as so:

[tool.ruff.pydocstyle]
    convention = "sphinx"

Currently pep257, google, and numpy documentation styles are supported. It'd be nice to have this major documentation style added as well.

[charliermarsh]

We can probably add a convention that's compatible, but there would also be necessary work to actually support parsing Sphinx docstrings (e.g., https://github.com/PyCQA/pydocstyle/pull/595). pydocstyle itself does not support this.

[Eutropios]

Alright, so as far as I know, the necessary pull requests to pydocstyle have been made as of 5 hours ago. Relevant commit here: PyCQA/pydocstyle/commit.

[LecrisUT]

Related, it would be nice to get a check when a different convention is used.

[charliermarsh]

(Removing needs-decision since we should support this now.)

[Eutropios]

Sounds great! Let me know if there's anything I can do to help.

[winwinashwin]

+1 on this feature. Any updates on sphinx support?

[DanPaseltiner]

Ditto @winwinashwin. We would adopt Ruff immediately on this project it there was sphinx support. Unfortunately, we have a code base full of Sphinx style docstrings and need to implement linting on them.

[jaladh-singhal]

Hi, just checking if/when this will be available?

BTW thanks for making this super awesome tool!

[Lassii-]

Hello,

Also wondering if there's any plan updates to this? The project I work for is also looking for the support.