docs(spec): deprecate Country specific sections

`supports` and `organisation` now cover compliance with national
regulations and integration with national platforms, which is all the
only Country specific section (the Italian one) did.

Author: bfabio

docs/standard/country.rst

@@ -1,7 +1,13 @@
 .. _`country-section`:
 
-Country-specific sections
-=========================
+Country-specific sections (*deprecated*)
+========================================
+
+Country-specific sections are deprecated and will be removed in
+publiccode.yml 1.0. The use cases they covered are now expressed with
+generic keys: declare compliance with national regulations or
+integration with national platforms through the ``supports`` key, and
+reference the publishing administration through the ``organisation`` key.
 
 Country-specific sections allow including information relevant only within a
 given country, such as compliance with national regulations or integration with

docs/standard/schema.it.rst

@@ -1,14 +1,20 @@
 .. _italian-sections:
 
-Italy
------
+Italy (*deprecated*)
+--------------------
+
+The entire Italian country-specific section is deprecated and will be
+removed in publiccode.yml 1.0. Use the generic ``supports`` key for
+compliance with national regulations and integration with national
+platforms, and the ``organisation`` key to reference the publishing
+administration.
 
 All the keys listed below are specific for Italy and, as such, they must
 be inserted in a section named with the ``IT`` code.
 
 
-Key ``countryExtensionVersion``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Key ``countryExtensionVersion`` (*deprecated*)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - Type: string
 - Presence: mandatory
@@ -17,6 +23,8 @@ Key ``countryExtensionVersion``
 
 This key **MUST** always be set to ``1.0``.
 
+This key is deprecated together with the rest of the Italian section.
+
 Key ``conforme`` (*deprecated*)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -72,12 +80,14 @@ Key ``conforme/gdpr`` (*deprecated*)
 
 If present and set to ``true``, the software respects the GDPR.
 
+Use the ``supports`` key with ``alias:gdpr`` instead.
 
-Section ``piattaforme``
-~~~~~~~~~~~~~~~~~~~~~~~
 
-Key ``piattaforme/spid``
-''''''''''''''''''''''''
+Section ``piattaforme`` (*deprecated*)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Key ``piattaforme/spid`` (*deprecated*)
+'''''''''''''''''''''''''''''''''''''''
 
 - Type: boolean
 - Presence: optional
@@ -87,42 +97,52 @@ If present and set to ``true``, the software interfaces with `SPID
 - il Sistema Pubblico di Identità
 Digitale <https://developers.italia.it/it/spid>`__.
 
-Key ``piattaforme/cie``
-'''''''''''''''''''''''
+Use the ``supports`` key with ``alias:spid`` instead.
+
+Key ``piattaforme/cie`` (*deprecated*)
+''''''''''''''''''''''''''''''''''''''
 
 - Type: boolean
 - Presence: optional
 
 If present and set to ``true``, the software interfaces with the Italian
 electronic ID card (``Carta di Identità Elettronica``).
 
-Key ``piattaforme/anpr``
-''''''''''''''''''''''''
+Use the ``supports`` key with ``alias:cie`` instead.
+
+Key ``piattaforme/anpr`` (*deprecated*)
+'''''''''''''''''''''''''''''''''''''''
 
 - Type: boolean
 - Presence: optional
 
 If present and set to ``true``, the software interfaces with ANPR.
 
-Key ``piattafome/pagopa``
-'''''''''''''''''''''''''
+Use the ``supports`` key with ``alias:anpr`` instead.
+
+Key ``piattafome/pagopa`` (*deprecated*)
+''''''''''''''''''''''''''''''''''''''''
 
 - Type: boolean
 - Presence: optional
 
 If present and set to ``true``, the software interfaces with pagoPA.
 
-Key ``piattaforme/io``
-'''''''''''''''''''''''''
+Use the ``supports`` key with ``alias:pagopa`` instead.
+
+Key ``piattaforme/io`` (*deprecated*)
+'''''''''''''''''''''''''''''''''''''
 
 - Type: boolean
 - Presence: optional
 
 If present and set to ``true``, the software interfaces with `IO - the public services app <https://io.italia.it/>`__.
 
+Use the ``supports`` key with ``alias:io`` instead.
+
 
-Section ``riuso``
-~~~~~~~~~~~~~~~~~
+Section ``riuso`` (*deprecated*)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This section contains a set of keys related to the publication of the software
 inside the reuse catalog of `Developers Italia <https://developers.italia.it>`__.