https://gitlab.synchro.net/main/sbbs/-/commit/f6ad99ad9215937858314696
Added Files:
src/CLAUDE.md
Log Message:
src: add a CLAUDE.md directive on C/C++ comment discipline
Comments in the C/C++ sources should explain the non-obvious, not narrate
the change or its history -- git log/blame/annotate and the commit message
are the archaeology tools, and rationale belongs in the commit message where
it stays tied to the exact diff. Recent output_thread() edits drifted into block comments that were really commit-message prose in the wrong place;
this scopes a directive at src/ (auto-loading for sbbs3, syncterm, ssh,
doors, ...) to head that off.
Permitted comments: genuinely surprising/edge-case code (kept short), a
direct GitLab issue pointer (with the problem's details in the issue, which auto-links to the fix commit), and terse tool/analyzer directives that must
sit at the code site with a one-line justification.
Co-Authored-By: Claude Opus 4.8 (1M context) <
noreply@anthropic.com>
---
þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net