fix: small fixes and improvements

Author: libremente

docs/en/categories-list.rst

@@ -6,9 +6,10 @@ List of software categories
 Here follows a controlled vocabulary of useful tags for categorizing the
 software.
 
-===
-Tag
-===
+==========
+Valid Tags
+==========
+
 - accounting
 - agile-project-management
 - applicant-tracking

docs/en/country.rst

@@ -17,10 +17,12 @@ software is integrated with the Italian Public Identification System.
 
 If a software is compliant I will find:
 
-.. code:: .yaml
+.. code:: yaml
 
    it:
-     spid: yes
+     countryExtensionVersion: "0.2"
+     piattaforme:
+      - spid: yes
 
 Notice that country-specific extensions within international sections
 are not allowed. Countries that want to extend the format should add a
@@ -29,4 +31,4 @@ country-specific section instead.
 Documentation for the keys contained in a country specific section is
 maintained in separate files.
 
--  Italy: :ref:`italia-extensions`. 
+-  Italy: :ref:`italian-extensions`. 

docs/en/example/publiccode.minimal.yml

@@ -7,8 +7,8 @@ releaseDate: "2017-04-15"
 platforms:
   - web
 
-tags:
-  - texteditor
+categories:
+  - financial-reporting
 
 developmentStatus: development
 

docs/en/index.rst

@@ -45,7 +45,6 @@ Table of contents
    :numbered:
 
    schema.core.rst
-   schema.it.rst
    country.rst
    forks.rst
    categories-list.rst

docs/en/scope-list.rst

@@ -6,9 +6,10 @@ Scope list
 Here follows a controlled vocabulary of useful tags for categorizing the
 software.
 
-===
-Tag
-===
+==========
+Valid Tags
+==========
+
 - agriculture
 - culture
 - defence

docs/it/categories-list.rst

@@ -6,9 +6,9 @@ Lista delle categorie di software
 Qui di seguito è presentato un vocabolario controllato di tag utilizzabili
 per categorizzare il software.
 
-===
-Tag
-===
+==========
+Tag Validi
+==========
 - accounting
 - agile-project-management
 - applicant-tracking

docs/it/country.rst

@@ -19,10 +19,12 @@ Identità Digitale.
 
 Dunque, se un software è compatibile, troveremo:
 
-.. code:: .yaml
+.. code:: yaml
 
    it:
-     spid: yes
+     countryExtensionVersion: "0.2"
+     piattaforme:
+        - spid: yes
 
 Nota bene che le chiavi *country-specific* **non** sono valide
 all’interno delle sezioni internazionali. I Paesi che vogliano estendere

docs/it/example/publiccode.minimal.yml

@@ -7,8 +7,8 @@ releaseDate: "2017-04-15"
 platforms:
   - web
 
-tags:
-  - texteditor
+categories:
+  - financial-reporting
 
 developmentStatus: development
 

docs/it/index.rst

@@ -46,7 +46,6 @@ Indice dei contenuti
    :numbered:
 
    schema.core.rst
-   schema.it.rst
    country.rst 
    forks.rst
    categories-list.rst

docs/it/schema.core.rst

@@ -62,7 +62,7 @@ l’autenticazione.
 I fork creati con lo scopo di contribuire *upstream* non devono
 modificare questo file; questo aiuta i software che fanno il parsing di
 ``publiccode.yml`` a saltare immediatamente i fork tecnici. Al
-contrario, un fork completo che sarà mantenuto
+contrario, un fork completo che sarà manutenuto
 in modo separato rispetto al software originale, dovrebbe modificare
 questa linea per essere trattato come una variante distinta.
 
@@ -268,7 +268,7 @@ Le chiavi sono:
    aver ancora avuto una release pubblica preliminare. 
 -  ``stable`` - Il software ha già avuto una prima release pubblica ed è pronto
    per essere usato in un contesto di produzione. 
--  ``obsolete`` - Il software non è più mantenuto o aggiornato. Tutto il codice
+-  ``obsolete`` - Il software non è più manutenuto o aggiornato. Tutto il codice
    sorgente è archiviato e tenuto per ragioni di storico.
 
 Chiave ``softwareType``
@@ -277,8 +277,8 @@ Chiave ``softwareType``
 -  Tipo: stringa
 -  Presenza: obbligatoria
 -  Valori permessi: ``standalone/mobile``, ``standalone/iot``,
-  ``standalone/desktop``, ``standalone/web``, ``standalone/backend``,
-  ``standalone/other``, ``addon``, ``library``, ``configurationFiles``
+   ``standalone/desktop``, ``standalone/web``, ``standalone/backend``,
+   ``standalone/other``, ``addon``, ``library``, ``configurationFiles``
 
 Le chiavi sono: 
 
@@ -642,6 +642,7 @@ Chiave ``maintenance/type``
 -  Valori: ``"internal"``, ``"contract"``, ``"community"``, ``"none"``
 
 Questa chiave descrive come il software è attualmente manutenuto.
+Le chiavi sono:
 
 -  ``"internal"`` - significa che il software è manutenuto internamente dal
    proprietario del repository;