diff --git a/docs/how/updating-datahub.md b/docs/how/updating-datahub.md
index 09f13624d6..6998da0015 100644
--- a/docs/how/updating-datahub.md
+++ b/docs/how/updating-datahub.md
@@ -10,6 +10,17 @@ This file documents any backwards-incompatible changes in DataHub and assists pe
 
 ### Deprecations
 
+### Other notable Changes
+
+## `v0.8.36`
+
+### Breaking Changes
+- In this release we introduce a brand new Business Glossary experience. With this new experience comes some new ways of indexing data in order to make viewing and traversing the different levels of your Glossary possible. Therefore, you will have to [restore your indices](https://datahubproject.io/docs/how/restore-indices/) in order for the new Glossary experience to work for users that already have existing Glossaries. If this is your first time using DataHub Glossaries, you're all set!
+
+### Potential Downtime
+
+### Deprecations
+
 ### Other notable Changes
 - #4961 Dropped profiling is not reported by default as that caused a lot of spurious logging in some cases. Set `profiling.report_dropped_profiles` to `True` if you want older behaviour.