From 8f322df6f52fdf8dda2fde8e05e577c2333b4d65 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 videos key The key requires hosting on a third party oEmbed provider, so a catalog that renders it loads third party embeds and their trackers and have to solve that problem independently. It is also rarely populated. Videos can be linked from the documentation or the website of the software anyway. --- docs/standard/example/publiccode.yml | 2 -- docs/standard/schema.core.rst | 8 ++++---- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/standard/example/publiccode.yml b/docs/standard/example/publiccode.yml index bf92764..b887a28 100644 --- a/docs/standard/example/publiccode.yml +++ b/docs/standard/example/publiccode.yml @@ -62,8 +62,6 @@ description: - img/sshot1.jpg - img/sshot2.jpg - img/sshot3.jpg - videos: - - https://youtube.com/xxxxxxxx awards: - 1st Price Software of the year diff --git a/docs/standard/schema.core.rst b/docs/standard/schema.core.rst index 565a3c8..8908121 100644 --- a/docs/standard/schema.core.rst +++ b/docs/standard/schema.core.rst @@ -577,8 +577,8 @@ Screenshots can be of any shape and size; the suggested formats are: - Tablet: 1024x768 @2x - Mobile: 375x667 @2x -Key ``description/[lang]/videos`` -''''''''''''''''''''''''''''''''' +Key ``description/[lang]/videos`` (*deprecated*) +'''''''''''''''''''''''''''''''''''''''''''''''' - Type: array of strings (URLs) - Presence: optional @@ -591,8 +591,8 @@ hosted on a video sharing website that supports the `oEmbed `__ standard; popular options are YouTube and Vimeo. -Since videos are an integral part of the documentation, it is -recommended to publish them with an open license. +This key is deprecated, link videos from the documentation or the +website of the software instead. Key ``description/[lang]/awards`` '''''''''''''''''''''''''''''''''