Adjust page to reflect reality

1 files changed, 12 insertions, 8 deletions

diff --git a/Distributions/AppStream/Software.mdwn b/Distributions/AppStream/Software.mdwn
index ad27ecea..ef2d9044 100644
--- a/Distributions/AppStream/Software.mdwn
+++ b/Distributions/AppStream/Software.mdwn
@@ -1,21 +1,25 @@
 # AppStream Software & Library
 
-Utilities to generate, maintain and access the [[AppStream|Distributions/AppStream]] Xapian database. 
+<img src="http://www.freedesktop.org/software/appstream/docs/images/appstream-logo.png" alt="AppStream Logo" />
 
+Utilities to generate, maintain and access the [[AppStream|AppStream]] Xapian database. 
 
-## What is AppStream-Core?
 
-AppStream-Core makes it easy to access application information from the AppStream database over a nice GObject-based interface.
-It uses a PackageKit plugin to automatically (re)generate the AppStream Xapian database of applications.
-The libappstream library can be used by a wide variety of programming languages (via GObject-Introspection). In combination with [[PackageKit|http://packagekit.org]] in can be used to build Software Centers. 
+## What is the AppStream software?
 
-The AppStream utilities are **beta software** at time, and the API might change a lot during the development process. Please keep that in mind when using it! 
+LibAppStream makes it easy to access component information from the AppStream database over a nice GObject-based interface.
+It uses a PackageKit plugin to automatically (re)generate the AppStream Xapian database of software components.
+The libappstream library can be used with a wide variety of programming languages (via GObject-Introspection). In combination with [[PackageKit|http://packagekit.org]] in can be used to build software-centers. 
+The software also provides a command-line tool to query the contents of the AppStream database.
+Additionally, the software will abstract some differences which exist between distributions in terms of providing metadata or handling things like screenshots, so you don't have to worry about this.
+
+The AppStream libappstream API might still change a little during the development process. We will notify about any API/ABI breaks in the release notes. (But please keep that in mind when using it!)
 
 
 ## Get it!
 
-You can download the latest release [[here|http://www.freedesktop.org/software/appstream/releases/]]
+You can download the latest release at [[freedesktop.org/software/appstream/releases/|http://www.freedesktop.org/software/appstream/releases/]]
 
 ## Documentation
 
-Documentation for the AppStream project, including how to ship AppStream data with your distribution or application, as well as libappstream API docs can be found [[on the documentation pages|http://www.freedesktop.org/software/appstream/docs/]].
+Documentation for the AppStream project, including how to ship AppStream data with your distribution or upstream project, as well as libappstream API docs can be found [[on the documentation pages|http://www.freedesktop.org/software/appstream/docs/]]. These pages also include API documentation for libappstream.