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.

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

feat: refactoring dati.gov.it platform #938

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

feat: refactoring dati.gov.it platform #938

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
178c630
feat: refactoring dati.gov.it platform
astagi Mar 13, 2021
d080364
Merge remote-tracking branch 'origin/master' into feature/datigovit
astagi Mar 23, 2021
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
55 changes: 28 additions & 27 deletions _platforms/en/datigov.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks a bit outdated, WDYT?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's wait for their answer :)

- 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure that's the official one, let's wait for an answer before publishing.

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
Expand All @@ -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)
<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>

56 changes: 27 additions & 29 deletions _platforms/it/datigov.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)
<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>