[gnome-software.wiki] Fix more TODO items



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]