fix(ci): replace split pip+poetry install with poetry --with docs in docs workflow, remove docformatter

Co-authored-by: Copilot <copilot@github.com>

Author: mkumar73

.github/workflows/docs.yml

@@ -51,11 +51,8 @@ jobs:
           path: .venv
           key: venv-docs-${{ runner.os }}-3.10-${{ hashFiles('poetry.lock') }}
 
-      - name: Install package
-        run: poetry install --only main
-
-      - name: Install docs dependencies
-        run: pip install -r docs/requirements_docs.txt
+      - name: Install package and docs dependencies
+        run: poetry install --with docs
 
       - name: Build Sphinx docs
         run: poetry run sphinx-build -b html docs/ docs/_build/html -W --keep-going

docs/contributing.md

@@ -82,6 +82,11 @@ pip install -r docs/requirements_docs.txt
    ```bash
    just check
    ```
+   If `ruff-format` modifies any files, commit those changes before pushing:
+   ```bash
+   git add -u
+   git commit -m "style: apply ruff formatting"
+   ```
 8. Commit your changes following the Conventional Commits specification (see below):
    ```bash
    just commit

justfile

@@ -29,7 +29,6 @@ lint:
 
 # run docformatter and ruff formatter
 format:
-    poetry run docformatter --in-place --recursive --wrap-summaries 120 --wrap-descriptions 120 .
     poetry run ruff format .
 
 # run pyright type checking
@@ -42,9 +41,11 @@ test:
 
 # build HTML docs locally (warnings treated as errors)
 docs:
-    sphinx-build -b html docs/ docs/_build/html -W --keep-going
+    poetry run sphinx-build -b html docs/ docs/_build/html -W --keep-going
 
 # run all pre-commit hooks on all files (commit + push stage)
+# if ruff-format modifies files, stage and commit them before pushing:
+#   git add -u && git commit -m "style: apply ruff formatting"
 check:
     poetry run pre-commit run --all-files
     poetry run pre-commit run --all-files --hook-stage push

pyproject.toml

@@ -132,13 +132,6 @@ ignore = [
 [tool.ruff.lint.pycodestyle]
 max-doc-length = 120
 
-[tool.docformatter]
-recursive = true
-in-place = true
-wrap-summaries = 120
-wrap-descriptions = 120
-exclude = ["build", "dist", ".venv", ".git"]
-
 # Commitizen configuration
 [tool.commitizen]
 name = "cz_conventional_commits"