https://gitlab.synchro.net/main/sbbs/-/commit/745819dbe8a7c6699ce49614
Added Files:
src/sbbs3/scfg/CLAUDE.md
Log Message:
scfg: add CLAUDE.md with menu help text and search index conventions
Captures lessons learned across recent SCFG work:
* uifc.helpbuf format conventions (title in backticks, ~72-col wrap,
backtick-quoted option names, sysop voice, no internal-symbol
references) with canonical examples to template from.
* Helpbufs live inline in scfg*.c, NOT in ctrl/text.dat -- different
system from the text[] runtime string database.
* Shared menu helpers (js_startup_cfg, login_attempt_cfg,
rate_limit_cfg, max_concurrent_cfg) -- one edit changes every
caller's menu.
* No automated test; validate F1-rendered help interactively.
* CP437 box-drawing characters in helpbufs are corrupted by string-
substitution editors; preserve raw bytes.
* scfgindex.h is auto-generated by gen_option_index.py; regenerate
after menu changes; out-of-tree builds skip the auto-regen rule
so always re-run by hand.
* When adding a new dispatch pattern, verify is_navigable_list()
still classifies the menu correctly or the options silently drop
from search.
In-repo home for these makes them visible to future sessions and
teammates working in src/sbbs3/scfg/ without having to consult any
per-user memory.
---
■ Synchronet ■ Vertrauen ■ Home of Synchronet ■ [vert/cvs/bbs].synchro.net