Bug 1859811

Summary: The appdata guidance is out of date
Product: [Fedora] Fedora Documentation Reporter: Todd Warner <t0dd>
Component: packager-guideAssignee: Petr Bokoc <pbokoc>
Status: NEW --- QA Contact: Fedora Docs QA <docs-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: develCC: pkovar
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: ---
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Todd Warner 2020-07-23 05:14:53 UTC 
Description of problem:
If you go looking for guidance for how to package RPMs, there is really no better guide than what Fedora produces. It is therefore that much more important that Fedora keeps up with Freedesktop.org standards.

The problem is that the "Packaging Guidelines for AppData Files" is out of date and wrong.

Version-Release number of selected component (if applicable):
https://docs.fedoraproject.org/en-US/packaging-guidelines/AppData/
As of July 23, 2020

Actual results: Let's just tick off a few of the problems (it needs a revamp)
- .metainfo.xml files are now preferred and .appdata.xml is deprecated
- example .xml file has wrong component type and id
- the launchable tag in the desktop application example is missing
"""
<component type="desktop">
  <id>comical.desktop</id>
"""
...that should be...
"""
<component type="desktop-application">
  <id>com.example.Comical</id>
"""

It's also missing the launchable tag
"""
<launchable type="desktop-id">com.example.Comical.desktop</lauchable>
"""

Expected results:

See above.

Additional info:
https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html
Comment 1 Todd Warner 2020-07-23 17:10:43 UTC 
Apparently, gnome-software requires a .desktop in the <id> field. This is a gnome-software ... bug? I think?
Comment 2 Todd Warner 2020-07-23 18:23:44 UTC 
(In reply to Todd Warner from comment #1)
> Apparently, gnome-software requires a .desktop in the <id> field. This is a
> gnome-software ... bug? I think?

https://bugzilla.redhat.com/show_bug.cgi?id=1860130