Applies to all code and config in this repository unless a file or directory explicitly documents a different convention.
- Comments must be written in English (including SCSS, templates, and shell scripts).
- Variable names (and other identifiers: functions, classes, modules where naming is chosen in this project) must be in English.
- Use the project virtual environment’s Python:
venv/bin/python(relative to the repository root). - Do not assume a system-wide
pythonorpython3unless explicitly required; prefervenv/bin/pythonfor installs, scripts, and tooling that should match project dependencies.
npm run buildis usually not needed during development:make watchalready runsnpm run watch(alongside the Django dev server), which rebuilds JS and CSS when sources change. Runnpm run buildonly when you need a one-off full build without the watch process (e.g. CI-style checks or troubleshooting).
- For release notes and user-facing change history, edit
CHANGELOG.mdat the repository root only. Do not add duplicate changelog content toREADME.md, wiki files, or other docs unless a maintainer explicitly asks for it.