diff --git a/master/docs/relnotes/index.rst b/master/docs/relnotes/index.rst
index 24e71b9bba8..2d49691e5d2 100644
--- a/master/docs/relnotes/index.rst
+++ b/master/docs/relnotes/index.rst
@@ -73,6 +73,17 @@ Deprecations, Removals, and Non-Compatible Changes
 
   ChangeFilter(filter_fn=lambda c: c.properties.getProperty('github_distinct'))
 
+
+* setup.py 'scripts' have been converted to console_scripts entry point.
+  This makes them more portable and compatible with wheel format.
+  Most consequences are for the windows users:
+
+  * ``buildbot.bat`` does not exist anymore, and is replaced by ``buildbot.exe``, which is generated by the console_script entrypoint.
+
+  * ``buildbot_service.py`` is replaced by ``buildbot_windows_service.exe``, which is generated by the console_script entrypoint
+    As this script has been written in 2006, has only inline documentation and no unit tests, it is not garanteed to be working.
+    Please help improving the windows situation.
+
 Buildslave
 ----------
 
@@ -92,6 +103,16 @@ Changes for Developers
 Deprecations, Removals, and Non-Compatible Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+* setup.py 'scripts' have been converted to console_scripts entry point.
+  This makes them more portable and compatible with wheel format.
+  Most consequences are for the windows users:
+
+  * ``buildbot_worker.bat`` does not exist anymore, and is replaced by ``buildbot_worker.exe``, which is generated by the console_script entrypoint.
+
+  * ``buildbot_service.py`` is replaced by ``buildbot_worker_windows_service.exe``, which is generated by the console_script entrypoint
+    As this script has been written in 2006, has only inline documentation and no unit tests, it is not garanteed to be working.
+    Please help improving the windows situation.
+
 
 Details
 -------