Skip to content

Finalize v1.1.0 prerelease documentation #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Codewriter90x merged 1 commit into from
Jul 30, 2026
Merged

Finalize v1.1.0 prerelease documentation #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 20 additions & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,11 @@ CAP legacy, comuni riconosciuti tramite ISTAT e coordinate quando presenti.
**Working dataset:** `v1.1.0` prerelease · **Schema:** `2.1.0` ·
**Build:** 30 luglio 2026.

La release pubblicata `v1.0.0` è una baseline storica e non va interpretata
come certificazione di accuratezza o licenza. Gli output sotto `data/` sono
generati: non modificarli manualmente.
La prerelease corrente è
[`v1.1.0`](https://github.com/Codewriter90x/Italian_Cities/releases/tag/v1.1.0).
`v1.0.0` resta una baseline storica e non va interpretata come certificazione
di accuratezza o licenza. Gli output sotto `data/` sono generati: non
modificarli manualmente.

## Copertura

Expand Down Expand Up @@ -73,21 +75,25 @@ La data ISTAT non rende automaticamente aggiornati CAP e coordinate legacy.

## Download

Gli output correnti sono disponibili dal branch `main`:
Gli asset immutabili della prerelease corrente includono checksum e
attestazioni di provenienza della build:

| Formato | Download |
| --- | --- |
| Comuni CSV | [municipalities.csv](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/municipalities.csv) |
| Località CSV | [localities.csv](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/localities.csv) |
| Relazioni CAP CSV | [postal_codes.csv](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/postal_codes.csv) |
| Vista canonica CSV | [italian_locations.csv](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/italian_locations.csv) |
| JSON | [italian_locations.json](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/italian_locations.json) |
| Excel | [italian_locations.xlsx](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/italian_locations.xlsx) |
| SQLite | [italian_locations.sqlite](https://raw.githubusercontent.com/Codewriter90x/Italian_Cities/main/data/italian_locations.sqlite) |

La baseline pubblicata resta disponibile nella
| Comuni CSV | [municipalities.csv](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/municipalities.csv) |
| Località CSV | [localities.csv](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/localities.csv) |
| Relazioni CAP CSV | [postal_codes.csv](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/postal_codes.csv) |
| Vista canonica CSV | [italian_locations.csv](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/italian_locations.csv) |
| JSON | [italian_locations.json](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/italian_locations.json) |
| Excel | [italian_locations.xlsx](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/italian_locations.xlsx) |
| SQLite | [italian_locations.sqlite](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/italian_locations.sqlite) |
| SQL | [italian_locations.sql](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/italian_locations.sql) |
| SHA-256 | [SHA256SUMS](https://github.com/Codewriter90x/Italian_Cities/releases/download/v1.1.0/SHA256SUMS) |

La working copy sotto `data/` può anticipare la prossima release. La baseline
storica resta disponibile nella
[release v1.0.0](https://github.com/Codewriter90x/Italian_Cities/releases/tag/v1.0.0),
ma è superata dalla working copy e mantiene i limiti documentati.
con i propri limiti documentati.

## Dataset

Expand Down
11 changes: 9 additions & 2 deletions release/v1.1.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,15 @@ Importante:
- nomi provincia normalizzati sullo snapshot ISTAT, mantenendo il valore
originario;
- diff verificabile rispetto alla baseline `v1.0.0`;
- pipeline, documentazione, Pages e workflow coerenti con lo stato
sperimentale.
- validatori separati per schema, territorio, coordinate, provenienza e
formati;
- Ruff, type checking, coverage e compatibilità Python 3.11–3.13;
- CodeQL per Python e JavaScript;
- build release a privilegi di sola lettura, pubblicazione isolata e
attestazioni di provenienza degli asset;
- Pages con filtri condivisibili, confini regionali ISTAT 2026, download della
release corrente e tabella di copertura accessibile;
- roadmap pubblica e prime attività `good first issue`.

Ogni asset è generato da `data/italian_locations.csv` e coperto da
`SHA256SUMS`. Consultare `README.md`, `DATA_SOURCES.md`, `DATA_LICENSE.md` e
Expand Down