# Pubblicare la documentazione della ASL

## Vai alla sezione "Organizzazione"

{% hint style="warning" %}
La sezione "Organizzazione" **non è una voce di primo livello del sito.**

Per raggiungerla, cercala tramite ricerca libera o [mettila in primo piano in homepage](https://gitlab.com/opencity-labs/docs/-/blob/Redattori_ripristinato/opencity-labs/docs/modello-asl/personalizzare-la-homepage-del-sito-della-asl.md#inserisci-i-link-utili).
{% endhint %}

Collocati nella sezione "Organizzazione" (1) e seleziona la voce di secondo livello dedicata ai Documenti (2).

<div data-full-width="true"><figure><img src="/files/Y7GgQLLq10LnAb8aPujJ" alt=""><figcaption></figcaption></figure></div>

## Scegli la categoria del Documento

Una volta fatto accesso alla pagina, seleziona la categoria di documento che vuoi creare.

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

## Crea il 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/5rBVAsegoIAxybfnJD2l" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/T9UCsVQB5iC78B4ErUGU" 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="/files/5M01l1CzQyNxPOnvQ49j" 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/ngxpy9zYnyLtc9P4GXPF" 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/AhwZyyL14DBtWyBQOgNo" alt=""><figcaption></figcaption></figure>

## Descrivi il contenuto

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

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

Successivamente, inserisci la descrizione completa del Documento.

<figure><img src="/files/dAi2cLQe5swqBJT3jhI3" 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);

<figure><img src="/files/BU880U6MGWsvcT5NdrDI" 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/XigqVlJFGL1MjmF72XnT" 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/07STmmyx4OFdQ7sJOzGL" alt=""><figcaption></figcaption></figure>

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

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

## Specifica il periodo di validità del Documento

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/6AlsOrZ39sBDqVKkOLzT" 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-Struttura](/manuale-opencity-italia-sito-web-istituzionale-v3/modello-asl/organizzare-le-strutture-della-asl.md).

<figure><img src="/files/14dKHCuVxGaCfVl543Ba" alt=""><figcaption></figcaption></figure>

## Specifica la licenza di distribuzione

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.

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

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>

{% hint style="info" %}
È consigliabile scegliere formati facilmente utilizzabili, in modo tale che siano fruibili a tutti (es. PDF)
{% endhint %}

## Pubblica 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.

<figure><img src="/files/A0XkJymhybL2zAnI4ucq" 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-asl/pubblicare-la-documentazione-della-asl.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.