[pydocstyle] Document which rules are disabled by which conventions?

[alanhdu]

On https://docs.astral.sh/ruff/settings/#pydocstyle-convention, it says

Enabling a convention will force-disable any rules that are not included in the specified convention

But I can't seem to find documentation about which rules are included in which conventions! Maybe I totally missed it, but I only found this information by going to the source code and finding

ruff/crates/ruff_linter/src/rules/pydocstyle/settings.rs

Line 24 in 4760af3

pub const fn rules_to_be_ignored(self) -> &'static [Rule] {

Is there some place this is documented? If not, how easy/hard would it be to add some documentation? I'd be happy to contribute a patch if the best way is to just add some markdown at

ruff/crates/ruff_workspace/src/options.rs

Line 2378 in 4760af3

/// Enabling a convention will force-disable any rules that are not

, but maybe there's some clever way to auto-generate that information from the code to ensure it stays in sync?

[charliermarsh]

The list originally comes from pydocstyle. Perhaps we could enumerate the conventions in the FAQ, as part of the "Does Ruff support NumPy- or Google-style docstrings?" section?

[charliermarsh]

Adding this real quick.