diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index 09cbf9f0f..1a8d70536 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -62,19 +62,39 @@ should become
   ,#+END_SRC
 #+END_SRC
 
-*** Change ~org-calendar-to-agenda-key~ value
+*** Accepted values of ~org-structure-template-alist~ 
 
-Default value and accepted value types changed.  See [[doc:org-calendar-to-agenda-key][docstring]] for
-details.
+Org 9.2 comes with a new template expansion mechanism, combining
+`org-insert-structure-template' and org-tempo.el
 
-*** Change ~org-structure-template-alist~ value
+The data types allowed for the ~org-structure-template-alist~ option
+changed, see its docstring for details.
 
-With the new template expansion mechanism (see
-[[*~org-insert-structure-template~]] and =org-tempo.el=), the variable
-changed its data type.  See docstring for details.
+*** Default/accepted values of ~org-calendar-to-agenda-key~
+
+The default value and accepted value of  ~org-calendar-to-agenda-key~
+changed.  This is an excerpt of the new docstring:
+
+: When set to ‘default’, bind the function to ‘c’, but only if it is
+: available in the Calendar keymap.  This is the default choice because
+: ‘c’ can then be used to switch back and forth between agenda and calendar.
+: 
+: When nil, ‘org-calendar-goto-agenda’ is not bound to any key.
+
+Check the full docstring for more.
+
+*** Change the signature of the ~org-set-effort~ function
+
+Here is the new docstring:
+
+: (org-set-effort &optional INCREMENT VALUE)
+: 
+: Set the effort property of the current entry.
+: If INCREMENT is non-nil, set the property to the next allowed
+: value.  Otherwise, if optional argument VALUE is provided, use
+: it.  Eventually, prompt for the new value if none of the previous
+: variables is set.
 
-*** Change ~org-set-effort~ signature
-See docstring for details.
 *** Placeholders in =(eval ...)= macros are always strings
 
 Within =(eval ...)= macros, =$1=-like placeholders are always replaced
@@ -114,8 +134,8 @@ document, use =shrink= value instead, or in addition to align:
 *** ~org-get-tags~ meaning change
 
 Function ~org-get-tags~ used to return local tags to the current
-headline.  It now returns the all the inherited tags in addition to
-the local tags.  In order to get the old behaviour back, you can use:
+headline.  It now returns all the inherited tags in addition to the
+local tags.  In order to get the old behaviour back, you can use:
 
 : (org-get-tags nil t)
 
@@ -130,8 +150,8 @@ code-point.
 The =:match= (renamed from =:tags=) option allows to limit clock entries
 to those matching a todo-tags matcher.
 
-The old =:tags= option can be set to =t= to display a headline's tags in
-a dedicated column.
+The old =:tags= option can be set to =t= to display a headline's tags in a
+dedicated column.
 
 This is consistent with the naming of =org-dblock-write:columnview=
 options, where =:match= is also used as a headlines filter.
@@ -273,6 +293,7 @@ parameters.  See example bellow.
 #+END_SRC
 
 ** New functions
+
 *** ~org-insert-structure-template~
 
 This function can be used to wrap existing text of Org elements in