Refine repository guidance

Signed-off-by: Loren Eteval <loren.eteval@proton.me>
This commit is contained in:
Loren Eteval
2026-09-09 14:20:16 +08:00
parent 721b3e7207
commit c2f9d8efc9
27 changed files with 120 additions and 54 deletions
+4 -2
View File
@@ -19,8 +19,10 @@ exceptions; it does not define the source test suite or imply that every package
## Workflow engineering
- Keep packaging declarations synchronized with `Deploy.py`, `pyproject.toml`, `setup.py`, and `requirements.txt`.
Default-to-newest dependencies still need deterministic assertions at ABI/feature boundaries; pin or checksum external
build tools where the workflow establishes a supply-chain boundary.
The Python floor advertised by package metadata is a separate claim from the interpreter versions exercised by CI;
newer matrix rows cannot prove that floor. Likewise, successful Qt imports do not prove event-loop or binding-call
compatibility. Default-to-newest dependencies/assets still need recorded provenance and deterministic assertions
at ABI/feature boundaries; pin or checksum external build tools where the workflow establishes that boundary.
- The workflow default shell is Bash, including Windows jobs. Select PowerShell explicitly for native Windows paths,
process APIs, or PowerShell syntax, and keep OS/architecture conditions on the step that owns the difference.
- Flatpak checks run inside the installed sandbox, inspect the application's required native closure rather than every