flatpak-docs icon indicating copy to clipboard operation
flatpak-docs copied to clipboard

Document metainfo with examples

Open Doomsdayrs opened this issue 3 years ago • 1 comments

Creating metainfo is sorta "Figure it out" rn.

I had to personally find https://hughsie.github.io/oars/generate.html to generate a content_rating.

Doomsdayrs avatar Jan 10 '22 07:01 Doomsdayrs

https://docs.flatpak.org/en/latest/conventions.html?highlight=appstream#appdata-files links already the official specification

JakobDev avatar May 12 '22 14:05 JakobDev

Flatpak does not impose any restrictions or requirements about MetaInfo. You can build a Flatpak without any MetaInfo file. Those are imposed by software stores or applications.

I don't think duplicating the Appstream spec in Flatpak docs is a good idea. Someone has to update it constantly.

The requirements imposed by software stores should be documented in their docs eg. https://docs.flathub.org/docs/for-app-authors/metainfo-guidelines/ and https://docs.elementary.io/develop/appcenter/publishing-requirements#metadata-requirements

(I wrote Flathub's metainfo guidelines page.)

bbhtt avatar May 06 '24 01:05 bbhtt