0 Fork 0

Files

T

davideandClaude Sonnet 5.5 ccfa00ff52 Aggiungi docs-as-code: indice Diátaxis, nuovi doc e controllo automatico

Nuovi doc: tutorial-primo-giro, risoluzione-problemi, sviluppo, rilascio,
glossario e registro delle decisioni (docs/decisioni, 6 ADR). docs/README.md
e' l'indice per categoria e la tabella delle fonti uniche; il README di
root rimanda a sviluppo/rilascio invece di duplicarli.

scripts/CheckDocs.cs verifica link e ancore, <Version> contro CHANGELOG,
copertura di architettura.md e presenza di ogni doc nell'indice;
.markdownlint-cli2.jsonc configura il lint Markdown.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

2026-10-02 08:05:10 +02:00

1.9 KiB

Raw Permalink Blame History

Rilasciare una nuova versione

Procedura per produrre il setup PrepStep-Setup-<versione>.exe, l'unico file da distribuire. Il comportamento del setup (installazione per-utente, aggiornamento, /VERYSILENT) è descritto in architettura.md; qui ci sono solo i passi da eseguire.

Una volta sola

Installa Inno Setup 6 per l'utente corrente (niente admin):

winget install --id JRSoftware.InnoSetup -e --scope user

A ogni release

Aggiorna <Version> in PrepStep/PrepStep.csproj (SemVer).
In CHANGELOG.md trasforma "Non rilasciato" nella nuova versione con la data e riscrivi sotto le modifiche (Aggiunto/Modificato/Corretto/Rimosso).
Controlla i doc: dotnet run scripts/CheckDocs.cs deve confermare che versione e CHANGELOG coincidono.
Esegui i test: dotnet test in PrepStep.Tests/.

Chiudi l'app se è aperta (l'exe in uso blocca la build), poi dalla root del repo:

dotnet publish PrepStep -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o PrepStep\publish
& "$env:LOCALAPPDATA\Programs\Inno Setup 6\ISCC.exe" installer\PrepStep.iss

Il setup è in installer\Output\PrepStep-Setup-<versione>.exe; la versione è letta dall'exe, quindi coincide con <Version>. Provalo lanciandolo.
Commit con codice, doc e CHANGELOG insieme (regola in README.md).

Solo l'eseguibile, senza setup

cd PrepStep
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o publish

Produce PrepStep\publish\PrepStep.exe, un file unico che gira su un Windows x64 senza .NET installato.

Da non toccare

AppGuid in installer/PrepStep.iss: è ciò che fa riconoscere a Windows le versioni nuove come aggiornamento della stessa app. Cambiarlo produce un'installazione doppia.

1.9 KiB Raw Permalink Blame History