[gnome-software: 2/3] doc: Create use cases document for gnome-software

[Philip Withnall <pwithnall src gnome org>]

commit 23a6adfea407314ecf4918fb826e7caf93478468
Author: Philip Withnall <pwithnall endlessos org>
Date:   Fri Oct 16 14:12:09 2020 +0100

    doc: Create use cases document for gnome-software
    
    This document will evolve over time, and isn’t yet complete (in
    particular, it’s missing detailed use cases; currently it only contains
    high-level goals).
    
    Signed-off-by: Philip Withnall <pwithnall endlessos org>
    
    Fixes: #1079

 README.md        |  2 ++
 doc/use-cases.md | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
---
diff --git a/README.md b/README.md
index 7123c495..7d425f45 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@ without them having to think about it, and gives them confidence that their
 system is up to date. It supports popular distributions, subject to those
 distributions maintaining their own distro-specific integration code.
 
+The specific use cases that Software covers are [documented in more detail](./doc/use-cases.md).
+
 # Features
 
 A plugin system is used to access software from different sources.
diff --git a/doc/use-cases.md b/doc/use-cases.md
new file mode 100644
index 00000000..00fae48f
--- /dev/null
+++ b/doc/use-cases.md
@@ -0,0 +1,38 @@
+This document will evolve over time to indicate what goals and use cases
+gnome-software targets at the moment.
+
+Primary goals
+=============
+
+ * Allow people to find apps by browsing or search:
+  - a specific app that they're looking for, or
+  - apps in a particular category, or with particular functionality that they require
+ * Allow people to effectively inspect and appraise apps before they install them (screenshots, 
descriptions, ratings, comments, metadata)
+ * Allow people to view which apps are installed and remove them
+ * Present a positive view of the app ecosystem
+  - Reinforce the sense that there are lots of high quality apps
+  - Encourage people to engage with that ecosystem, both as users and as contributors
+  - When browsing, present and promote the best apps that are available
+  - Facilitate accidental discovery of great apps
+ * Handle software updates. Make software updates as little work for users as possible. To include: apps,  
OS updates (PackageKit, eos, rpm-ostree), firmware
+ * Support multiple software repositories, defined by both the distributor and users.
+  - Show which repos are configured. Allow them to be added/removed.
+  - Handle cases where the same app can be installed from multiple sources.
+
+Secondary goals
+===============
+
+ * OS upgrades
+ * Hardware driver installation
+ * Input method installation
+ * Respond to application queries for software (apps, codecs, languages)
+ * Offline and metered connections
+ * OS updates end of life
+ * App end of life
+
+Non-goals
+=========
+
+ * Not a package manager front-end
+ * Not all repos are equal
+ * Not all apps are equal