diff --git a/NEWS.org b/NEWS.org
index f0334c23..7d6060ff 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -33,15 +33,15 @@
 
     - /experimental/: if you build ~mu~ with [[https://github.com/CLD2Owners/cld2][CLD2]] support (available in many Linux
       distros), ~mu~ will try to detect the language of the body of e-mail
-      messages; you can then search by their ISO-639-1 code, e.g. ~mu find
-      lang:en~
+      messages; you can then search by their ISO-639-1 code, e.g.:
+       ~$ mu find lang:en~
 
-    - set the default database batch-size (the ~--batch-size~ parameter to ~mu
-      init~) to 50000 rather than 250000; the latter was too high for systems
-      with limited memory.
+    - set the default database batch-size to the ~mu init~ command) to 50000
+      rather than 250000; the latter was too high for systems with limited
+      memory. You can of course change that with ~--batch-size=...~
 
-    - restore expansion for "~--option=~/foo~" type options for shells that don't
-      do that, such as Bash.
+    - restore expansion for path options such as ~--maildir=~/Maildir~ for shells
+      that don't do that, such as Bash.
 
 *** mu4e
 
diff --git a/README.org b/README.org
index 3461e5f1..cf196b64 100644
--- a/README.org
+++ b/README.org
@@ -18,7 +18,9 @@
 
 Welcome to ~mu~!
 
-Given the enormous amounts of e-mail many people gather and the importance of
+Latest development news: [[NEWS.org]].
+
+With the enormous amounts of e-mail many people gather and the importance of
 e-mail message in our work-flows, it's essential to quickly deal with all that
 mail - in particular, to instantly find that one important e-mail you need right
 now, and quickly file away message for later use.