prettified

GUIDELINES.md

@@ -2,7 +2,7 @@
 
 ## Intro
 
-Questo progetto nasce dalla __community per la community__ e, nel pieno spirito dell'open source, è importante prestare attenzione anche ad utilizzare una struttura che sia semplice, accessibile, modulare e manutenibile, oltre all'adozione di un linguaggio inclusivo.
+Questo progetto nasce dalla **community per la community** e, nel pieno spirito dell'open source, è importante prestare attenzione anche ad utilizzare una struttura che sia semplice, accessibile, modulare e manutenibile, oltre all'adozione di un linguaggio inclusivo.
 
 Per queste ragioni, vengono redatte queste linee guida, volte a creare una strategia che sia uniforme per la scrittura e per la struttura del libro nella sua interezza, con la certezza che questo lavoro servirà a rendere più accogliente il settore IT e tutte le persone che vogliono farvi parte, senza discriminazione alcuna, e con un'attenzione rivolta al rendere questo libro fruibile e manutenibile in maniera semplice il più a lungo possibile.
 
@@ -16,9 +16,9 @@ Lo scopo è proprio quello di preservare l'unicità dei contributi forniti da ch
 
 Queste linee guida, si rende quindi chiaro, vogliono preservare il contributo fornito e la revisione di tutti i contenuti non sarà meccanica, ma avverrà sempre dopo un'attenta valutazione di ogni singolo testo, per valutarne l'impatto.
 
