Document URL tags

[danirabbit]

Problem

We don't currently document or recommend URL tags, but they are important for knowing where to report issues, help with localization, etc.

Proposal

We should document the url tags we support in AppCenter and probably consider requiring at least the bugtracker URL

Prior Art (Optional)

https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url

[Kissanth]

@danirabbit so the proposal you mean that we need to create or implement the website for to track the bugs or need to create something else i don't understand what you mean that? could you please describe more detail included

[danirabbit]

@Kissanth no this is about documenting the tags that are part of the linked app stream specification and that are supported in AppCenter. There currently is no mention of tags on our metadata page: https://docs.elementary.io/develop/writing-apps/our-first-app/metadata

[Kissanth]

@danirabbit Can you Give some example or sample for I can understand better.

[ryonakano]

I recommend to add homepage and vcs-browser URLs at least since flatpak-builder-lint warns if msising:

user@elementary:~/work/tmp/obliviate ((v3.0.0) %)$ flatpak run --command=flatpak-builder-lint org.flatpak.Builder repo repo
{
    "errors": [
        "appstream-failed-validation",
        "appid-uses-code-hosting-domain",
        "non-png-icon-in-hicolor-size-folder"
    ],
    "warnings": [
        "appstream-missing-vcs-browser-url",
        "appstream-screenshot-missing-caption"
    ],
    "appstream": [
        "E:com.github.elfenware.obliviate.metainfo.xml:desktop-app-launchable-missing This `desktop-application` component is missing a `desktop-id` launchable tag. This means that this application can not be launched and has no association with its desktop-entry file. It also means no icon data or category information from the desktop-entry file will be available"
    ],
    "info": [
        "appstream-failed-validation: Metainfo file com.github.elfenware.obliviate.metainfo.xml has failed validation. Please see the errors in appstream block",
        "non-png-icon-in-hicolor-size-folder: ['/tmp/tmpd9b23zt1/icons/hicolor/64x64@2/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/64x64/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/48x48@2/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/48x48/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/32x32@2/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/32x32/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/128x128@2/apps/com.github.elfenware.obliviate.svg', '/tmp/tmpd9b23zt1/icons/hicolor/128x128/apps/com.github.elfenware.obliviate.svg']",
        "appid-uses-code-hosting-domain: github.com",
        "appstream-screenshot-missing-caption: One or more screenshots are missing captions in the Metainfo file",
        "appstream-missing-vcs-browser-url: Please consider adding a vcs-browser URL to the Metainfo file"
    ],
    "message": "See https://docs.flathub.org/linter for details and exceptions"
}
[ble: exit 1]
user@elementary:~/work/tmp/obliviate ((v3.0.0) %)$