diff --git a/gnome-desktop3.spec b/gnome-desktop3.spec
index 16d1793..840c816 100644
--- a/gnome-desktop3.spec
+++ b/gnome-desktop3.spec
@@ -7,7 +7,7 @@
 Name: gnome-desktop3
 Version: 3.31.90
 Release: 1%{?dist}
-Summary: Shared code among gnome-panel, gnome-session, nautilus, etc
+Summary: Library with common API for various GNOME modules
 
 License: GPLv2+ and LGPLv2+
 URL: http://www.gnome.org
@@ -48,11 +48,14 @@ Obsoletes: compat-gnome-desktop310 < 3.12
 %endif
 
 %description
+gnome-desktop contains the libgnome-desktop library as well as a data
+file that exports the "GNOME" version to the Settings Details panel.
 
-The %{name} package contains an internal library
-(libgnomedesktop) used to implement some portions of the GNOME
-desktop, and also some data files and other shared components of the
-GNOME user environment.
+The libgnome-desktop library provides API shared by several applications
+on the desktop, but that cannot live in the platform for various
+reasons. There is no API or ABI guarantee, although we are doing our
+best to provide stability. Documentation for the API is available with
+gtk-doc.
 
 %package devel
 Summary: Libraries and headers for %{name}
@@ -60,8 +63,8 @@ License: LGPLv2+
 Requires: %{name}%{?_isa} = %{version}-%{release}
 
 %description devel
-Libraries and header files for the GNOME-internal private library
-libgnomedesktop.
+The %{name}-devel package contains libraries and header files for
+developing applications that use %{name}.
 
 %package  tests
 Summary:  Tests for the %{name} package
@@ -108,6 +111,7 @@ the functionality of the installed %{name} package.
 %changelog
 * Tue Feb 05 2019 Kalev Lember <klember@redhat.com> - 3.31.90-1
 - Update to 3.31.90
+- Sync package description with upstream README
 
 * Thu Jan 31 2019 Fedora Release Engineering <releng@fedoraproject.org> - 3.31.4-2
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_30_Mass_Rebuild