Skip to content
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.

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

feat: refactoring dati.gov.it platform #938

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
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
49 changes: 25 additions & 24 deletions _platforms/en/datigov.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,24 @@ socials:
name: youtube
icon: youtube
link: //www.youtube.com/channel/UCHsqR2YhxeKgFT4rAKVcAAQ
resources:
- Documentation:
- title: Open Data tools
icon: link
url: https://www.dati.gov.it/fare-open-data/Strumenti-per-gli-Open-Data
- title: How to feed the National Open Data Catalog
icon: link
url: https://www.dati.gov.it/Come-alimentare-il-Catalogo-nazionale
- Source code:
- title: dati.gov.it repository
icon: github
url: https://github.com/italia/ckan-it
desc: dati.gov.it source code based on CKAN
- 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
Expand All @@ -30,37 +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 public development roadmap
* Source code open from the start
* 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:

[Architectural document for evolution of dati.gov.it (ITA)](https://docs.google.com/document/d/1dCfbpwmkl-U2kreykRY8YXJct6GOe-r_3qjism5wI2Y/edit){:target="_blank"}


## 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){:target="_blank"}

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){:target="_blank"}

[New frontend server](https://github.com/italia/dati-frontendserver){:target="_blank"}
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"}.

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.

## 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){:target="_blank"}

[Issue tracking](https://github.com/italia/dati.gov.it/issues){:target="_blank"}

[Development roadmap](https://github.com/italia/dati.gov.it/projects){:target="_blank"}
<a class="btn btn-primary" href="https://forum.italia.it/" target="_blank"><i class="it-horn" /> Enter the forum</a>
<a class="btn btn-primary" href="https://groups.google.com/a/teamdigitale.governo.it/forum/#!forum/data" target="_blank"><i class="it-horn" /> Mailing-list OpenData & Analytics</a>
<a class="btn btn-primary" href="https://github.com/italia/dati.gov.it/issues" target="_blank"><i class="it-github" /> Issue tracker</a>
55 changes: 26 additions & 29 deletions _platforms/it/datigov.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,24 @@ socials:
name: youtube
icon: youtube
link: //www.youtube.com/channel/UCHsqR2YhxeKgFT4rAKVcAAQ
resources:
- Documentazione:
- title: Strumenti per gli Open Data
icon: link
url: https://www.dati.gov.it/fare-open-data/Strumenti-per-gli-Open-Data
- title: Come alimentare il Catalogo nazionale degli Open Data
icon: link
url: https://www.dati.gov.it/Come-alimentare-il-Catalogo-nazionale
- Sorgente:
- title: Repository dati.gov.it
icon: github
url: https://github.com/italia/ckan-it
desc: Codice sorgente GitHub dati.gov.it basato su CKAN
- 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
Expand All @@ -37,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){:target="_blank"}

[Le linee guida tecniche per i cataloghi dati](https://docs.italia.it/italia/daf/linee-guida-cataloghi-dati-dcat-ap-it/){:target="_blank"}


## 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){:target="_blank"}


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){:target="_blank"}

[Nuovo frontend server](https://github.com/italia/dati-frontendserver){:target="_blank"}


## 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){:target="_blank"}

[Issue tracking del progetto](https://github.com/italia/dati.gov.it/issues){:target="_blank"}
un issue tracker pubblico su GitHub

[Pianificazione dello sviluppo](https://github.com/italia/dati.gov.it/projects){:target="_blank"}
<a class="btn btn-primary" href="https://forum.italia.it/" target="_blank"><i class="it-horn" /> Entra nel forum</a>
<a class="btn btn-primary" href="https://groups.google.com/a/teamdigitale.governo.it/forum/#!forum/data" target="_blank"><i class="it-horn" /> Mailing-list OpenData & Analytics</a>
<a class="btn btn-primary" href="https://github.com/italia/dati.gov.it/issues" target="_blank"><i class="it-github" /> Issue tracker</a>