54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
 
|
# Documentazione di PrepStep
|
||
|
|
|
||
|
|
Indice dei doc, organizzati secondo [Diátaxis](https://diataxis.fr/): ogni file ha **uno** scopo,
|
||
|
|
e cambia solo quando cambia il programma.
|
||
|
|
|
||
|
|
## Tutorial — imparare facendo
|
||
|
|
|
||
|
|
- [`tutorial-primo-giro.md`](tutorial-primo-giro.md) — il primo giro completo con una distinta vera.
|
||
|
|
|
||
|
|
## How-to — svolgere un compito
|
||
|
|
|
||
|
|
- [`guida-utente.md`](guida-utente.md) — i passi dell'utente fino a Creo Distributed Batch.
|
||
|
|
- [`risoluzione-problemi.md`](risoluzione-problemi.md) — sintomo → causa → cosa fare.
|
||
|
|
- [`sviluppo.md`](sviluppo.md) — build, test, script e regole per scrivere i doc.
|
||
|
|
- [`rilascio.md`](rilascio.md) — pubblicare e generare il setup di una nuova versione.
|
||
|
|
|
||
|
|
## Reference — consultare
|
||
|
|
|
||
|
|
- [`architettura.md`](architettura.md) — il processo delle 5 fasi e la mappa file-per-file.
|
||
|
|
- [`db-cad-index.md`](db-cad-index.md) — schema, vista e query di `cad_index.db`.
|
||
|
|
- [`formato-asm-record.md`](formato-asm-record.md) — parser esatto dei record `.asm`, casi limite (§7).
|
||
|
|
- [`formato-asm.md`](formato-asm.md) — euristica testuale di fallback.
|
||
|
|
- [`glossario.md`](glossario.md) — i termini usati nei doc e nell'app.
|
||
|
|
- [`../CHANGELOG.md`](../CHANGELOG.md) — storico delle versioni.
|
||
|
|
|
||
|
|
## Explanation — capire il perché
|
||
|
|
|
||
|
|
- [`decisioni/`](decisioni/README.md) — registro delle scelte di progetto (ADR).
|
||
|
|
- [`copia-raw-parallela.md`](copia-raw-parallela.md) — perché e come la copia in `raw/` è parallela.
|
||
|
|
|
||
|
|
## Fonte unica (SSOT)
|
||
|
|
|
||
|
|
Ogni informazione vive in **un** posto; altrove si mette un link, non una copia.
|
||
|
|
|
||
|
|
| Informazione | Fonte |
|
||
|
|
|---|---|
|
||
|
|
| Versione e nome prodotto | `PrepStep/PrepStep.csproj` (`<Version>`, `<Product>`) |
|
||
|
|
| Schema e vista del DB | [`db-cad-index.md`](db-cad-index.md) |
|
||
|
|
| Formato dei record `.asm` e casi limite | [`formato-asm-record.md`](formato-asm-record.md) |
|
||
|
|
| Processo delle 5 fasi, mappa dei file | [`architettura.md`](architettura.md) |
|
||
|
|
| Passi dell'utente | [`guida-utente.md`](guida-utente.md) |
|
||
|
|
| Build, test, regole sui doc | [`sviluppo.md`](sviluppo.md) |
|
||
|
|
| Procedura di rilascio e setup | [`rilascio.md`](rilascio.md) |
|
||
|
|
| Perché una scelta è fatta così | [`decisioni/`](decisioni/README.md) |
|
||
|
|
| Storico release | [`../CHANGELOG.md`](../CHANGELOG.md) |
|
||
|
|
|
||
|
|
`CLAUDE.md` e `README.md` riassumono soltanto e rimandano a questi file.
|
||
|
|
|
||
|
|
## Verifica
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
dotnet run scripts/CheckDocs.cs
|
||
|
|
npx markdownlint-cli2
|
||
|
|
```
|