https://bugzilla.redhat.com/show_bug.cgi?id=1790615
Bug ID: 1790615 Summary: AppStream (formerly AppData) packaging guidelines use outdated terms and example code Product: Fedora Documentation Version: devel Status: NEW Component: packager-guide Assignee: pbokoc@redhat.com Reporter: andrew@tosk.in QA Contact: docs-qa@lists.fedoraproject.org CC: pkovar@redhat.com Target Milestone: --- Classification: Fedora
I'm referring to the docs at "Packaging Guidelines for AppData Files" https://docs.fedoraproject.org/en-US/packaging-guidelines/AppData/
The AppStream project has made a number of changes since these Fedora guidelines were written, and the conflicting information confused me at first, as I looked up how to add AppStream metadata to a new package I'm working on...
* In the Fedora guidelines, the second sentence ("Installed .appdata.xml files MUST follow the AppData specification page.") links to http://people.freedesktop.org/~hughsient/appdata/ but this URL now redirects to
https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html#sect-Quickstart-DesktopApps
* As far as I can tell, the AppStream specification no longer uses the filename to distinguish between applications and addons, and all AppStream metadata files should now be named .metainfo.xml. Files for GUI applications are no longer named .appdata.xml. See https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html#sect-Quickstart-DesktopApps
* The example .appdata.xml file in the Fedora guidelines is therefore also out of date. The current AppStream spec, for example, states that the component type should be "desktop-application" instead of just "desktop".
Unless I'm misunderstanding something, the Fedora guidelines here will need to be rewritten somewhat.
https://bugzilla.redhat.com/show_bug.cgi?id=1790615
Petr Bokoc pbokoc@redhat.com changed:
What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Resolution|--- |EOL Last Closed| |2024-05-21 09:23:37
--- Comment #1 from Petr Bokoc pbokoc@redhat.com --- 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.
docs-qa@lists.fedoraproject.org