diff options
| author | Natalia <124304+nessita@users.noreply.github.com> | 2026-02-27 11:19:20 -0300 |
|---|---|---|
| committer | Natalia <124304+nessita@users.noreply.github.com> | 2026-03-02 15:07:30 -0300 |
| commit | 659bacfe54c2a28eb2e0589c1c721f1a99720ad2 (patch) | |
| tree | 532576a71a90147d9e5a9dc71a1c43d3e194be29 /docs | |
| parent | e65c412241578ead6dc17e9dc7280630a180d1c0 (diff) | |
[6.0.x] Aligned docs checks between GitHub Actions and local development.
Backport of 3f21cb06e76044ad753055700395e54a1fc4f1e9 from main.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/Makefile | 29 |
1 files changed, 23 insertions, 6 deletions
diff --git a/docs/Makefile b/docs/Makefile index 3545332a40..41ed522daf 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -171,16 +171,33 @@ spelling: black: @mkdir -p $(BUILDDIR)/black - find . -name "*.txt" -not -path "./_build/*" -not -path "./_theme/*" \ + @find . -name "*.txt" -not -path "./_build/*" -not -path "./_theme/*" \ | xargs blacken-docs --rst-literal-block; echo $$? > "$(BUILDDIR)/black/output.txt" - @echo - @echo "Code blocks reformatted" + @RESULT=`cat $(BUILDDIR)/black/output.txt`; \ + if [ "$$RESULT" -gt 0 ]; then \ + echo "💥 📢 Code blocks in documentation must be reformatted with blacken-docs 📢 💥"; \ + exit $$RESULT; \ + else \ + echo "Code blocks in documentation are properly formatted ✅"; \ + fi lint: $(PYTHON) lint.py @echo @echo "Documentation lint complete." -check: spelling black lint - @echo - @echo "Style and spelling checks completed." +check: + @echo "=== Spelling check ==="; \ + $(MAKE) --no-print-directory SPHINXOPTS="-q -W" spelling; SPELLING=$$?; \ + echo ""; \ + echo "=== Code formatting check ==="; \ + $(MAKE) --no-print-directory black; BLACK=$$?; \ + echo ""; \ + echo "=== Lint check ==="; \ + $(MAKE) --no-print-directory lint; LINT=$$?; \ + echo ""; \ + if [ $$SPELLING -ne 0 ] || [ $$BLACK -ne 0 ] || [ $$LINT -ne 0 ]; then \ + echo "Some checks failed."; \ + exit 1; \ + fi; \ + echo "All style and spelling checks passed." |