diff --git a/docs/source/whatsnew/pr/incompat-base-url.rst b/docs/source/whatsnew/pr/incompat-base-url.rst
new file mode 100644
index 0000000..82488fb
--- /dev/null
+++ b/docs/source/whatsnew/pr/incompat-base-url.rst
@@ -0,0 +1,6 @@
+Simplifying configurable URLs
+-----------------------------
+
+- base_kernel_url configurable is removed
+- websocket_url configurable is removed
+- base_project_url is renamed to base_url (base_project_url is kept as a deprecates alias, for now)