diff --git a/README.md b/README.md
index b1a8a66..879f8aa 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,51 @@
 Surface3-Scripts
 ================
 
-Some simple scripts for Linux on the Surface Pro 3.
+This program autorotates the screen of a Microsoft Surface Pro 3 Tablet
+running Linux.  It correctly performs the autorotation for all major
+pointer devices, including the stylus and eraser devices.  It also
+enables palm rejection (meaning you can rest your hand on the screen
+while drawing) when the stylus and eraser devices are "in use" (which is
+defined by the digitizer as "within approximately 4cm of the screen").
 
-Autorotate: autorotate.py run with python2 needs 
+This program is written in Python 2, which is included in all major
+Linux distributions by default.  It has no additional dependencies.
 
-autorotate.py
-=============
+It may run on other versions of the Microsoft Surface, but I haven't
+tested it on anything other than my own Surface Pro 3.
 
-Script for managing autorotation of the screen and deactivation of the touchscreen through the pen.
-
-Instalation
+Installation
 -----------
-* install libnotify and python2-gobject (needed for notifications)
-* copy autorotate.py, touch.py, changeautorotatestatus.py, touch.txt, status.txt in the same folder
-  
+
+To install, just copy autorotate/autorotate.py to a directory in your
+$PATH.
+
+Feel free to remove the '.py' extension; Linux doesn't use or
+need it.  Also, remember to make the program executable:
+
+```
+chmod +x autorotate.py
+```
+
+(or whatever you choose to name it).
+
+You may have to edit the first line of the autorotate script, if your
+distro's Python 2 install doesn't include a link to it via the command
+"python2".
+
 Usage
 -----
 Start script:
 ```
 $ python2 /path/to/autorotate.py
 ```
-Deactivate/reactivate autorotation:
-```
-$ python2 /path/to/changeautorotatestatus.py
-```
-Deactivate/reactivate touch:
-```
-$ python2 path/to/touch.py
-```
+
+Credits
+-------
+
+The original geometry detection algorithms were written by
+[Ayko Poel](https://github.com/AykoPoel/surface3-scripts).  My
+contribution consists of more robust device and device driver
+identification algorithms for the stylus and eraser, and a general
+modernization of the transform algorithm.
+