davideandClaude
2d7ace07e2
Reverse engineering di 9253000117a.prt.35: contenitore (offset dall'ultimo campo dell'intestazione, indice a catena), grammatica completa delle sezioni (id progressivi dei campi, tabella "dopo X viene Y", marcatori di chiusura), tabella dei double verificata sulla norma delle matrici, sezioni compresse e catalogo del contenuto. Parser Python in scripts/psb/. docs/history.md raccoglie stato, metodo e punti aperti per riprendere il lavoro. Co-Authored-By: Claude <noreply@anthropic.com>
3.3 KiB
3.3 KiB
Documentazione di PrepStep
Indice dei doc, organizzati secondo Diátaxis: ogni file ha uno scopo, e cambia solo quando cambia il programma.
Tutorial — imparare facendo
tutorial-primo-giro.md— il primo giro completo con una distinta vera.
How-to — svolgere un compito
guida-utente.md— i passi dell'utente fino a Creo Distributed Batch.risoluzione-problemi.md— sintomo → causa → cosa fare.sviluppo.md— build, test, script e regole per scrivere i doc.rilascio.md— pubblicare e generare il setup di una nuova versione.
Reference — consultare
architettura.md— il processo delle 5 fasi e la mappa file-per-file.db-cad-index.md— schema, vista e query dicad_index.db.formato-asm-record.md— parser esatto dei record.asm, casi limite (§7).formato-asm.md— euristica testuale di fallback.formato-prt-feature.md— come leggere l'albero delle feature di un.prt(reverse engineering, non ancora nel codice).formato-prt-geometria.md— numeri, quote e geometria degli schizzi di un.prt, con la tabella di cosa manca per determinarlo per intero.formato-psb.md— il formato di serializzazione di tutte le sezioni (.prte.asm): contenitore, grammatica, numeri, cosa c'è in ogni sezione, con un parser di riferimento inscripts/psb/.history.md— stato del reverse engineering dei file Creo: cosa è provato, cosa manca, da dove ripartire.glossario.md— i termini usati nei doc e nell'app.../CHANGELOG.md— storico delle versioni.
Explanation — capire il perché
decisioni/— registro delle scelte di progetto (ADR).copia-raw-parallela.md— perché e come la copia inraw/è 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 |
Formato dei record .asm e casi limite |
formato-asm-record.md |
Albero delle feature di un .prt |
formato-prt-feature.md |
Quote, coordinate e geometria degli schizzi di un .prt |
formato-prt-geometria.md |
Come è scritta una sezione qualsiasi di un .prt/.asm |
formato-psb.md |
| Processo delle 5 fasi, mappa dei file | architettura.md |
| Passi dell'utente | guida-utente.md |
| Build, test, regole sui doc | sviluppo.md |
| Procedura di rilascio e setup | rilascio.md |
| Perché una scelta è fatta così | decisioni/ |
| Storico release | ../CHANGELOG.md |
CLAUDE.md e README.md riassumono soltanto e rimandano a questi file.
Verifica
dotnet run scripts/CheckDocs.cs
npx markdownlint-cli2