From bc82be5123ab532a370cb112fc6a7501a399bda1 Mon Sep 17 00:00:00 2001 From: per1234 Date: Wed, 13 Oct 2021 17:14:56 -0700 Subject: [PATCH] [skip changelog] Document `packages[*].platforms[*].deprecated` package index field In the event an Arduino boards platform is deprecated by the maintainer, it will be useful to clearly communicate this fact to the user and ensure they will easily find a preferred alternative platform. In order to facilitate this, a `packages[*].platforms[*].deprecated`field was added to the Arduino package index format and this information is used to enhance the user interfaces of the official Arduino development software. This useful feature is now documented in the Arduino package index specification. --- docs/package_index_json-specification.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/package_index_json-specification.md b/docs/package_index_json-specification.md index 98ae5e7635c..dfe91f987e0 100644 --- a/docs/package_index_json-specification.md +++ b/docs/package_index_json-specification.md @@ -234,6 +234,9 @@ Each PLATFORM describes a core for a specific architecture. The fields needed ar - `architecture`: is the architecture of the platform (avr, sam, etc...). It must match the architecture of the core as explained in the [Arduino platform specification](platform-specification.md#hardware-folders-structure) - `version`: the version of the platform. +- `deprecated`: (optional) setting to `true` causes the platform to be moved to the bottom of all Boards Manager and + [`arduino-cli core`](https://arduino.github.io/arduino-cli/latest/commands/arduino-cli_core/) listings and marked + "DEPRECATED". - `category`: this field is reserved, a 3rd party core must set it to `Contributed` - `help`/`online`: is a URL that is displayed on the Arduino IDE's Boards Manager as an "Online Help" link - `url`, `archiveFileName`, `size` and `checksum`: metadata of the core archive file. The meaning is the same as for the