← Back to issue list

`make docs-auto` should ignore editor temp files and stuff.

View original Github issue

Metadata

Project
starbase
Number
#357
Type
issue
State
open
Author
lengau
Labels
—
Created
Updated
Closed
—

Current evaluation

Enhance make docs-auto to exclude editor temp files such as Kate swap files; maintainers are still comparing patterns across several editors.

Suggested action: keep open

Reason: The report remains valid: common.mk only excludes the virtual environment and generated command reference, while the maintainer reports that Kate swap files trigger rebuilds during every edit. Maintainers are still deciding which patterns to cover across Vim, Neovim, emacs, Kate, and VS Code, so the improvement should remain open for a consolidated ignore list.

Evaluated by: mr-cal-bot

Impact: 28 Quick Win: 17 Complexity: 20 Confidence: 91 Actionability: 74

Issue body

Ideally we'd get this: https://github.com/sphinx-doc/sphinx-autobuild/issues/140 But until then we should ignore things like `*.[a-z]+-swp`

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 28
Quick Win: 17
Complexity: 20
Confidence: 91
Actionability: 74
keep open Enhance make docs-auto to exclude editor temp files such as Kate swap files; maintainers are still comparing patterns across several editors.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 19
Complexity: 10
Confidence: 70
Actionability: 70
keep open Feature request to make docs-auto ignore editor swap/temp files (Vim, Emacs, Kate, VS Code). Maintainer discussion ongoing about which patterns to include.
qwen/qwen3.8-27b
Impact: 15
Quick Win: 14
Staleness: 70
Complexity: 10
Confidence: 70
Support Request: 0
keep open Request to make `make docs-auto` ignore editor temp/swap files (vim, emacs, kate, VS Code) to avoid spurious rebuilds. Discussed by maintainers in Feb 2025 but never implemented; no activity for ~16 months.
qwen/qwen3.6-35b-a3b
Staleness: 82
Complexity: 15
Confidence: 75
Support Request: 10
keep open Request to configure make docs-auto to ignore editor temporary and swap files. Currently under discussion with maintainers and contributors gathering recommendations on which editor files to exclude.
qwen3.6-35b-a3b-mtp-q6
Staleness: 75
Complexity: 20
Confidence: 80
Support Request: 10
needs triage Request to update make docs-auto to ignore editor temp and swap files. Unlabelled and inactive for over a year, awaiting maintainer assessment.

Update history

No update history recorded yet.

Related work

  • Related To: sphinx-autobuild#140 (confidence 98%)

    The issue explicitly links this upstream enhancement and proposes explicit ignores until it becomes available.

Related issues

No related issues found above the similarity threshold.