2 files changed, 9 insertions(+), 1 deletions(-)

M README.md
A screenshot.png

@@ 2,7 2,15 @@
 
 Automatic sizing of Emacs windows according to the golden ratio.
 
-This is an updated and greatly simplified derivative of [golden-ratio.el](https://github.com/roman/golden-ratio.el) for Emacs 27.  Version 27 included a complete overhaul of the window change interface, obviating the need for the original code's complexity.  The UX was also simplified in the process and a number of outstanding issues fixed.
+This is an updated and greatly simplified derivative of [golden-ratio.el](https://github.com/roman/golden-ratio.el) for Emacs 27. Version 27 overhauled the way window changes are registered, obviating the need for the original code's complexity.  The UX was also simplified in the process and a number of outstanding issues fixed.
+
+# Overview
+
+![Screenshot](screenshot.png)
+
+Running a divider down the middle of a user interface violates basic design principles, creating a cramped editing environment.  Unfortunately, this is the reality for most Emacs users.  Whether or not you believe in its cosmic significance, the golden ratio is a tried and true method of sectioning space in a pleasing manner.
+
+`golden` automatically expands the active window to fill 2/(1+√5) of the frame.  With two windows, this corresponds to a golden rectangle.  Because only the active window is resized, returns diminish with more windows but are still generally effective.
 
 # Usage