fix: broken links

Author: libremente

docs/en/index.rst

@@ -5,25 +5,26 @@
 
 By including a ``publiccode.yml`` file in the root of a repository, and populating it with information about the software, technicians and civil servants can evaluate it. Automatic indexing tools can also be built, since the format is easily readable by both humans and machines.
 
-``publiccode.yml`` is mandatory for all public software developed in Italy, according to the national [guidelines](https://docs.italia.it/AgID/linee-guida-riuso-software/lg-acquisizione-e-riuso-software-per-pa-docs/): this enables the Developers Italia crawler to build the national [software catalog](https://developers.italia.it/). The standard is designed to be interoperable internationally, thus the country-specific keys are separated by the core part and are defined in specific sections that each government can rule.
+``publiccode.yml`` is mandatory for all public software developed in Italy, according to the national `guidelines <https://docs.italia.it/AgID/linee-guida-riuso-software/lg-acquisizione-e-riuso-software-per-pa-docs/>`__: this enables the Developers Italia crawler to build the national `software catalog <https://developers.italia.it/>`__. The standard is designed to be interoperable internationally, thus the country-specific keys are separated by the core part and are defined in specific sections that each government can rule.
 
 Details carried by a ``publiccode.yml`` file include: 
 
--  title and description of the project or product (in one or more languages); 
--  development state (e.g., ``concept``, ``development``, ``beta``,
+- title and description of the project or product (in one or more languages); 
+- development state (e.g., ``concept``, ``development``, ``beta``,
   ``stable``, ``obsolete``; 
--  contacts of the entity who published the codebase; 
--  contacts of the maintainer, if any, including the expire date of the maintainance contract; 
--  information about the legal context for which the project or product was designed; 
--  dependencies.
+- contacts of the entity who published the codebase; 
+- contacts of the maintainer, if any, including the expire date of the maintainance contract; 
+- information about the legal context for which the project or product was designed; 
+- dependencies.
 
 and much more.
 
 See also
 ----------
 
-- [More information about software reuse](https://developers.italia.it/en/reuse)
-- [publiccode.yml web editor](https://publiccode-editor.developers.italia.it/)
+- `More information about software reuse <https://developers.italia.it/en/reuse>`__
+- `publiccode.yml web editor
+  <https://publiccode-editor.developers.italia.it/>`__
 
 Table of contents
 -----------------

docs/it/index.rst

@@ -6,7 +6,7 @@ conseguenza, riutilizzabili da altri enti.
 
 Inserendo nella root di un repository un file chiamato ``publiccode.yml`` che descrive le caratteristiche del software se ne agevola la comprensione ai tecnici e ai decisori pubblici interessati a valutarlo; al tempo stesso si permette di costruire strumenti automatici di indicizzazione, poiché il formato è facilmente leggibile sia da esseri umani sia da macchine.
 
-``publiccode.yml`` è obbligatorio per tutto il software pubblico sviluppato in Italia, come da [linee guida](https://docs.italia.it/AgID/linee-guida-riuso-software/lg-acquisizione-e-riuso-software-per-pa-docs/): questo consente al crawler automatico di Developers Italia di costituire il [catalogo del software a riuso](https://developers.italia.it/). Lo standard è tuttavia pensato in ottica internazionale, per cui tutte le specificità nazionali sono separate dal core e definite in apposite sezioni estensibili autonomamente dai governi nazionali.
+``publiccode.yml`` è obbligatorio per tutto il software pubblico sviluppato in Italia, come da `linee guida <https://docs.italia.it/AgID/linee-guida-riuso-software/lg-acquisizione-e-riuso-software-per-pa-docs/>`__: questo consente al crawler automatico di Developers Italia di costituire il `catalogo del software a riuso <https://developers.italia.it/>`__. Lo standard è tuttavia pensato in ottica internazionale, per cui tutte le specificità nazionali sono separate dal core e definite in apposite sezioni estensibili autonomamente dai governi nazionali.
 
 Tra le informazioni contenute in un ``publiccode.yml`` vi sono: 
 
@@ -23,8 +23,8 @@ e molte altre informazioni rilevanti.
 Link utili
 ----------
 
-- [Maggiori informazioni sul riuso del software](https://developers.italia.it/it/riuso)
-- [Editor web per publiccode.yml](https://publiccode-editor.developers.italia.it/)
+- `Maggiori informazioni sul riuso del software <https://developers.italia.it/it/riuso>`__
+- `Editor web per publiccode.yml <https://publiccode-editor.developers.italia.it/`__
 
 Indice dei contenuti
 --------------------