From 0ab837e9aa9f6aa8eaf51912ae9be25b13181e59 Mon Sep 17 00:00:00 2001 From: Fabio Bonelli Date: Wed, 26 Aug 2026 09:13:14 +0200 Subject: [PATCH] doc(spec): deprecate the `unsupportedCountries` key Not supporting a country is a nearly meaningless concept: any software may conflict with some law somewhere and nobody maintains the complete set. In fact, no publiccode.yml found on the Internet uses the key. Absence from countries already states that a country is not targeted. --- docs/standard/example/publiccode.yml | 2 -- docs/standard/schema.core.rst | 7 +++++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/standard/example/publiccode.yml b/docs/standard/example/publiccode.yml index bf92764..04316a0 100644 --- a/docs/standard/example/publiccode.yml +++ b/docs/standard/example/publiccode.yml @@ -33,8 +33,6 @@ intendedAudience: countries: - IT - DE - unsupportedCountries: - - US description: en: diff --git a/docs/standard/schema.core.rst b/docs/standard/schema.core.rst index 565a3c8..8adb5e4 100644 --- a/docs/standard/schema.core.rst +++ b/docs/standard/schema.core.rst @@ -378,8 +378,8 @@ i.e. the software explicitly claims compliance with specific processes, technologies or laws. All countries are specified using lowercase (*deprecated*) or uppercase ISO 3166-1 alpha-2 two-letter country codes. -Key ``intendedAudience/unsupportedCountries`` -''''''''''''''''''''''''''''''''''''''''''''' +Key ``intendedAudience/unsupportedCountries`` (*deprecated*) +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' - Type: array of strings - Presence: optional @@ -389,6 +389,9 @@ case if there is a conflict between how software is working and a specific law, process or technology. All countries are specified using lowercase (*deprecated*) or uppercase ISO 3166-1 alpha-2 two-letter country codes. +This key is deprecated, use ``intendedAudience/countries`` to list the +countries the software explicitly targets instead. + Key ``intendedAudience/scope`` ''''''''''''''''''''''''''''''