ui/zen: revise readme

modules/ui/zen/README.org

@@ -7,6 +7,7 @@
 - [[#description][Description]]
   - [[#module-flags][Module Flags]]
   - [[#plugins][Plugins]]
+  - [[#hacks][Hacks]]
 - [[#prerequisites][Prerequisites]]
 - [[#features][Features]]
   - [[#distractions-free-mode][Distractions-free mode]]
@@ -14,11 +15,12 @@
   - [[#enable-fullscreen-on-activation][Enable fullscreen on activation]]
 
 * Description
-This module provides a distraction-free mode that:
+This module provides ~writeroom-mode~, which transforms Emacs into a
+comfortable writing or coding space by centering the buffer, removing
+superfluous UI elements, and turning on variable-pitch fonts (but keeps certain
+elements fixed-pitch, where it makes sense to).
 
-+ Centers the buffer
+If you've used olivetti, sublimity, or tabula-rasa, you will feel right at home.
-+ Enables variable pitch for text (but keeps certain elements fixed-pitch).
-+ Reduces UI clutter (e.g. the modeline; fullscreens the frame -- off by default)
 
 ** Module Flags
 This module provides no flags.
@@ -27,6 +29,11 @@ This module provides no flags.
 + [[https://github.com/joostkremers/writeroom-mode][writeroom-mode]]
 + [[https://gitlab.com/jabranham/mixed-pitch][mixed-pitch]]
 
+** Hacks
++ =mixed-pitch= has been modified not to override ~:height~ properties on the
+  faces it remaps. This means text-scale can affect the ~fixed-pitch~ faces as
+  well; See https://gitlab.com/jabranham/mixed-pitch/issues/6#note_79691741.
+
 * Prerequisites
 This module has no prereqisites.