Files
Khaemhat/docs/wiki/Contribuire.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
Gitea flags en dash, multiplication sign, minus sign and single angle
quotes as confusable characters, which put a warning on most pages;
use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now
lists the issue numbers per milestone, the items waiting for the owner
and the open specification questions tracked by issue #114.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 22:44:14 +01:00

2.6 KiB

Contribuire

Stato: bozza · Ultima revisione: 2026-11-10 · Specifica: SPEC §17-§20

Questa pagina riassume come si propone una modifica a Khaemhat. Il processo completo è in Processo di sviluppo e in docs/DEVELOPMENT.md.

Prima di iniziare

  1. Leggi CLAUDE.md: vincoli non negoziabili ed emendamenti alla specifica.
  2. Cerca o apri un'issue: ogni lavoro parte da un'issue con milestone ed etichette.
  3. Per l'interfaccia guarda il Mockup corrispondente e la pagina Design-UI.

Regole essenziali

Regola Dettaglio
Nessuna libreria esterna Solo framework Microsoft, Npgsql, Microsoft.Data.Sqlite; nei test MSTest. Verifica: scripts/check-packages.sh
Lingue Codice, commenti e commit in inglese; interfaccia in italiano tramite risorse
Database Il codice sopra lo strato dati non conosce il motore; test su SQLite e, se possibile, PostgreSQL
Fiscalità Tutto ciò che è italiano sta in Khaemhat.Fiscal.Italy
Qualità Nessun warning (TreatWarningsAsErrors), Nullable attivo
Documentazione Wiki, docs/*.md e CHANGELOG.md aggiornati nella stessa PR
Distribuzione Solo immagine Docker; nessun installer

Flusso

  1. Ramo da main: feat/<n>-descrizione, fix/<n>-… o docs/<n>-….
  2. Commit in stile Conventional Commits, in inglese, che citano l'issue (#n).
  3. scripts/check-packages.sh e scripts/test.sh verdi in locale.
  4. Pull request verso main con Closes #n, spiegazione di cosa cambia e come è stato verificato, screenshot se cambia l'interfaccia. La CI (Gitea Actions) deve essere verde.

Modificare la wiki

La wiki si modifica solo nei file docs/wiki/*.md del repository: a ogni push su main viene ripubblicata nel wiki Gitea e le modifiche fatte dall'editor web andrebbero perse. Convenzioni: riquadro di stato in testa, link [Testo](Nome-Pagina), immagini con URL raw del ramo main, screenshot reali in docs/wiki/img/.

Segnalare un problema

  • Bug e richieste: issue con etichetta Kind/Bug o Kind/Enhancement, passi per riprodurre, versione dell'immagine, sezione del Log e codice di traccia mostrato dall'errore.
  • Vulnerabilità di sicurezza: non aprire un'issue pubblica; segui le indicazioni di docs/SECURITY.md.