Include recent PR and add release summary

Author: consideRatio

docs/source/changelog.md

@@ -16,24 +16,32 @@ changes in pull requests], this list should be updated.
 
 ### 4.0.0-beta.1 - 2024-10-XX
 
-TODO: write a release summary here.
-
-This changelog is just providing an overview of changes, so its meant to be
-complemented with the [major version upgrade documentation](upgrade-3-to-4) with
-practical advice on upgrading accounting for changes.
+This release updates JupyterHub itself from version 4 to 5, and the dependencies
+`jupyterhub-kubespawner`, `oauthenticator`, and `ldapauthenticator` to a new
+major version. Please read the summary of breaking changes below and the
+[documentation on upgrading from chart version 3 to 4](upgrade-3-to-4) before
+upgrading.
 
 #### Breaking changes
 
-- Update jupyterhub from 4.1.6 to 5.1.0 [#3405](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3405), [#3416](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3416), [#3425](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3425), [#3472](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3472)
-- Drop support for k8s 1.23-1.27, require k8s 1.28+ [#3312](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3312), [#3403](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3403), [#3319](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3319), [#3508](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3508)
-- `jupyterhub-kubespawner` is upgraded one major version from 6.2.0 to 7.0.0b1,
-  please read [KubeSpawner's changelog]
-  [#3520](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3520)
-- `oauthenticator` is upgraded one major version from 16.3.1 to 17.0.0, please
-  read [OAuthenticator's changelog] if you are using one if its authenticator
-  classes [#3519](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3519)
-
-[kubespawner's changelog]: https://jupyterhub-kubespawner.readthedocs.io/en/stable/changelog.html
+- The chart now require Kubernetes 1.28+, up from 1.23+
+- KubeSpawner is upgraded one major version from 6.2.0 to 7.0.0b1
+  - Refer to the [KubeSpawner changelog] for details and pay attention to the
+    entries for KubeSpawner version 7.0.0b1.
+- JupyterHub 4.1.6 has been upgraded to 5.1.0
+  - Refer to the [JupyterHub changelog] for details and pay attention to the
+    entries for JupyterHub version 5.0.0.
+- OAuthenticator 16.3.1 has been upgraded to 17.0.0
+  - If you are using an OAuthenticator based authenticator class
+    (GitHubOAuthenticator, GoogleOAuthenticator, ...), refer to the
+    [OAuthenticator changelog] for details and pay attention to the entries for
+    JupyterHub version 17.0.0.
+- LDAPAuthenticator 1.3.2 has been upgraded to 2.0.0b2
+  - If you are using this authenticator class, refer to the [LDAPAuthenticator
+    changelog] for details and pay attention to the entries for
+    LDAPAuthenticator version 2.0.0.
+
+[ldapauthenticator changelog]: https://github.com/jupyterhub/ldapauthenticator/blob/HEAD/CHANGELOG.md
 
 #### Notable dependencies updated
 
@@ -59,6 +67,7 @@ what changes between tagged versions.
 
 #### New features added
 
+- Add oauthenticator googlegroups extras and cleanup dependencies [#3523](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3523) ([@consideRatio](https://github.com/consideRatio), [@manics](https://github.com/manics))
 - Add `ingress.extraPaths` config [#3492](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3492) ([@alxyok](https://github.com/alxyok), [@consideRatio](https://github.com/consideRatio), [@manics](https://github.com/manics))
 - Add `singleuser.storage.dynamic.subPath` config [#3468](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3468) ([@benz0li](https://github.com/benz0li), [@consideRatio](https://github.com/consideRatio), [@manics](https://github.com/manics))
 - Add recommended chart labels alongside old labels (`app.kubernetes.io/...`, `helm.sh/chart`) [#3404](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/pull/3404) ([@consideRatio](https://github.com/consideRatio), [@manics](https://github.com/manics))