# JA3.3 - Come leggere questa raccolta

**In una frase.** Come sono fatti i libri di ADSWnext, cosa vogliono dire i codici davanti ai titoli e come si leggono gli schemi.

## Libri, capitoli, pagine

- **Un libro è un componente**: l'accesso, il Gateway, SIGEAnext, le stampe e così via. Sono dodici.
- **Un capitolo è un macro argomento** del componente.
- **Una pagina spiega una cosa sola.** Si legge in due minuti.

Ogni titolo comincia con un **codice**. Il codice dice il libro, il capitolo e la pagina, e tiene tutto nell'ordine in cui conviene leggere. Se cerchi una pagina di cui ti hanno detto il codice, scrivilo nella ricerca.

## Ogni libro ha la stessa forma

1. Si apre con **«A cosa serve»**: cosa fa il componente, cosa ci guadagni, dove sta nella mappa.
2. In mezzo ci sono i capitoli su come si usa, con una schermata vera per ogni passo importante.
3. Si chiude con **«Se qualcosa non va»** e con le parole da sapere.

In fondo alle pagine trovi due riquadri. **«Per chi sviluppa»** ha i dettagli tecnici: se non sei tecnico lo salti. **«Per approfondire»** dice quale guida più dettagliata esiste su quell'argomento.

## Tre tipi di schema

**La mappa con il componente acceso.** È la mappa a strati con tutto spento tranne il componente del libro. Dice subito dove sei.

<div drawio-diagram="2634"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/esempio-di-dove-sta-gateway-e-monitor-servizi-accesi-sulla-mappa.png" alt="Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa"/></div>

*Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa*

**Chi parla con chi.** Gli attori in alto, un passo per riga. Il numero dice l'ordine. La freccia tratteggiata è una risposta che torna indietro.

<div drawio-diagram="2635"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/esempio-di-chi-parla-con-chi-entro-e-apro-una-pagina.png" alt="Esempio di «chi parla con chi»: entro e apro una pagina"/></div>

*Esempio di «chi parla con chi»: entro e apro una pagina*

**Blocchi e frecce.** Per spiegare un meccanismo solo, senza il resto della mappa. Ne trovi uno in [In tre frasi](https://gsdoc.genesyssoftware.eu/link/37775).

<p class="callout info">**Nota.** Gli schemi sono disegni draw.io. Chi ha il permesso di modificare la pagina li apre con un doppio clic, li cambia e li salva: non serve nessun altro programma.</p>

<p class="callout info">**Per chi sviluppa.** La raccolta nasce dal repository, cartella `docs/guide/adswnext`. Le regole di scrittura sono in `docs/guide/adswnext/STILE.md`, i passi per pubblicare in `docs/guide/adswnext/PUBBLICARE.md`. Le guide tecniche di tutti i giorni restano in `docs/guide`.</p>