# 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="/files/kXvu3d9LmJXsGchvGzc3" alt=""><figcaption></figcaption></figure>

## Scegli la categoria del Documento

Successivamente, scegli la categoria di documento che vuoi creare.

<figure><img src="/files/jW4MfGVmTZp5c2OajzBj" alt=""><figcaption></figcaption></figure>

## Crea un Documento

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

<figure><img src="/files/8Si0vejiJMOglB2yOXuW" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uaXoiUKKP95JfaZiSHAl" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Puoi aggiungere al massimo 1 immagine di copertina. Se tenti di inserirne più di una, la piattaforma mostra un messaggio di errore e non ti permette di proseguire.
{% endhint %}

## 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="/files/zWgQ0k6esGitF9X5w61U" 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="/files/K3lWmVvjaNEQIgh9Pe8Q" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/HWOLgrsCMlWT4A6lbA5D" 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).
{% endhint %}

## Descrizione breve

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

<figure><img src="/files/W6UZlKQs0QZmzkvtotyy" alt=""><figcaption></figcaption></figure>

## Indicare l'ufficio responsabile

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

<figure><img src="/files/oplBRxhFb9HLFTHSuu2t" alt=""><figcaption></figcaption></figure>

## Specifica la licenza di distribuzione

{% hint style="info" %}
Come per le [immagini](/manuale-opencity-italia-sito-web-istituzionale-v3/linee-guida/utilizzare-le-immagini.md) e i [dataset](/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset.md), 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="/files/eaH8E9H0edGqdhBMlLz2" alt=""><figcaption></figcaption></figure> <figure><img src="/files/Iasd0L75EbLr19WPXEDJ" alt=""><figcaption></figcaption></figure></div>

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

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.**
{% 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="/files/PNbZzpMkodtSh1QDL5Ql" 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="/files/sDWS8R067V1f9iE1H87H" 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="/files/TmxOJaQIiiN1DDBxUqJ8" 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="/files/XSOwZsYP1OmgbyJhOHbh" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/KDGYhuwIJl1nVKBDPjkf" alt=""><figcaption></figcaption></figure>

### Inserire più link allegati

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

<figure><img src="/files/hTfz9L9eaIDCvrPPwwXI" 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="/files/7pAJjhoqh4a5TJxHrYPT" alt=""><figcaption></figcaption></figure>

## Pubblicare il contenuto

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

<figure><img src="/files/N80O97IWtn8378uB2BQ9" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/modello-comuni/pubblicare-la-documentazione-del-comune.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.