diff --git a/docs/89-NEWS.md b/docs/89-NEWS.md
index 8be757fc3..34660b4e0 100644
--- a/docs/89-NEWS.md
+++ b/docs/89-NEWS.md
@@ -1,9 +1,191 @@
# NEWS
+
+# 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.
+This release contains about 350 commits by 35 contributors, including many new
+developers. Thanks a lot.
+
+## New features
+
+The shape API has been extended to both client, notifications and wibox.
+
+[](../libraries/awful.prompt.html)
+
+The prompt now supports syntax highlight and more advanced key hooks.
+
+[](../libraries/awful.prompt.html)
+
+The prompt widget gained many new themes variables.
+
+[](../classes/wibox.layout.grid.html)
+
+There is a new 2D grid layout with rowspan and colspan support.
+
+[](../classes/awful.widget.only_on_screen.html)
+
+There is a new `awful.widget.only_on_screen` container to make it easier to
+share wiboxes across multiple screens.
+
+Various documentation improvements. Thanks for the feedbacks.
+
+The `awful.widget.taglist` now has `volatile` theme variables.
+
+There is now extra enviroment variables such as `AWESOME_ICON_PATH` and
+`AWESOME_THEMES_PATH` for those who prefer not installing Awesome.
+
+Dynamic "C" Lua libraries are now detected like pure Lua ones.
+
+`gears.timer` gained many new constructor arguments to make it easier to use.
+
+[Input shape](https://awesomewm.org/apidoc/classes/wibox.html#wibox.shape_input)
+mask are now supported. It is possible to create a wibox with passthough inputs.
+
+There is a new `awful.widget.clienticon` widget capable of fetching icons of
+different sizes.
+
+## New theme variables
+
+This release adds a ton of new theme variables to make Awesome prettier. We also
+thank all users who [submitted screenshot](https://github.com/awesomeWM/awesome/issues/1395).
+
+ theme.arcchart_thickness
+ theme.enable_spawn_cursor
+ theme.fullscreen_hide_border
+ theme.hotkeys_bg
+ theme.hotkeys_border_colo
+ theme.hotkeys_border_width
+ theme.hotkeys_description_font
+ theme.hotkeys_fg
+ theme.hotkeys_font
+ theme.hotkeys_group_margin
+ theme.hotkeys_label_bg
+ theme.hotkeys_label_fg
+ theme.hotkeys_modifiers_fg
+ theme.hotkeys_shape
+ theme.maximized_honor_padding
+ theme.notification_bg
+ theme.notification_border_color
+ theme.notification_border_width
+ theme.notification_fg
+ theme.notification_font
+ theme.notification_height
+ theme.notification_margin
+ theme.notification_opacity
+ theme.notification_shape
+ theme.notification_width
+ theme.prompt_bg_cursor
+ theme.prompt_bg
+ theme.prompt_fg_cursor
+ theme.prompt_fg
+ theme.prompt_font
+ theme.taglist_bg_volatile
+ theme.taglist_fg_volatile
+ theme.taglist_shape_border_color_volatile
+ theme.taglist_shape_border_width_volatile
+ theme.taglist_shape_volatile
+ theme.taglist_spacing
+ theme.tasklist_disable_icon
+ theme.tasklist_disable_task_name
+ theme.titlebar_close_button_focus_hover
+ theme.titlebar_close_button_focus_press
+ theme.titlebar_close_button_normal_hover
+ theme.titlebar_close_button_normal_press
+ theme.titlebar_floating_button_focus_active_hover
+ theme.titlebar_floating_button_focus_active_press
+ theme.titlebar_floating_button_focus_inactive_hover
+ theme.titlebar_floating_button_focus_inactive_press
+ theme.titlebar_floating_button_normal_active_hover
+ theme.titlebar_floating_button_normal_active_press
+ theme.titlebar_floating_button_normal_inactive_hover
+ theme.titlebar_floating_button_normal_inactive_press
+ theme.titlebar_maximized_button_focus_active_hover
+ theme.titlebar_maximized_button_focus_active_press
+ theme.titlebar_maximized_button_focus_inactive_hover
+ theme.titlebar_maximized_button_focus_inactive_press
+ theme.titlebar_maximized_button_normal_active_hover
+ theme.titlebar_maximized_button_normal_active_press
+ theme.titlebar_maximized_button_normal_inactive_hover
+ theme.titlebar_maximized_button_normal_inactive_press
+ theme.titlebar_minimize_button_focus_hover
+ theme.titlebar_minimize_button_focus_press
+ theme.titlebar_minimize_button_normal_hover
+ theme.titlebar_minimize_button_normal_press
+ theme.titlebar_ontop_button_focus_active_hover
+ theme.titlebar_ontop_button_focus_active_press
+ theme.titlebar_ontop_button_focus_inactive_hover
+ theme.titlebar_ontop_button_focus_inactive_press
+ theme.titlebar_ontop_button_normal_active_hover
+ theme.titlebar_ontop_button_normal_active_press
+ theme.titlebar_ontop_button_normal_inactive_hover
+ theme.titlebar_ontop_button_normal_inactive_press
+ theme.titlebar_sticky_button_focus_active_hover
+ theme.titlebar_sticky_button_focus_active_press
+ theme.titlebar_sticky_button_focus_inactive_hover
+ theme.titlebar_sticky_button_focus_inactive_press
+ theme.titlebar_sticky_button_normal_active_hover
+ theme.titlebar_sticky_button_normal_active_press
+ theme.titlebar_sticky_button_normal_inactive_hover
+ theme.titlebar_sticky_button_normal_inactive_press
+ theme.wibar_bgimage
+ theme.wibar_bg
+ theme.wibar_border_color
+ theme.wibar_border_width
+ theme.wibar_cursor
+ theme.wibar_fg
+ theme.wibar_height
+ theme.wibar_ontop
+ theme.wibar_opacity
+ theme.wibar_shape
+ theme.wibar_stretch
+ theme.wibar_type
+ theme.wibar_width
+
+## Noteworthy fixes
+
+ * Some applications such as VLC and Terminator had large unpainted areas
+ * The magnifier layout has been fixed
+ * Un-maximization misbehaved
+ * Docking area is now per-tag again
+ * CMake missing dependencies detection is fixed
+ * Support for FreeBSD and OpenBSD have been restored.
+ * Dialog and transient window can be moved to other screens again
+ * The fallback mode (when Awesome fails to load `rc.lua`) is now more robust
+
+## Behavior changes
+
+This is a stable release and we tried to minimize any upgrade impact. However
+various bugfixes induced minor, not noticeable, changes:
+
+ * HiDPI support fix changed the default theme "taglist square". This is only
+ true if the original theme file is used (not a copy).
+ * Maximization now honor the screen padding. There is an option to restore the
+ previous behavior.
+ * Un-maximized clients are now restored to their current screen instead of the
+ screen where they were maximized.
+ * Hotkey popup no longer enable the Vim module by default due to user
+ complaints
+
+`awful.util` has been split into multiple modules in the `gears` library to
+reduce the dependency graph. This allows for better unit testing. `awful.util`
+will be deprecated in Awesome v5. For now, it is still safe to use it. However,
+new code should use the functions from `gears` instead of `awful.util`.
+
+## Other
+
+ * The minimal LGI version is now 0.8.0. It was found that Awesome 4.0 also had
+ 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
-
Awesome 4.0 is the first release of the v4 API level, breaking the proven
v3.5 API level after 4 years. This requires to port the existing user