diff --git a/doc/api/user_img_specs.rst b/doc/api/user_img_specs.rst
new file mode 100644
index 00000000000..db15201ba0a
--- /dev/null
+++ b/doc/api/user_img_specs.rst
@@ -0,0 +1,9 @@
+User avatar
+===========
+
+This revision adds an avatar for users. This replace the use of gravatar to emulate avatars, such as used in tasks kanban view. Two fields are added to res.users model:
+- avatar, binary image
+- avatar_mini, an automatically computed reduced version of the avatar
+User avatar has to be used everywhere an image depicting users is likely to be used, by using the avatar_mini field.
+
+Avatar choice has been added to the users form view, as well as in Preferences.
diff --git a/doc/index.rst.inc b/doc/index.rst.inc
index 05c4a53640b..d208bf82eb1 100644
--- a/doc/index.rst.inc
+++ b/doc/index.rst.inc
@@ -6,3 +6,11 @@ OpenERP Server
    :maxdepth: 1
 
    test-framework
+
+New feature merges
+++++++++++++++++++
+
+.. toctree::
+   :maxdepth: 1
+
+   api/user_img_specs