[gnome-software.wiki] Fix more TODO items
- From: Philip Withnall <pwithnall src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-software.wiki] Fix more TODO items
- Date: Wed, 15 Sep 2021 09:26:24 +0000 (UTC)
commit a3110100c98421e1ebf6e7a4181ab3e6231347b3
Author: Philip Withnall <philip tecnocode co uk>
Date: Wed Sep 15 09:26:24 2021 +0000
Fix more TODO items
Software-metadata.md | 21 +++++++++++++++++----
1 file changed, 17 insertions(+), 4 deletions(-)
---
diff --git a/Software-metadata.md b/Software-metadata.md
index 88d4417..ff13067 100644
--- a/Software-metadata.md
+++ b/Software-metadata.md
@@ -75,7 +75,9 @@ License <a name="license"></a>
<img align="right" src="uploads/c531b163f4a155a36513f1b015785281/community-built.png">
<img align="right" src="uploads/ac4336231013163c0e77574b7540b3f6/proprietary.png">
-TODO
+GNOME Software displays a tile indicating whether an application is [free
software](https://en.wikipedia.org/wiki/Free_and_open-source_software) or whether it’s proprietary. This tile
includes more detailed information about the project’s license. This tile also lists some of the benefits of
free software.
+
+Sometimes the license information isn’t correct for an application, and hence an application which is
actually free software will be shown as ‘proprietary’.
You can improve the license information:
* [How to fix incorrect licensing information](#user-content-how-to-fix-incorrect-licensing-information)
@@ -87,7 +89,9 @@ Links <a name="links"></a>
<img align="right" src="uploads/4af1df180ed2e312e8dacee69cf20d77/links.png">
-TODO
+GNOME Software displays a list of links for an application, giving the user access to related resources.
This includes the application’s home page, it’s bug reporting page, a way to donate to the application’s
developers, and information on contributing translations to the application.
+
+Some or all of these links may be present depending on whether they are listed in the application’s metainfo.
You can improve the links:
* [How to add missing links](#user-content-how-to-add-missing-links)
@@ -125,8 +129,17 @@ If some metadata is missing for an application, GNOME Software can only guess wh
How to add missing links
---
- - Add all relevant types from https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url
- - TODO
+The links for an application are stored as [`<url>`
elements](https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url) within the
application’s `<component>` in its metainfo file.
+
+Add as many of the link types documented in the [appstream
specification](https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url) as are
available for the application. If no suitable page exists for a given link type, it doesn’t have to be
included.
+
+For example:
+```xml
+<url type="bugtracker">https://gitlab.gnome.org/GNOME/gnome-software/-/issues/new</url>
+<url type="donation">https://www.gnome.org/donate/</url>
+<url type="homepage">https://wiki.gnome.org/Design/Apps/Software</url>
+<url type="translate">https://wiki.gnome.org/TranslationProject</url>
+```
How to add missing hardware information
---
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]