diff --git a/download.mdwn b/download.mdwn
index 6bf1e29..6fe65ae 100644
--- a/download.mdwn
+++ b/download.mdwn
@@ -12,8 +12,8 @@
 
 # Stable
 
-Stable version is [2.3](awesome-2.3.tar.gz) ([tar.bz2](awesome-2.3.tar.bz2)) (codename: *Morning View*),
-released on 6th May 2008.
+Stable version is [2.3.1](awesome-2.3.1.tar.gz) ([tar.bz2](awesome-2.3.1.tar.bz2)) (codename: *Morning
+Glory*), released on 2nd June 2008.
 
 # Developement
 
diff --git a/news/version_2.3.1.mdwn b/news/version_2.3.1.mdwn
new file mode 100644
index 0000000..8d99c4c
--- /dev/null
+++ b/news/version_2.3.1.mdwn
@@ -0,0 +1,13 @@
+The first stable release of awesome is out: it updates the awesome-2 branch with a new release 2.3.1.
+To download it, see the [[download]] page.
+
+This release only fixes some bugs. You can
+[[toggle text="see some changes" id="changelog"]] from 2.3.
+[[toggleable id="changelog" text="""
+* Fix focus handling on new window managing with multi monitors (FS#188);
+* Add support for mouse with up to 9 buttons.
+"""]]
+
+Don't hesitate to report bugs and ask or write enhancements on [awesome BTS](/bugs/).
+
+Have fun and be awesome, as always!