Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1859811

Summary: The appdata guidance is out of date
Product: [Retired] Fedora Documentation Reporter: Todd Warner <t0dd>
Component: packager-guideAssignee: Petr Bokoc <pbokoc>
Status: CLOSED EOL 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: 2024-05-21 09:23:37 UTC 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
Comment 3 Petr Bokoc 2024-05-21 09:23:37 UTC 
This guide has been retired, therefore I'm closing this bug. 

If you would like to report Fedora docs bugs in the future, please use the "bug" icon on the top right of the affected page, it will take you directly to the appropriate issue tracker.