Moved country extension to other page (#41)

fix: several typos
feat: moved country extension to new file.

Author: libremente

docs/en/country.rst

@@ -0,0 +1,32 @@
+.. _`country-extension`:
+
+Country-Specific Sections
+=========================
+
+While the standard is structured to be meaningful on an international
+level, there are additional information that can be added that makes
+sense in specific countries, such as declaring compliance with local
+laws or regulations. The provided extension mechanism is the usage of
+country-specific sections.
+
+All country-specific extensions are contained in a section named with
+the two-letter lowercase `ISO 3166-1 alpha-2 country
+code <https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__. For instance
+``spid`` is a property for Italian software declaring whether the
+software is integrated with the Italian Public Identification System.
+
+If a software is compliant I will find:
+
+.. code:: .yaml
+
+   it:
+     spid: yes
+
+Notice that country-specific extensions within international sections
+are not allowed. Countries that want to extend the format should add a
+country-specific section instead.
+
+Documentation for the keys contained in a country specific section is
+maintained in separate files.
+
+-  Italy: :ref:`italia-extensions`. 

docs/en/index.rst

@@ -5,10 +5,10 @@ The ``publiccode.yml`` Standard
    :numbered:
 
    intro.rst
-   schema.md
-   schema.it.md
-   forks.md
-   pa-types.md
-   tags.md 
-   tools.md
+   schema.rst
+   country.rst
+   forks.rst
+   pa-types.rst
+   tags.rst 
+   tools.rst
    example.rst

docs/en/schema.rst

@@ -4,40 +4,9 @@ The Standard
 This document represents the description of the ``publiccode.yml``
 schema.
 
-Country-specific extensions
+Top-Level Keys and Sections
 ---------------------------
 
-While the standard is structured to be meaningful on an international
-level, there are additional information that can be added that makes
-sense in specific countries, such as declaring compliance with local
-laws or regulations. The provided extension mechanism is the usage of
-country-specific sections.
-
-All country-specific extensions are contained in a section named with
-the two-letter lowercase `ISO 3166-1 alpha-2 country
-code <https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__. For instance
-``spid`` is a property for Italian software declaring whether the
-software is integrated with the Italian Public Identification System.
-
-If a software is compliant I will find:
-
-::
-
-   it:
-     spid: yes
-
-Notice that country-specific extensions within international sections
-are not allowed. Countries that want to extend the format should add a
-country-specific section instead.
-
-Documentation for the keys contained in a country specific section is
-maintained in separate files.
-
--  Italy: :ref:`italia-estensions`. 
-
-Top-level section
------------------
-
 Key ``publiccodeYmlVersion``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/it/country.rst

@@ -0,0 +1,34 @@
+.. _`estensioni-paese`:
+
+Chiavi e Sezioni Specifiche per Paese
+=====================================
+
+Mentre lo standard è strutturato per essere significativo a livello
+internazionale, vi sono informazioni addizionali che possono essere
+aggiunte a livello nazionale, come ad esempio una dichiarazione di
+compatibilità con una legge locale. Il meccanismo di estensione fornito
+prevede l’utilizzo di sezioni specifiche per ogni Paese
+(*country-specific*).
+
+Tutte le sezioni specifiche per ogni Paese sono contenute in una sezione
+denominata con l’\ `ISO 3166-1 alpha-2 country
+code <https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__. Ad esempio,
+``spid`` è una proprietà definita per i software italiani per la
+dichiarazione dell’eventuale compatibilità con il Sistema Pubblico di
+Identità Digitale.
+
+Dunque, se un software è compatibile, troveremo:
+
+.. code:: .yaml
+
+   it:
+     spid: yes
+
+Nota bene che le chiavi *country-specific* **non** sono valide
+all’interno delle sezioni internazionali. I Paesi che vogliano estendere
+il formato dovrebbero aggiungere una sezione dedicata.
+
+La documentazione per queste estensioni *country-specific* è mantenuta
+in file separati.
+
+.. include:: schema.it.rst

docs/it/index.rst

@@ -5,10 +5,10 @@ Lo Standard ``publiccode.yml``
    :numbered:
 
    intro.rst
-   schema.md
-   schema.it.md
-   forks.md
-   pa-types.md
-   tags.md 
-   tools.md
+   schema.rst
+   country.rst 
+   forks.rst
+   pa-types.rst
+   tags.rst 
+   tools.rst
    example.rst

docs/it/schema.it.rst

@@ -1,17 +1,11 @@
 .. _estensioni-italiane:
 
-Estensioni italiane
-========================================
+Chiavi e Sezioni italiane
+-------------------------
 
-Estensioni
-----------
-
-Tutte le estensioni elencate qui di seguito sono specifiche per un Paese e, di
+Tutte le estensioni elencate qui di seguito sono specifiche per l'Italia e, di
 conseguenza, devono essere inserite in una sezione denominata con 
-l’\ `ISO 3166-1 alpha-2 country
-code <https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__. 
-In questo caso, siccome le sezioni e chiavi seguenti sono italiane,
-è necessario utilizzare il codice `it`.
+il codice ``it``.
 
 Sezione ``conforme``
 ~~~~~~~~~~~~~~~~~~~~

docs/it/schema.rst

@@ -1,15 +1,14 @@
 Lo standard
-===========================
+===========
 
 La struttura di un file ``publiccode.yml`` prevede l'esistenza di chiavi
 top-level e sezioni che possono contenere al proprio interno altre chiavi. 
 Lo standard ha rilevanza internazionale ma è possibile dichiarare una sezione
 dedicata per le chiavi relative ad un Paese specifico (si veda
 :ref:`estensioni-paese` per maggiori dettagli). 
 
-Estensioni Top-Level
---------------------
-
+Chiavi e Sezioni Top-Level
+--------------------------
 
 Chiave ``publiccodeYmlVersion``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -282,22 +281,22 @@ Chiave ``softwareType``
    ``configurationFiles``
 
 Le chiavi sono: 
+
 -  ``standalone`` - Il software è un pacchetto  *self-contained*, *standalone*.
-   La maggior parte del software sarà di questo tipo. Pare di questa categoria
-   di software potrà essere eseguita
-   su un computer desktop (e.g., un eseguibile), come un’applicazione
-   *cloud-based*, come un servizio di rete o anche come un set di servizi
-   cloud o microservizi. 
+   La maggior parte del software sarà di questo tipo. I software
+   appartenenti a questa categoria potrebbero essere eseguiti
+   su un computer desktop (e.g., un eseguibile) oppure potrebbero essere
+   *cloud-based* o servizi di rete, oppure set di microservizi. 
 -  ``softwareAddon`` - Il software è un *addon*,
    come ad esempio un plugin o un tema, per un software più complesso
    (e.g., un CMS o una suite per ufficio). 
 -  ``library`` - Il software
-   contiene una libreria o una SDK che permette uno sviluppo più semplice
-   per sviluppatori di terze parti per la creazione di nuovi prodotti.
+   contiene una libreria o una SDK che facilita la creazione di nuovi prodotti
+   a sviluppatori di terze parti.
 -  ``configurationFiles`` - Il software non contiene script eseguibili ma
    una serie di file di configurazione. Questi potrebbero documentare come
-   ottenere un certo tipo di *deployment*. Potrebbero avere la forma di
-   semplici file di configurazione, script bash, playbook ansible,
+   ottenere un certo tipo di *deployment*. I suddetti file potrebbero avere la
+   forma di semplici file di configurazione, script bash, playbook ansible,
    Dockerfile, o altri set di istruzioni.
 
 Sezione ``intendedAudience``
@@ -769,42 +768,6 @@ Chiave ``dependsOn/hardware``
 This key contains a list of hardware dependencies that must be owned to use the
 software.
 
-.. _`estensioni-paese`:
-
-Estensioni Specifiche per Paese
--------------------------------
-
-Mentre lo standard è strutturato per essere significativo a livello
-internazionale, vi sono informazioni addizionali che possono essere
-aggiunte a livello nazionale, come ad esempio una dichiarazione di
-compatibilità con una legge locale. Il meccanismo di estensione fornito
-prevede l’utilizzo di sezioni specifiche per ogni Paese
-(*country-specific*).
-
-Tutte le sezioni specifiche per ogni Paese sono contenute in una sezione
-denominata con l’\ `ISO 3166-1 alpha-2 country
-code <https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__. Ad esempio,
-``spid`` è una proprietà definita per i software italiani per la
-dichiarazione dell’eventuale compatibilità con il Sistema Pubblico di
-Identità Digitale.
-
-Dunque, se un software è compatibile, troveremo:
-
-::
-
-   it:
-     spid: yes
-
-Nota bene che le chiavi *country-specific* **non** sono valide
-all’interno delle sezioni internazionali. I Paesi che vogliano estendere
-il formato dovrebbero aggiungere una sezione dedicata.
-
-La documentazione per queste estensioni *country-specific* è mantenuta
-in file separati.
-
--  Italia: :ref:`estensioni-italiane`. 
-
-
 
 Formati di dato speciali
 ------------------------