-Considerato che il __gender gap__ in questo settore è un problema più che noto, è importante prestare attenzione, in un progetto di una certa portata come questo, al tipo di linguaggio che si vuole adottare: non è una novità che, secondo il [“Gender Gap Report 2022”](https://www.weforum.org/reports/global-gender-gap-report-2022/) del World Economic Forum, su 146 Stati mappati, l’Italia ha mantenuto il 63° posto, come lo scorso anno, per l’indice composito di “Gender Gap”.
+Considerato che il **gender gap** in questo settore è un problema più che noto, è importante prestare attenzione, in un progetto di una certa portata come questo, al tipo di linguaggio che si vuole adottare: non è una novità che, secondo il [“Gender Gap Report 2022”](https://www.weforum.org/reports/global-gender-gap-report-2022/) del World Economic Forum, su 146 Stati mappati, l’Italia ha mantenuto il 63° posto, come lo scorso anno, per l’indice composito di “Gender Gap”.
 
-Dare quindi la giusta importanza a questo livello di inclusione, è fondamentale per la buona riuscita del progetto e per ampliarne la portata e la diversità, rendendo questo libro sempre più __open__, anche seguendo quello che è ormai uno standard in molte delle aziende che partecipano ad iniziative open source. Una di queste, per avere un parallelo, è Red Hat: nel 2020, Chris Wright (CTO@Red Hat) ha pubblicato un [post](https://www.redhat.com/en/blog/update-red-hats-conscious-language-efforts) all'interno del blog per rivedere l'intero linguaggio adottato all'interno delle tecnologie e dei progetti a cui l'azienda lavora, come il ban permanente di termini come _master_ e _slave_ piuttosto che _blacklist_.
+Dare quindi la giusta importanza a questo livello di inclusione, è fondamentale per la buona riuscita del progetto e per ampliarne la portata e la diversità, rendendo questo libro sempre più **open**, anche seguendo quello che è ormai uno standard in molte delle aziende che partecipano ad iniziative open source. Una di queste, per avere un parallelo, è Red Hat: nel 2020, Chris Wright (CTO@Red Hat) ha pubblicato un [post](https://www.redhat.com/en/blog/update-red-hats-conscious-language-efforts) all'interno del blog per rivedere l'intero linguaggio adottato all'interno delle tecnologie e dei progetti a cui l'azienda lavora, come il ban permanente di termini come _master_ e _slave_ piuttosto che _blacklist_.
 
 Le community open si sono impegnate moltissimo negli ultimi tempi per far sì che questo tipo di atteggiamento sia incluso nel codice di condotta delle proprie iniziative, ed **è giusto che un libro come questo ne faccia bandiera.**
 
@@ -76,7 +76,7 @@ _Avete mai pensato di cambiare professione?_
 
 Il libro vuole mettere a suo agio la persona, non avvicinarla ad una setta.
 
-Per ciò che riguarda la gerarchia delle sezioni, non andare oltre il titolo di __terzo livello__, per evitare un vespaio di titoli e di macro-argomenti che rischiano di confondere. Questo vuol dire che, ad esempio, se si volesse scrivere un capitolo in cui si descrive una ricetta, una struttura adatta è la seguente:
+Per ciò che riguarda la gerarchia delle sezioni, non andare oltre il titolo di **terzo livello**, per evitare un vespaio di titoli e di macro-argomenti che rischiano di confondere. Questo vuol dire che, ad esempio, se si volesse scrivere un capitolo in cui si descrive una ricetta, una struttura adatta è la seguente:
 
 ```markdown
 # Curry di lenticchie
@@ -92,7 +92,6 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sit amet sapien s
 # Procedimento
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sit amet sapien sit amet lorem lacinia porttitor. Suspendisse pulvinar urna vel purus semper, eget finibus ex tincidunt. Curabitur congue nibh a arcu facilisis consequat. Curabitur tempor ligula eu lacus pretium cursus a ut felis.
-
 ```
 
 Al contrario, **non** è suggeribile una struttura di questo tipo:
@@ -126,10 +125,12 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sit amet sapien s
 Chi deve scrivere un contenuto deve essere consapevole delle sue caratteristiche e scegliere, anche per quanto riguarda l’uso del genere, una strategia appropriata che non contrasti con la naturale chiarezza, leggibilità e trasparenza richiesta da questo progetto.
 
 Per questo, tutte le tipologie di contenuto, è importante tenere presenti due principi base:
+
 1. dare visibilità ad un genere neutrale, per dare enfasi a tutte le persone potenzialmente coinvolte;
 2. garantire semplicità e chiarezza al contenuto dei documenti.
 
 Dal momento che la comunicazione è rivolta o si riferisce a più persone di genere maschile e femminile, come nel caso di sviluppo, carriere, community, eventi e molto altro ancora, è possibile adottare due diverse strategie per quanto riguarda il linguaggio:
+
 1. una strategia che dia visibilità al genere femminile, oppure
 2. una strategia di oscuramento di entrambi i generi, che vada a fornire delle alternative valide e inclusive.
 
@@ -139,8 +140,8 @@ Trovare invece dei modi dei metodi di riscrittura che non appesantiscano il test
 
 Per entrare nel vivo delle linee guida, vengono quindi riportati esempi pratici di come è possibile rendere inclusiva un'espressione, soprattutto per ciò che concerne il linguaggio e il mondo tech, attraverso alcune semplici regole.
 
-
 La strategia di oscuramento di entrambi i generi si può attuare in diversi modi:
+
 - utilizzando formulazioni neutre, cioè espressioni prive di referenza di genere (persona, soggetto, individuo) o riformulando con il "chi"
   esempio: “Possono partecipare all’iniziativa tutti gli sviluppatori...” oppure “Chi sviluppa può partecipare all’iniziativa...”
 - riformulando la frase con nomi collettivi o che si riferiscono al tipo di professione, eventualmente preferendo la parola inglese:
@@ -150,6 +151,7 @@ La strategia di oscuramento di entrambi i generi si può attuare in diversi modi
 
 Altra tecnica di oscuramento del genere è la riformulazione della frase a livello sintattico, evitando di usare forme personali.
 Ad esempio:
+
 - utilizzo di forme impersonali o del passivo
   esempio: “Per la scrittura di una buona documentazione, è necessario che chi si approcci alla scrittura, presti attenzione a...”
   invece di
@@ -159,12 +161,15 @@ Ad esempio:
 ## Espressioni di esempio
 
 Al fine di rispettare quanto descritto finora, è importante prestare attenzione al linguaggio adottato: per questo, vengono riportati alcuni esempi emersi finora (in costante aggiornamento) rispetto a frasi, locuzioni, espressioni o parole che possono avere delle valide alternative in un contesto di inclusione.
-_______________________________________________________________________________________
+
+---
+
 NB: Non è possibile modificare i nomi di istituzioni o aziende, convenzioni o standard, idem per leggi o documenti ufficiali.
-___________________________________________________________________________________________________
+
+---
 
 | **Invece di...**                 | **Meglio usare...**                                           |
-|----------------------------------|---------------------------------------------------------------|
+| -------------------------------- | ------------------------------------------------------------- |
 | L'uomo/la donna                  | Le persone                                                    |
 | Lo sviluppatore/la sviluppatrice | Chi sviluppa, chi programma, la professione di developer      |
 | Il recruiter                     | Chi fa recruitement, la figura del/la recruiter               |