• src/sbbs3/scfg/CLAUDE.md

    From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Sun May 24 03:00:55 2026
    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