Wiki Maintenance

Wiki Maintenance

This page is for maintainers of the openQSE admin wiki. It is intentionally not listed in _Sidebar.md or linked from the public-facing wiki pages.

Canonical Names

.NAMES_CANONICAL.md is the repo-level reference for normalizing meeting attendee names and organizations.

Use it to keep attendance tables consistent across Meeting-*.md pages. The file maps raw names and organization variants, including names from Teams attendance exports, to canonical display names and organizations.

Do not treat .NAMES_CANONICAL.md as a public roster. It is maintenance data for normalizing wiki records. Update it conservatively when a new attendee, organization, or seen-name variant needs to be reused across meeting notes.

Codex Skills

The repo includes a local Codex skill at .codex/skills/openqse-mtg/.

That skill is intended for drafting or updating meeting notes from a transcript and attendance export. It uses .NAMES_CANONICAL.md to normalize attendees, keeps attendance inside the meeting page, and asks for explicit approval before changing canonical-name data.

Scripts

Maintainer scripts live in scripts/.

scripts/attendance_breakdown.py reads .NAMES_CANONICAL.md and attendance tables from Meeting*.md files, then prints an attendance breakdown by person. If no meeting files are passed, it defaults to all Meeting*.md files under the current directory.

Common commands:

python3 scripts/attendance_breakdown.py --brief
python3 scripts/attendance_breakdown.py --format csv
python3 scripts/attendance_breakdown.py 2026/Meeting-2026-06-15.md --brief

Use --help for the full option list.