From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <hughsient@gmail.com>
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
	h=mime-version:from:date:message-id:subject:to;
	bh=vIFygUjeNHzXssKTms9/F13Gk0+HQG7wrDeLpofo9DE=;
	b=tOleTNtGHOiM2rpNm0RvsjxLVQXR9rv5+oMIKrNdBZ7sgmO8UqSCsS+y3JpAv+xRgZ
	EJcWez4gur5budYKL60rY33/Kolpahbu4zh29VvFSDDCwioUe/ZdmlPZgTrhx9gG6YYA
	kLPQnLTNB/ox3SWpand0hrAzN9THCFrhEoGnNuVs9NiO+Bn7QkDoBiV/bHwE0WG2+UX+
	sJvfx1cMUSlKlK+rTgrQitwN8Q5DlVRkPB5eOgc8Qn0IlHk7qx6RSzSGca0Kyc1XJU0F
	tAHV83nlOT/OzrO1V8hQpdXXxg0U/D1KGksfZg/I/Ipe3RZzYoAQ9FPpIqSyqEaLlgtq
	19LA==
MIME-Version: 1.0
From: Richard Hughes <hughsient@gmail.com>
Date: Thu, 4 Apr 2019 17:01:14 +0100
Message-ID: <CAD2FfiFwuz+Oxdr+34Ct2Bux7wr4RYHve-Lq1G8ZU88h_HZxVQ@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Subject: [Lvfs-announce] New categories for firmware uploads
List-Id: Linux Vendor Firmware Service updates about downtimes and new app
	features <lvfs-announce.lists.linuxfoundation.org>
List-Unsubscribe: <https://lists.linuxfoundation.org/mailman/options/lvfs-announce>,
	<mailto:lvfs-announce-request@lists.linuxfoundation.org?subject=unsubscribe>
List-Archive: <http://lists.linuxfoundation.org/pipermail/lvfs-announce/>
List-Post: <mailto:lvfs-announce@lists.linuxfoundation.org>
List-Help: <mailto:lvfs-announce-request@lists.linuxfoundation.org?subject=help>
List-Subscribe: <https://lists.linuxfoundation.org/mailman/listinfo/lvfs-announce>,
	<mailto:lvfs-announce-request@lists.linuxfoundation.org?subject=subscribe>
To: lvfs-announce@lists.linuxfoundation.org

Hi all,

I've just merged and deployed some new functionality to the LVFS that
allows us to fix three classes of issues:

 * Some vendors submit multiple kinds of updates for the same
hardware, and they are all presented as "duplicate" entries, for
instance an ME update, an EC update and BIOS update all have the title
"ThinkPad P50" on the LVFS and in GNOME Software

* Translator teams are frustrated that they cannot translate terms
like "System Update"

* Users file bugs when they get 'weird' updates from "Logitech
Logitech Unifying Receiver" or "AKiTiO Thunderbolt Firmware Update for
AKiTiO Node Lite"

By telling the LVFS the firmware category to use for the component the
front end can correctly translate the update type in the UI. Also for
this reason, firmware should not include the words ME, EC, BIOS,
Firmware, Device or Update in the component name and they will be
automatically removed if included.

The component category can be set as part of the metainfo.xml file or
set from the LVFS web console. Most users will want to include the
extra metadata to make the upload process quicker for QA engineers. To
do this, add this to the metainfo file:

  <categories>
    <category>some-value-here</category>
  </categories>

Allowed values for category are currently: X-System, X-Device,
X-EmbeddedController, X-ManagementEngine, X-Controller. Existing
firmware has been converted to use the correct categories and correct
name values, although if there are any mistakes please just correct
them on the LVFS component view or ask me for help.

Firmware uploaded now without <category> tags is still allowed,
although it defaults to X-Device which may-or-may-not be what you
want. In 2020 I'll make it an upload error to include firmware without
<category> tags, so you all have 9 months to fix up various deployment
scripts and firmware templates.

If anyone needs any extra category values please email me so we can
discuss the naming and also add translations for the various front
ends. Thanks.

Richard.