diff --git a/README b/README
index c976c39..e309487 100644
--- a/README
+++ b/README
@@ -1 +1,24 @@
-This extension creates a popup to start all apps defined in desktop files under ~/.local/user/apps/*
+= NAME =
+
+QuickLaunch@github.com
+
+= DESCRIPTION =
+
+This extension adds a popup menu to the top bar of gnome-shell.
+
+If you have any custom launchers, for example from a previous version of gnome-panel, or from your desktop, you can use the new popup to start these.
+
+To populate the popup menu, put .desktop files into ~/.local/user/apps/
+
+= INSTALL =
+
+1. Put this folder below ~/.local/share/gnome-shell/extensions/ and rename it to Quicklauchn@github.com
+
+2. create ~/.local/user/apps and put a few .desktop files in there
+
+  mkdir -p ~/.local/user/apps
+
+3. reload gnome-shell (press alt-f2, enter r)
+
+4. use gnome-tweak-tool to enable the new shell extension
+
diff --git a/extension.js b/extension.js
index de1068a..d4f1e5b 100644
--- a/extension.js
+++ b/extension.js
@@ -85,6 +85,7 @@ AppsMenu.prototype = {
   },
 
   addAppItem: function(desktopPath) {
+    // from http://www.roojs.com/seed/gir-1.2-gtk-3.0/gjs/
     let appInfo = new Gio.DesktopAppInfo.new_from_filename(desktopPath);
     if (!appInfo) {
       global.log('App for desktop file ' + desktopPath + ' could not be loaded!');