# Pubblicare la documentazione del Comune

{% hint style="warning" %}
Per Documento non si intende un file, ma **una pagina web che descrive un documento**, con le sue proprietà e un link verso il file del documento.
{% endhint %}

## Vai alla sezione "Amministrazione"

Collocati nella sezione "Amministrazione" (1) e scegli la sotto-sezione "Documenti e dati" (2)

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FIaK3lWC7nluG7MeTZuWq%2Fimage.png?alt=media&#x26;token=9121f80a-1099-4a40-93e6-23773578225f" alt=""><figcaption></figcaption></figure>

## Scegli la categoria del Documento

Successivamente, scegli la categoria di documento che vuoi creare.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FKsKyjCKSJCwZ1naQH1lv%2Fimage.png?alt=media&#x26;token=16b1b254-d125-4a67-ba49-1b8e1fe02b0f" alt=""><figcaption></figcaption></figure>

## Crea un Documento

Dopo aver scelto la categoria, procedi alla [creazione del contenuto](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FDrqD679yjq3ju2T6drlE%2Fimage.png?alt=media&#x26;token=4cce778a-78a5-4084-a97a-155bb8ec5445" alt=""><figcaption></figcaption></figure>

Inserisci il titolo, che sia semplice e comprensibile per il cittadino (max. 60 caratteri).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FWDA8gL8sk68gbqmPvG5X%2Fimage.png?alt=media&#x26;token=4d42fd5e-ffc1-408c-9822-9744460b6adc" alt=""><figcaption></figcaption></figure>

## Specifica il tipo di documento

Indica la tipologia di documento che stai creando. Scegli sempre quella più specifica possibile, non fermarti mai alla tipologia generale.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FdeDcFpYyMLrZfutM73Vy%2Fimage.png?alt=media&#x26;token=e5bb787e-b4bf-49fb-b071-ae9b5e262e59" alt=""><figcaption></figcaption></figure>

Per indicare il tipo di documento, cercalo nel menù ad albero (1) e poi clicca sulla tipologia che vuoi indicare (2).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2F1YFempSkhgKtRESYQXp4%2Fimage.png?alt=media&#x26;token=1fbd8ba1-b74d-4762-8757-8450aa55ed89" alt=""><figcaption></figcaption></figure>

In alternativa, puoi cercare la tipologia di documento tramite barra di selezione e poi cliccare sulla tipologia.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FQwvJBIJKxYIxlXmPoWre%2Fimage.png?alt=media&#x26;token=54a2a76a-2ee5-4bf5-8ae7-ee525e506191" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Alcuni campi del contenuto vanno compilati in base alla tipologia di documento che hai selezionato (ad es. "Tipologia di bando" per i bandi di gara o "Data di passaggio in Giunta" per accordi e convenzioni).&#x20;
{% endhint %}

## Descrizione breve

Dopo la categoria, inserisci la descrizione breve del contenuto, che **non deve** superare i 160 caratteri (spazi inclusi).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FtLiWj417rktlwX6LUq4I%2Fimage.png?alt=media&#x26;token=5195baff-de67-4880-87a0-1e60e5d3bcde" alt=""><figcaption></figcaption></figure>

## Indicare l'ufficio responsabile

Specifica l'ufficio responsabile o proponente del documento [creando una relazione](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti) tra l'oggetto e un'[Unità organizzativa](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/gestire-lorganigramma-del-comune).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FK2J9t3Xl1X2eOS1gtNur%2Fimage.png?alt=media&#x26;token=a1019a2c-d0ce-44f8-a567-61b3889c24fa" alt=""><figcaption></figcaption></figure>

## Specifica la licenza di distribuzione

{% hint style="info" %}
Come per le [immagini](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/linee-guida/utilizzare-le-immagini) e i [dataset](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset), anche per i documenti devi indicare la corretta licenza di distribuzione.
{% endhint %}

Seleziona dal menù ad albero tramite barra di selezione (1) o cercandolo manualmente tra le opzioni disponibili (2).

<div data-full-width="true"><figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FlZt3gvNuaB9hqDQXf8ES%2Fimage.png?alt=media&#x26;token=f4856581-372d-459a-a665-1758a8055f78" alt=""><figcaption></figcaption></figure> <figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2F1Hg3j7Sd33OcX8Qt6g6q%2FDetermina-di-aggiudicazione-Adozione-piattaforma-pagoPA-Atti-normativi-Documenti-e-dati-Amministrazione-Homepage-Comune-di-Bugliano-11-29-2024_10_44_AM.png?alt=media&#x26;token=9ba9494c-c73c-41f4-a47d-d8598eaf0e98" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Sul sito comunale i dati, documenti, immagini e informazioni devono essere pubblicati con licenza aperta.&#x20;

In applicazione del [principio open by default](https://docs.italia.it/italia/design/lg-design-servizi-web/it/versione-corrente/requisiti.html#licenze) e salvo dove diversamente specificato (compresi i contenuti incorporati di terzi), i dati, i documenti e le informazioni pubblicati sul sito devono essere taggati con la licenza **CC-BY 4.0.**&#x20;
{% endhint %}

## Indica il formato dei file

{% hint style="info" %}
È consigliabile scegliere i formati più comunemente utilizzati, in modo tale che siano fruibili a tutti (es. PDF)
{% endhint %}

Specifica, sulla base della lista a disposizione, il tipo di formato con cui metti a disposizione i file del Documento

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FA47f6aIJ4TjyppSv94Xr%2Fimage.png?alt=media&#x26;token=6580ee6e-9a45-4a40-b4f9-342f106abdfd" alt=""><figcaption></figcaption></figure>

## Allega i file al Documento

Durante la creazione del contenuto puoi:

* caricare il link al documento vero e proprio (1);
* [caricare più allegati](#caricare-piu-file-allegati) (2);
* inserire un collegamento ipertestuale, se il documento è esterno al sito comunale (3)
* [inserire più link allegati](#inserire-piu-link-allegati) (4);

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FM3fPZT2I2iAtGAi38Lzd%2Fimage.png?alt=media&#x26;token=62326a08-36a7-454e-bd4a-b49f33e4ad04" alt=""><figcaption></figcaption></figure>

### Caricare più file allegati

Nel caso in cui il documento preveda più file da allegare, nel campo "Documenti allegati" clicca su "Aggiungi file"

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FRytgBdTaVLznml5sl7gK%2Fimage.png?alt=media&#x26;token=5273bde5-1a09-4a25-9723-25b37378bc2a" alt=""><figcaption></figcaption></figure>

Aggiunti i file, puoi:

* modificare il titolo visualizzato del file ("Titolo visualizzato");
* raggruppare i file caricati in vari gruppi ("Raggruppamento");
* aggiungere una descrizione al file caricato ("Descrizion&#x65;*"*).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FtltwhnjzGf73UTMsijoi%2Fimage.png?alt=media&#x26;token=f7be3926-d2ab-4844-a75e-20a2653bf879" alt=""><figcaption></figcaption></figure>

Questa funzionalità ti permette di organizzare i file del Documento e rendere il contenuto più fruibile.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FnPP8dXLji7dyL3HlHEoZ%2Fimage.png?alt=media&#x26;token=c804b4b1-318d-4848-a91e-8bb630cd6db6" alt=""><figcaption></figcaption></figure>

### Inserire più link allegati

Indica il numero di righe da inserire e clicca su "Aggiungi righe"

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2F3mE340arN5tjJLo5p8Xi%2Fimage.png?alt=media&#x26;token=26497ece-ed43-4c4e-925b-1ac4c9987924" alt=""><figcaption></figcaption></figure>

Una volta inserite, devi indicare:

* titolo;
* link all'allegato;
* descrizione;
* raggruppamento.

## Specifica il periodo di validità

Indica a partire da quando e fino a quando il documento che stai creando ha validità.

{% hint style="info" %}
La voce "Data di inizio validità/efficacia" viene compilata in automatico con la data di creazione del contenuto, ma può essere modificata all'occorrenza da un redattore.
{% endhint %}

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fi7AupaiEqJIggqMzqOUA%2Fimage.png?alt=media&#x26;token=d88b096b-5c02-491b-a7d0-a9c1101a65a9" alt=""><figcaption></figcaption></figure>

## Pubblicare il contenuto

Una volta compilati i campi obbligatori, [pubblica il contenuto](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/pubblicare-un-contenuto) sul sito web.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FvyxUEQSmleU3H7tA0RgJ%2Fimage.png?alt=media&#x26;token=3bab0d19-8356-4f04-966a-06ee626cfe2f" alt=""><figcaption></figcaption></figure>