Tighten up docs CI checks

[snejus]

This PR adds sphinx-lint check for docs which catches issues like line length.

[semohr]

Looks good generally! I guess you did not do all the changes manually. Could you add a poe command for the auto docs formatting? Also a reference/sentence in the contribution guide would be highly appreciated!

[Copilot]

Pull Request Overview

This PR adds sphinx-lint to the documentation CI checks to catch issues like line length violations, improving documentation quality and consistency.

• Adds sphinx-lint dependency to the documentation build pipeline
• Adds docstrfmt dependency for formatting documentation
• Updates test fixtures to reflect proper documentation formatting conventions

Reviewed Changes

Copilot reviewed 107 out of 111 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/test_release.py	Updates test fixtures to use proper RST formatting with consistent bullet points, code blocks, and indentation
pyproject.toml	Adds sphinx-lint and docstrfmt dependencies with new poe tasks for documentation linting and formatting
extra/release.py	Temporarily adds debugging code and modifies changelog processing logic
docs/team.rst	Converts documentation from using asterisks to hyphens for bullet points and proper heading underlines
docs/reference/query.rst	Fixes code block formatting by separating introductory text from code examples with proper spacing
docs/reference/pathformat.rst	Improves line length compliance and consistent formatting throughout the document
docs/reference/config.rst	Extensive reformatting for better line length compliance and consistent bullet point usage
docs/reference/cli.rst	Converts bullet points to hyphens and improves line wrapping for better readability
docs/plugins/*.rst	Multiple plugin documentation files updated for consistent formatting, proper line lengths, and standardized bullet point usage

[snejus]

Looks good generally! I guess you did not do all the changes manually. Could you add a poe command for the auto docs formatting? Also a reference/sentence in the contribution guide would be highly appreciated!

Funnily, I initially only addressed the linting issues (lines being too long) selectively. On the other hand, I guess, we want to have consistent formatting across all docs. Thus now I have reformatted everything using docstrfmt and added relevant poe commands for formatting and linting.

[semohr]

Would it be possible to group all automated changes into a single commit and list its hash in the .git-blame-ignore-revs file?

[snejus]

That's exactly what I will do once you confirm that we're good to go!

[semohr]

That's exactly what I will do once you confirm that we're good to go!

I guess we should be good to go. All seems reasonable to me 👍

[semohr]

Maybe one more thing could you add the command to the precommit hook too? 🙏

[snejus]

Maybe one more thing could you add the command to the precommit hook too? 🙏

Cool, done it. Squashed docs adjustments to two commits and added them to blame ignore revs.