From c2c8ca66e48cc9752833c0333eb3f4632fc10b31 Mon Sep 17 00:00:00 2001 From: Fabio Bonelli Date: Wed, 26 Aug 2026 09:18:13 +0200 Subject: [PATCH] doc(spec): deprecate the single string form of isBasedOn The key accepts a bare string or an array. A one element array covers the single case, and 1.0 will drop the string form. --- docs/standard/example/publiccode.yml | 3 ++- docs/standard/schema.core.rst | 7 +++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/standard/example/publiccode.yml b/docs/standard/example/publiccode.yml index bf92764..73373fb 100644 --- a/docs/standard/example/publiccode.yml +++ b/docs/standard/example/publiccode.yml @@ -4,7 +4,8 @@ name: Medusa applicationSuite: MegaProductivitySuite url: "https://example.com/italia/medusa.git" landingURL: "https://example.com/italia/medusa" -isBasedOn: "https://github.com/italia/otello.git" +isBasedOn: + - "https://github.com/italia/otello.git" softwareVersion: "1.0" releaseDate: "2017-04-15" logo: img/logo.svg diff --git a/docs/standard/schema.core.rst b/docs/standard/schema.core.rst index 565a3c8..dcd93b2 100644 --- a/docs/standard/schema.core.rst +++ b/docs/standard/schema.core.rst @@ -83,9 +83,9 @@ download of such an installer. Key ``isBasedOn`` ~~~~~~~~~~~~~~~~~ -- Type: string or array of strings +- Type: array of strings, or a single string (*deprecated*) - Presence: optional -- Example: ``"https://github.com/italia/otello.git"`` +- Example: ``["https://github.com/italia/otello.git"]`` In case this software is a variant or a fork of another software, which might or might not contain a ``publiccode.yml`` file, this key will @@ -94,6 +94,9 @@ contain the ``url`` of the original project(s). The existence of this key identifies the fork as a software variant, descending from the specified repositories. +The single string form is deprecated, use a one element array +instead. + Key ``softwareVersion`` ~~~~~~~~~~~~~~~~~~~~~~~