New subject: [Bug 1859811] The appdata guidance is out of date

23 Jul 2020


      https://bugzilla.redhat.com/show_bug.cgi?id=1859811
Bug ID: 1859811
           Summary: The appdata guidance is out of date
           Product: Fedora Documentation
           Version: devel
            Status: NEW
         Component: packager-guide
          Assignee: pbokoc@redhat.com
          Reporter: t0dd@protonmail.com
        QA Contact: docs-qa@lists.fedoraproject.org
                CC: pkovar@redhat.com
  Target Milestone: ---
    Classification: Fedora
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 the problems (just a few, it needs a
revamp)
- .metainfo.xml files are now preferred and .appdata.xml is deprecated
- example .xml file has wrong component type and id
"""
<component type="desktop">
  <id>comical.desktop</id>
"""
...that should be...
"""
<component type="desktop-application">
  <id>comical</id>
"""
...better yet, 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
-- 
You are receiving this mail because:
You are the QA Contact for the bug.

[Bug 1859811] New: The appdata guidance is out of date