Aggiungi istruzioni su come utilizzare Antispam IT nel README e nel documento dedicato

Author: marco-acorte

README.it.md

@@ -21,6 +21,11 @@ le liste sono:
 - [spamassassin-blocklist.txt](https://raw.githubusercontent.com/marco-acorte/antispam-it/main/spamassassin-blocklist.txt) (regole già preparate per essere aggiunte a /etc/mail/spamassassin/local.cf)
 - [outlook-blocklist.txt](https://raw.githubusercontent.com/marco-acorte/antispam-it/main/outlook-blocklist.txt) (regole già pronte per essere aggiunte a MS Outlook)
 
+## Come usarlo
+
+Puoi usare il progetto antispam-it per bloccare le email di spam aggiungendo i domini indesiderati al tuo client o server di posta elettronica.
+maggiori dettagli nel documento [come usarlo](docs/how-to-use.it.md).
+
 ## 💖 Sostieni lo sviluppo
 
 ### Ti piace questo progetto? Sostienilo donando

README.md

@@ -19,6 +19,12 @@ the lists are:
 - [spamassassin-blocklist.txt](https://raw.githubusercontent.com/marco-acorte/antispam-it/main/spamassassin-blocklist.txt) (rules already prepared to be added to /etc/mail/spamassassin/local.cf)
 - [outlook-blocklist.txt](https://raw.githubusercontent.com/marco-acorte/antispam-it/main/outlook-blocklist.txt) (rules already prepared to be added to MS Outlook)
 
+## How to use
+
+You can use the antispam-it project to block spam emails by adding bad domains to your email client or server.
+more details in the [how to use](docs/how-to-use.md) document.
+
+
 ## 💖 Support development
 
 ### Do you like this project? Support it by donating

docs/how-to-use.it.md

@@ -0,0 +1,68 @@
+# Come usare Antispam IT
+
+## Introduzione
+
+Antispam IT è un progetto open source che mira a fornire un sistema di filtraggio delle email per ridurre lo spam e le email indesiderate. Questo documento fornisce una guida su come utilizzare Antispam IT.
+
+## Come utilizzare Antispam IT
+
+Antispam IT può essere utilizzato sia a livello client che server per bloccare le email di spam aggiungendo domini indesiderati al tuo client o server di posta elettronica.
+
+### Utilizzo lato client
+
+#### Come utilizzare in uBlock Origin
+
+Puoi utilizzare Antispam IT con uBlock Origin per bloccare i domini di spam nel tuo browser web. Segui questi passaggi:
+
+1. Installa uBlock Origin dal negozio di estensioni del tuo browser.
+2. Apri il dashboard di uBlock Origin facendo clic sull'icona dell'estensione e selezionando "Dashboard".
+3. Vai alla scheda "Filter Lists".
+4. Scorri verso il basso fino alla sezione "Custom".
+5. Fai clic su "Import" e incolla l'URL della lista Antispam IT (ad esempio, `https://raw.githubusercontent.com/marco-acorte/antispam-it/main/antispam-it.txt`).
+6. Fai clic su "Apply changes" per salvare la lista dei filtri.
+
+#### Come utilizzare in Thunderbird
+
+Puoi utilizzare Antispam IT per bloccare le email di spam in Thunderbird creando un filtro che controlla le email in arrivo rispetto alla lista dei domini indesiderati.
+Secondo le [regole antispam da importare in Thunderbird](https://www.wilderssecurity.com/threads/antispam-rules-to-import-in-thunderbird.280688/#post-1738806), puoi impostare un filtro come segue:
+
+1. Apri Thunderbird e vai al menu "Strumenti".
+2. Seleziona "Filtri messaggi".
+3. Fai clic su "Nuovo" per creare un nuovo filtro.
+4. Dai un nome al filtro (ad esempio, "Blocca Spam").
+5. Imposta il filtro per applicarsi durante il controllo della posta o l'esecuzione manuale.
+6. Nella sezione "Match any of the following", aggiungi condizioni per verificare se il campo "Da" contiene uno dei domini indesiderati dalla lista Antispam IT.
+7. Nella sezione "Perform these actions", imposta l'azione su "Elimina messaggio" o "Sposta in Posta indesiderata".
+8. Salva il filtro.
+9. Esegui il filtro sulla tua casella di posta per applicarlo alle email esistenti.
+
+#### Come utilizzare in altri client di posta elettronica
+
+Puoi utilizzare Antispam IT in altri client di posta elettronica seguendo passaggi simili per creare filtri o regole che controllano le email in arrivo rispetto alla lista dei domini indesiderati.
+
+### Utilizzo lato server
+
+#### Spamassassin
+
+Puoi utilizzare Antispam IT con Spamassassin per bloccare le email di spam sul tuo server di posta elettronica.
+
+Puoi utilizzare (o studiare) lo script bash fornito nel repository per automatizzare il processo di download e aggiornamento della lista Antispam IT per Spamassassin.
+
+Puoi trovare lo script nel file `import-rules.sh` del repository.
+
+Lo script scaricherà l'ultima lista Antispam IT e aggiornerà automaticamente la tua configurazione di Spamassassin.
+
+#### Come utilizzare nei server di posta elettronica
+
+Se gestisci un server di posta elettronica, puoi integrare la lista Antispam IT nel sistema di filtraggio dello spam del tuo server. Questo di solito comporta:
+
+1. Scaricare l'ultima lista Antispam IT in un formato compatibile con il tuo server di posta elettronica (ad esempio, `hosts`, `json`, `csv` o `txt`).
+2. Configurare le impostazioni di filtraggio dello spam del tuo server di posta elettronica per utilizzare la lista Antispam IT.
+3. Impostare il server per bloccare o contrassegnare le email che corrispondono a uno dei domini indesiderati nella lista.
+
+### Come contribuire
+
+Se desideri contribuire al progetto Antispam IT, puoi:
+
+- Segnalare nuovi domini di spam aprendo un issue nel repository GitHub.
+- Creare pull request per aggiungere nuovi domini o migliorare la documentazione.

docs/how-to-use.md

@@ -0,0 +1,64 @@
+# How to use antispam-it
+
+Use the antispam-it project to block spam emails by adding bad domains to your email client or server.
+
+## client-side usage
+
+### How to use in uBlock Origin
+
+You can use the antispam-it project with uBlock Origin to block spam domains your web browser. Follow these steps:
+
+1. Install uBlock Origin from the browser's extension store.
+2. Open uBlock Origin's dashboard by clicking on the extension icon and selecting "Dashboard".
+3. Go to the "Filter Lists" tab.
+4. Scroll down to the "Custom" section.
+5. Click on "Import" and paste the URL of the antispam-it list (e.g., `https://raw.githubusercontent.com/marco-acorte/antispam-it/main/antispam-it.txt`).
+6. Click "Apply changes" to save the filter list.
+
+### How to use in Thunderbird
+
+You can use the antispam-it project to block spam emails in Thunderbird by creating a filter that checks incoming emails against the list of bad domains.
+
+According to the [antispam rules to import in Thunderbird](https://www.wilderssecurity.com/threads/antispam-rules-to-import-in-thunderbird.280688/#post-1738806), you can set up a filter as follows:
+
+1. Open Thunderbird and go to the "Tools" menu.
+2. Select "Message Filters".
+3. Click on "New" to create a new filter.
+4. Name the filter (e.g., "Block Spam").
+5. Set the filter to apply when checking mail or manually running it.
+6. In the "Match any of the following" section, add conditions to check if the "From" field contains any of the bad domains from the antispam-it list.
+7. In the "Perform these actions" section, set the action to "Delete Message" or "Move to Junk".
+8. Save the filter.
+9. Run the filter on your inbox to apply it to existing emails.
+
+### How to use in other email clients
+
+You can use the antispam-it project in other email clients by following similar steps to create filters or rules that check incoming emails against the list of bad domains.
+
+## Server-side usage
+
+## Spamassassin
+
+You can use the antispam-it project with Spamassassin to block spam emails on your email server.
+
+You can use (or study) the bash script provided in the repository to automate the process of downloading and updating the antispam-it list for Spamassassin.
+
+You can find the script in the `import-rules.sh` file of the repository.
+
+The script will download the latest antispam-it list and update your Spamassassin configuration automatically.
+
+### How to use in email servers
+
+If you manage an email server, you can integrate the antispam-it list into your server's spam filtering system. This typically involves:
+
+1. Downloading the latest antispam-it list in a format compatible with your email server (e.g., `hosts`, `json`, `csv`, or `txt`).
+2. Configuring your email server's spam filtering settings to use the antispam-it list.
+3. Setting the server to block or mark emails that match any of the bad domains in the list.
+
+## How to contribute
+
+If you want to contribute to the antispam-it project, you can:
+
+1. Report new spam domains by creating an issue on the project's GitHub repository.
+2. Submit a pull request with your changes to the list.
+3. Share your experience or improvements in the project's documentation.