diff --git a/NEWS.md b/NEWS.md
index 8c1d4524..a598c32c 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,30 @@
 # NEWS
 
+1.17.0 - 2020-12-19
+-------------------
+
+- fix SSL compatibility with erlang OTP 23
+- handle empty trailers 
+- fix race condition in connection pool
+- fix memory leak in connection pool
+- IDNA update to unicode 13.0.0
+- fix build on macosx with OTP >= 20.1
+- fix network Location on redirect
+- produce uppercase hexadecimal in URLS
+- pool queue count metric is now named `queue_count`
+- miscellaneous fixes in documentation
+
+
+** possible breaking change **  
+
+- pool queue count metric is now named `queue_count`. You should update your dashboard to reflect it.
+
+- possible breacking changes when producing uppercase hexadecimal in urls
+
+This change the behaviour of urlencode and pathencode to produce
+uppercase hexadecimal to comply to the RFC3986 which may affect 
+systems using URL as signature or in an hash.
+
 1.16.0 - 2020-05-25
 -------------------
 
diff --git a/README.md b/README.md
index 7c211043..7e0f657d 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 Copyright (c) 2012-2020 Benoît Chesneau.
 
-__Version:__ 1.16.0
+__Version:__ 1.17.0
 
 # hackney
 
diff --git a/doc/README.md b/doc/README.md
index 938cd614..567d1f7f 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -4,7 +4,7 @@
 
 Copyright (c) 2012-2020 Benoît Chesneau.
 
-__Version:__ 1.16.0
+__Version:__ 1.17.0
 
 # hackney
 
diff --git a/doc/overview.edoc b/doc/overview.edoc
index 3ad5f864..f3ef3ac4 100644
--- a/doc/overview.edoc
+++ b/doc/overview.edoc
@@ -17,7 +17,7 @@
 
 
 @copyright 2012-2020 Benoît Chesneau.
-@version 1.16.0
+@version 1.17.0
 @title hackney - HTTP client library in Erlang
 
 @doc