diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7751a4fd1e..14e4f92ce5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,27 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## 0.17.0
+
+### Added
+
+* Add `httpx.MockTransport()`, allowing to mock out a transport using pre-determined responses. (Pull #1401, Pull #1449)
+* Add `httpx.HTTPTransport()` and `httpx.AsyncHTTPTransport()` default transports. (Pull #1399)
+* Add mount API support, using `httpx.Client(mounts=...)`. (Pull #1362)
+* Add `chunk_size` parameter to `iter_raw()`, `iter_bytes()`, `iter_text()`. (Pull #1277)
+* Add `keepalive_expiry` parameter to `httpx.Limits()` configuration. (Pull #1398)
+* Add repr to `httpx.Cookies` to display available cookies. (Pull #1411)
+* Add support for `params=<tuple>` (previously only `params=<list>` was supported). (Pull #1426)
+
+### Fixed
+
+* Add missing `raw_path` to ASGI scope. (Pull #1357)
+* Tweak `create_ssl_context` defaults to use `trust_env=True`. (Pull #1447)
+* Properly URL-escape WSGI `PATH_INFO`. (Pull #1391)
+* Properly set default ports in WSGI transport. (Pull #1469)
+* Properly encode slashes when using `base_url`. (Pull #1407)
+* Properly map exceptions in `request.aclose()`. (Pull #1465)
+
 ## 0.16.1 (October 8th, 2020)
 
 ### Fixed
diff --git a/README.md b/README.md
index 60ca24540f..66b2f8688f 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@
 HTTPX is a fully featured HTTP client for Python 3, which provides sync and async APIs, and support for both HTTP/1.1 and HTTP/2.
 
 **Note**: _HTTPX should be considered in beta. We believe we've got the public API to
-a stable point now, but would strongly recommend pinning your dependencies to the `0.16.*`
+a stable point now, but would strongly recommend pinning your dependencies to the `0.17.*`
 release, so that you're able to properly review [API changes between package updates](https://github.com/encode/httpx/blob/master/CHANGELOG.md). A 1.0 release is expected to be issued sometime in 2021._
 
 ---
diff --git a/docs/index.md b/docs/index.md
index abdc9c7d33..3da239f7e8 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -27,7 +27,7 @@ HTTPX is a fully featured HTTP client for Python 3, which provides sync and asyn
 !!! note
     HTTPX should currently be considered in beta.
 
-    We believe we've got the public API to a stable point now, but would strongly recommend pinning your dependencies to the `0.16.*` release, so that you're able to properly review [API changes between package updates](https://github.com/encode/httpx/blob/master/CHANGELOG.md).
+    We believe we've got the public API to a stable point now, but would strongly recommend pinning your dependencies to the `0.17.*` release, so that you're able to properly review [API changes between package updates](https://github.com/encode/httpx/blob/master/CHANGELOG.md).
 
     A 1.0 release is expected to be issued sometime in 2021.
 
diff --git a/httpx/__version__.py b/httpx/__version__.py
index 248da917db..f406d12d19 100644
--- a/httpx/__version__.py
+++ b/httpx/__version__.py
@@ -1,3 +1,3 @@
 __title__ = "httpx"
 __description__ = "A next generation HTTP client, for Python 3."
-__version__ = "0.16.1"
+__version__ = "0.17.0"