Update app metadata URLs
Description
apps.gnome.org and welcome.gnome.org are fantastic websites that GNOME apps can make use of, but our apps are inconsistent in linking to them. We are also in the process of migrating away from the wiki, and many apps still link to wiki pages from various places, including their metadata, documentation and source code.
Let's take this opportunity to update the URLs in our app metadata, to consistently link to the best resources we have available, and avoid linking to obsolete pages.
Goals
- No links to the wiki from our apps
- Core and Circle apps should link to their apps.gnome.org and welcome.gnome.org pages
Scope
All GNOME apps, but primarily those in core and circle.
People on charge & contact
Instructions to achieve the goals
Any links to the wiki from app source code should be removed or replaced. This particularly applies to app MetaInfo or .doap files. Missing fields should be added.
Core and Circle apps
These apps should have the following in their MetaInfo/AppData files:
-
homepage
URL pointing to your apps.gnome.org page -
vcs-browser
URL pointing to your GitLab/Github page -
contribute
URL pointing to your welcome.gnome.org page
All apps
- Should not include any links to the wiki. This includes (but is not limited to):
- MetaInfo/AppData files
- .doap files
- Source code
- User docs
- Home page links in .doap files are optional. However, if they do exist, they should point to apps.gnome.org or a home page that isn't on the wiki.
- MetaInfo/AppData files should include a
translate
URL:- This should point to the project page in Damned Lies (as opposed to the Translation Project wiki page) - example
Home page hosting options
Core and Circle apps should use apps.gnome.org for their home pages. Apps that are not in core or Circle have a number of options for where to host their home pages:
- The project README
- A wiki page in your app's GitLab project
- A custom home page (you can host using GitLab pages)
Resources
- An example commit: gnome-calendar@5f0d548e
- AppStream URL tag documentation
Label for tracking the initiative
Initiative: Update app metadata URLs
Text for the initiative issue in projects
Core/Circle apps
Title:
Incorrect/missing URLs in app metadata
Description:
An initiative is under way to to update app metadata URLs, so that they link to up to date web pages and don't link to the wiki, which is going to be retired. The following issues are present for this app:
<!-- Delete items which don't apply -->
* MetaInfo `<url type="homepage">` should point to the app page in apps.gnome.org
* .doap `homepage rdf:resource` should point to the app page in apps.gnome.org
* MetaInfo `<url type="contribute">` should point to the app page in welcome.gnome.org
* MetaInfo `<url type="vcs-browser">` should point to the app's development home (GitLab/Github/etc)
* MetaInfo `<url type="translate">` should point the app page in https://l10n.gnome.org/
See https://gitlab.gnome.org/GNOME/Initiatives/-/issues/51 for background and guidance.
Non-core/Circle apps
Title:
Incorrect/missing URLs in app metadata
Description:
An initiative is under way to to update app metadata URLs, so that they link to up to date web pages and don't link to the wiki, which is going to be retired. The following issues are present for this app:
<!-- Delete items which don't apply -->
* `<url type="homepage">` shouldn't link to the wiki
* .doap `homepage rdf:resource` shouldn't link to the wiki
* `<url type="vcs-browser">` should point to the app's development home (GitLab/Github/etc)
* `<url type="translate">` should point the app's page in https://l10n.gnome.org/
See https://gitlab.gnome.org/GNOME/Initiatives/-/issues/51 for background and guidance.
List of projects & tasks
Reviewed
Core
-
Calculator - gnome-calculator#388 (closed) -
Calendar - gnome-calendar#1183 (closed) -
Camera - snapshot#128 (closed) -
Characters - gnome-characters#143 (closed) -
Clocks - gnome-clocks#333 (closed) , gnome-clocks!304 (merged) -
Connections - connections#157 -
Console - console#362 (closed) -
Contacts - gnome-contacts!284 (merged) -
Disk Usage Analyser - baobab#120 (closed) -
Disks - gnome-disk-utility#337 (closed) -
Document Viewer - evince#2024 (closed) -
Extensions - gnome-shell#7457 (closed) -
Files - nautilus!1462 (merged) -
Fonts - gnome-font-viewer#79 (closed) -
Help - yelp#215 -
Image Viewer - loupe#334 (closed) -
Logs - gnome-logs#74 (closed) -
Maps - gnome-maps#668 (closed) -
Music - gnome-music#599 (closed) -
Settings - gnome-control-center#2938 (closed) -
Software - gnome-software!1898 (merged) -
System Monitor -
Text Editor - gnome-text-editor#656 (closed) -
Tour - gnome-tour#57 (closed) -
Videos - totem#615 (closed) -
Weather - gnome-weather#382 (closed) -
Web - epiphany!1448 (merged)
Development
-
Builder - gnome-builder!786 (merged) -
Sysprof sysprof!91 (merged)
Other
The following app wiki pages get the most traffic:
-
Dia - dia#557 -
Evolution - evolution#2691 (closed) -
Rhythmbox - rhythmbox#2072 (closed) -
Terminal - gnome-terminal#8062 (closed) -
Endeavour - World/Endeavour!161 (merged)
Needs review
Core
-
Document Scanner
Development
-
Boxes -
D-Spy -
Dconf Editor -
Devhelp
Circle
-
Amberol -
Apostrophe -
Audio Sharing -
Authenticator -
Blanket -
Boatswain -
Cartridges -
Chess Clock -
Citations -
Clairvoyant -
Collision -
Commit -
Curtail -
Decibels -
Decoder -
Deja Dup Backups -
Dialect -
Ear Tag -
Elastic -
Emblem -
Errands -
Eyedropper -
File Shredder -
Forge Sparks -
Fragments -
Fretboard -
Gaphor -
Graphs -
Health -
Identity -
Impression -
Junction -
Khronos -
Komikku -
Letterpress -
Lorem -
Metadata Cleaner -
Mousai -
NewsFlash -
Obfuscate -
Paper Clip -
Pika Backup -
Plots -
Podcasts -
Polari -
Railway -
Secrets -
Share Preview -
Shortwave -
Solanum -
Switcheroo -
Tangram -
Telegraph -
Text Pieces -
Video Trimmer -
Warp -
Webfont Kit Generator -
Wike -
Workbench
Other
-
Shotwell -
Cheese -
Geary -
Gitg -
Gedit -
Planner -
Tweaks -
Brasero -
EasyTAG -
EyeOfGnome -
Seahorse -
Vinagre -
FileRoller -
Tomboy -
Lollypop -
Gthumb -
GTG
How can I help
Please help by:
- Reviewing the apps listed above:
- Check if they follow the metadata guidelines in this initiative
- Report an issue if they don't follow the guidelines, using the template provided
- Update the list above:
- Move the app from "needs review" to "reviewed"
- Either check the app or link to the issue you created
- Fixing issues by replacing the links in app MetaInfo