From 178c630e5db5383946a8637d91b96c57a63c583b Mon Sep 17 00:00:00 2001 From: Andrea Stagi Date: Sat, 13 Mar 2021 16:16:55 +0100 Subject: [PATCH] feat: refactoring dati.gov.it platform --- _platforms/en/datigov.md | 55 ++++++++++++++++++++------------------- _platforms/it/datigov.md | 56 +++++++++++++++++++--------------------- 2 files changed, 55 insertions(+), 56 deletions(-) diff --git a/_platforms/en/datigov.md b/_platforms/en/datigov.md index df895498fd4f..4365eab8c563 100644 --- a/_platforms/en/datigov.md +++ b/_platforms/en/datigov.md @@ -21,6 +21,25 @@ socials: name: youtube icon: youtube link: //www.youtube.com/channel/UCHsqR2YhxeKgFT4rAKVcAAQ +resources: + - Documentation: + - title: Architectural document for evolution of dati.gov.it + icon: file + url: https://docs.google.com/document/d/1dCfbpwmkl-U2kreykRY8YXJct6GOe-r_3qjism5wI2Y + - title: Technical guidelines for data catalogs + icon: file + url: https://docs.italia.it/italia/daf/linee-guida-cataloghi-dati-dcat-ap-it/ + desc: Technical guidelines for data catalogs including DCAT-AP_IT spec + - Source code: + - title: dati.gov.it repository + icon: github + url: https://github.com/FormezPA/dkan + desc: dati.gov.it source code based on DKAN (Drupal) + - Examples: + - title: Python client example + icon: github + url: https://github.com/italia/dati.gov.it-python-example + desc: Sample Python client that communicates with dati.gov.it API --- ## Intro @@ -29,38 +48,20 @@ Our aim is to evolve the current online portal of open data to a system that pro As with all the projects of Developers Italia, the portal of open data follows a development model based on a collaborative process which is typical of the community of developers. The tools that we want to use to structure the development process are: - * A development roadmap agile and public + * A development roadmap agile and public * Source code open from the start - * A public tracking system of the errors + * A public tracking system of the errors * Clear documentation of the code and the API -## Documentation +## Using API -Waiting for a publication of a further documentation concerning the project, in the meantime here you can find the architectural document: +Citizens, businesses and public administrations interested in using the metadata of the national catalog using the API can find all the information on the [page dedicated to site developers](https://www.dati.gov.it/sviluppatori){:target="_blank"}. -[Architectural document for evolution of dati.gov.it (ITA)](https://docs.google.com/document/d/1dCfbpwmkl-U2kreykRY8YXJct6GOe-r_3qjism5wI2Y/edit) +There is also a repository that implements a [sample Python client](https://github.com/italia/dati.gov.it-python-example){:target="_blank"} to show how to interface to the API. +## Canali -## Source code - -Here you can find the actual source code based on DKAN (Drupal), and soon we will publish a document to help you to create the development environment to contribute: - -[Repo GitHub for current dati.gov.it](https://github.com/FormezPA/dkan) - -While here you can find the repositories related to the evolution of dati.gov.it according to the architectural document: - -[Repo GitHub for evoution of dati.gov.it](https://github.com/italia/dati.gov.it) - -[New frontend server](https://github.com/italia/dati-frontendserver) - - -## Collaboration - -We have already open a mailing list to debate about data and open data, so there you can find the archive of previous discussions and you can sign up to participate. In addition, we have also arranged a public tracker on GitHub: - -[Mailing-list OpenData & Analytics (ITA)](https://groups.google.com/a/teamdigitale.governo.it/forum/#!forum/data) - -[Issue tracking](https://github.com/italia/dati.gov.it/issues) - -[Development roadmap](https://github.com/italia/dati.gov.it/projects) + Enter the forum + Mailing-list OpenData & Analytics + Issue tracker diff --git a/_platforms/it/datigov.md b/_platforms/it/datigov.md index ec2e49ec8034..ca9bcbc09f96 100644 --- a/_platforms/it/datigov.md +++ b/_platforms/it/datigov.md @@ -22,6 +22,25 @@ socials: name: youtube icon: youtube link: //www.youtube.com/channel/UCHsqR2YhxeKgFT4rAKVcAAQ +resources: + - Documentazione: + - title: Documento d'architettura dell'evoluzione di dati.gov.it + icon: file + url: https://docs.google.com/document/d/1dCfbpwmkl-U2kreykRY8YXJct6GOe-r_3qjism5wI2Y + - title: Linee guida tecniche per i cataloghi dati + icon: file + url: https://docs.italia.it/italia/daf/linee-guida-cataloghi-dati-dcat-ap-it/ + desc: Linee guida tecniche per i cataloghi dati che includono la specifica DCAT-AP_IT + - Sorgente: + - title: Repository dati.gov.it + icon: github + url: https://github.com/FormezPA/dkan + desc: Codice sorgente GitHub dati.gov.it basato su DKAN (Drupal) + - Esempi: + - title: Python client di esempio + icon: github + url: https://github.com/italia/dati.gov.it-python-example + desc: Client di esempio per interfacciarsi con le API di dati.gov.it --- ## Intro @@ -36,39 +55,18 @@ Come per tutti i progetti di Developers Italia, il portale dei dati aperti segue * Un sistema di tracciamento degli errori pubblico * Documentazione del codice e delle API chiaro +## Utilizzare le API -## Documentazione +I cittadini, le imprese e le pubbliche amministrazioni interessate ad utilizzare i metadati del catalogo nazionale utilizzando le API possono trovare tutte le informazioni nella [pagina dedicata agli sviluppatori del sito](https://www.dati.gov.it/sviluppatori){:target="_blank"}. -Qui puoi trovare la documentazione tecnica attualmente disponibile sia sul documento architetturale, sia sulle linee guida tecniche per i cataloghi dati che includono la specifica DCAT-AP_IT: +Esiste anche un repository che implementa un [client Python di esempio](https://github.com/italia/dati.gov.it-python-example){:target="_blank"} per mostrare come interfacciarsi alle API. -[Documento d'architettura dell'evoluzione di dati.gov.it](https://docs.google.com/document/d/1dCfbpwmkl-U2kreykRY8YXJct6GOe-r_3qjism5wI2Y/edit) - -[Le linee guida tecniche per i cataloghi dati](https://docs.italia.it/italia/daf/linee-guida-cataloghi-dati-dcat-ap-it/) - - -## Codice sorgente - -Qui puoi trovare l'attuale codice sorgente basato su DKAN (Drupal), e a breve pubblicheremo un documento per aiutarti a -creare l'ambiente di sviluppo per contribuire: - -[Repo GitHub attuale dati.gov.it](https://github.com/FormezPA/dkan) - - -Qui invece trovi i repositori relativi all'evoluzione di dati.gov.it come da documento architetturale: - -[Repo GitHub evoluzione dati.gov.it](https://github.com/italia/dati.gov.it) - -[Nuovo frontend server](https://github.com/italia/dati-frontendserver) - - -## Collaborazione +## Canali Abbiamo aperto già da tempo una mailing-list per trattare i temi di dati e opendata, per cui puoi trovare là l'archivio delle precedenti discussioni e iscriverti per partecipare. Inoltre, abbiamo anche predisposto -un tracker pubblico su GitHub: - -[Mailing-list OpenData & Analytics](https://groups.google.com/a/teamdigitale.governo.it/forum/#!forum/data) - -[Issue tracking del progetto](https://github.com/italia/dati.gov.it/issues) +un issue tracker pubblico su GitHub -[Pianificazione dello sviluppo](https://github.com/italia/dati.gov.it/projects) + Entra nel forum + Mailing-list OpenData & Analytics + Issue tracker