diff --git a/docs/89-NEWS.md b/docs/89-NEWS.md
index 34660b4e08..eb880e83e0 100644
--- a/docs/89-NEWS.md
+++ b/docs/89-NEWS.md
@@ -1,10 +1,81 @@
# NEWS
-
-# Awesome window manager framework version 4.1 changes
+
+# Awesome window manager framework version 4.2 changes
+Awesome v4.2 is the second release of the 4.x API. It mostly fix the bugs
+reported over the last 3 months and add a couple widgets. Almost 150 issues
+have been resolved or decided to be obsolete.
+
+## Noteworthy fixes
+
+ * The annoying maximization regression from v4.1 have been fixed
+ * Fixes broken drag&drop with some applications like FlowBlade
+ * Changing the keyboard layout using `xmodmap` is now much faster
+ * Fixes a regression that prevents Awesome to start with the wallpaper is invalid
+ * The client history is now more reliable
+ * Another instance where clients ended up in the wrong screen has been fixed
+ * Awesome will no longer generate zombie processes when restarted
+ * All official themes now support HiDPI screens
+ * The `magnifier` layout has been fixed
+ * The menubar has been fixed for Lua 5.1 users
+
+## New features
+
+ * The hotkey popup has been extended to support Firefox, Qutebrowser and TMUX
+ * Naughty (the notification system) has a new `ignore_suspend` flag
+ * The `textclock` widget now supports timezones
+ * New utility functions have been added:
+ * `gears.string.split`
+ * `gears.table.map`
+ * `gears.filesystem.make_parent_directories`
+ * New widget functions (moved out of the `gears` module):
+ * `wibox.widget.draw_to_cairo_context`
+ * `wibox.widget.draw_to_svg_file`
+ * `wibox.widget.draw_to_image_surface`
+ * Maximization requests from clients can now be intercepted using a
+ `request::geometry` signal handler.
+ * A new `wibox.layout.manual` layout has been added (see below)
+ * Two new `calendar` widgets have been added, a widget and a popup (see below)
+ * The `ratio` layout now supports various strategies to redistribute space
+ * The `stack` layout now supports offsets
+ * The notifications now have a `naughty.destroy_all_notifications()` function
+ * The `xresources` theme now supports the titlebar `hover` and `press` states
+
+The stack layout offsets:
+
+[](../classes/wibox.layout.stack.html)
+
+The ratio layout new full strategies:
+
+[](../classes/wibox.layout.ratio.html)
+
+The `manual` layout fix a capability gap where hierarchical elements need to be
+placed manually. It has multiple modes including an `awful.placement` integration.
+
+[](../classes/wibox.layout.manual.html)
+
+The new calendar widgets are very flexible and can be themed down to the very small details:
+
+[](../classes/wibox.widget.calendar.html)
+[](../classes/wibox.widget.calendar.html)
+
+
+## Behavior changes
+
+ * The client `property::floating` is now also emitted when when the floating
+ state changes implicitly, e.g. because the client gets maximized or
+ fullscreened.
+ * Building Awesome from its root source directory is no longer supported and
+ will print an error.
+
+
+
+
+# Awesome window manager framework version 4.1 changes
+
Awesome v4.1 is the first stable release for the Awesome 4.0 API. It adds
non-breaking new features and fixes bugs. The main purpose of the release is to
provide stability while also adding features submitted by our contributors.
@@ -182,6 +253,7 @@ new code should use the functions from `gears` instead of `awful.util`.
an issue in the menubar module when used with 0.7.3.
* GTK+3 is now required to run the integration tests.
+
# Awesome window manager framework version 4.0 changes