publiccodeyml · bfabio · Nov 5, 2025 · Nov 5, 2025
diff --git a/docs/fr/schema.it.rst b/docs/fr/schema.it.rst
@@ -4,10 +4,7 @@ Italy
 -----
 
 All the extensions listed below are specific for Italy and, as such, they must
-be inserted in a section named with the ``it`` code. Every Country is specified
-using a two letters lowercase (*deprecated*) or uppercase *country code* following
-the ISO 3166-1 alpha-2 standard.
-
+be inserted in a section named with the ``it`` code.
 
 Key ``countryExtensionVersion``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/docs/it/country.rst b/docs/it/country.rst
@@ -1,34 +1,16 @@
 .. _`estensioni-paese`:
 
-Estensioni nazionali
-====================
+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*).
+Le sezioni specifiche per paese permettono di includere informazioni rilevanti
+solo per un determinato Paese, come la conformità a regolamenti nazionali o
+l'integrazione con piattaforme nazionali.
 
-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>`__ in minuscolo (*deprecato*) o
-in maiuscolo.
-Ad esempio, ``spid`` è una proprietà definita per i software italiani per la
-dichiarazione dell’eventuale compatibilità con il Sistema Pubblico di
-Identità Digitale.
+Ogni sezione è identificata con l'\ `ISO 3166-1 alpha-2 country code
+<https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__ del Paese in minuscolo
+(*deprecato*) o in maiuscolo.
 
-Dunque, se un software è compatibile, troveremo:
-
-.. code:: yaml
-
-   it:
-     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
-il formato devono aggiungere una sezione dedicata.
+Attualmente, l'unica sezione specifica per Paese definita è quella italiana (it:).
 
 .. include:: schema.it.rst
diff --git a/docs/it/schema.it.rst b/docs/it/schema.it.rst
@@ -5,9 +5,7 @@ Italia
 
 Tutte le chiavi elencate qui di seguito sono specifiche per l'Italia e, di
 conseguenza, devono essere inserite in una sezione denominata con il codice
-``it``. Tutti i Paesi sono specificati usando *country code* a due lettere
-in minuscolo (*deprecato*) o in maiuscolo, seguendo lo standard ISO 3166-1 alpha-2.
-
+``it``.
 
 Chiave ``countryExtensionVersion``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/docs/standard/country.rst b/docs/standard/country.rst
@@ -1,31 +1,16 @@
 .. _`country-section`:
 
-Country-Specific Sections
+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.
+Country-specific sections allow including information relevant only within a
+given country, such as compliance with national regulations or integration with
+national platforms.
 
-All country-specific sections live under a key named after two-letter
+Each section is identified by a two-letter ISO 3166-1 alpha-2 country code
 lowercase (*deprecated*) or uppercase `ISO 3166-1 alpha-2 country
-codes <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.
+codes <https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2>`__.
 
-If a software is compliant I will find:
-
-.. code:: yaml
-
-   it:
-     countryExtensionVersion: "1.0"
-     piattaforme:
-      - spid: true
-
-Notice that country-specific keys within international sections
-are not allowed. Countries that want to extend the format should add a
-country-specific section instead.
+Currently, the only defined country-specific section is the Italian one (``it:``).
 
 .. include:: schema.it.rst
diff --git a/docs/standard/schema.it.rst b/docs/standard/schema.it.rst
@@ -4,9 +4,7 @@ Italy
 -----
 
 All the keys listed below are specific for Italy and, as such, they must
-be inserted in a section named with the ``it`` code. Every Country is specified
-using a two letters lowercase (*deprecated*) or uppercase *country code* following
-the ISO 3166-1 alpha-2 standard.
+be inserted in a section named with the ``it`` code.
 
 
 Key ``countryExtensionVersion``