diff --git a/docs/release-notes/release-notes-5.0.0.rst b/docs/release-notes/release-notes-5.0.0.rst
new file mode 100644
--- /dev/null
+++ b/docs/release-notes/release-notes-5.0.0.rst
@@ -0,0 +1,51 @@
+|RCE| 5.0.0 |RNS|
+-----------------
+
+Release Date
+^^^^^^^^^^^^
+
+- 2024-05-14
+
+
+New Features
+^^^^^^^^^^^^
+
+- Full support of Python3 and Python3.11
+- Git repositories with LFS object are now pushing and pulling the LFS objects when remote sync is enabled.
+- Archive generation: implemented a new system for caching generated archive files that allows setting cache size limit see: archive_cache.cache_size_gb= option.
+- Introduced statsd metrics in various places for new monitoring stack to provide useful details on traffic and usage.
+
+
+General
+^^^^^^^
+
+- Upgraded all dependency libraries to their latest available versions for python3 compatability
+
+
+Security
+^^^^^^^^
+
+- fixed few edge cases of permission invalidation on change of permissions
+
+
+Performance
+^^^^^^^^^^^
+
+- Moved lot of dulwich based code into libgit2 implementation for better performance
+
+
+Fixes
+^^^^^
+
+- Various small fixes and improvements found during python3 migration
+
+
+Upgrade notes
+^^^^^^^^^^^^^
+
+- RhodeCode 5.0.0 is a mayor upgrade that support latest Python versions 3.11,
+  and also comes with lots of internal changes and performance improvements.
+- RhodeCode 5.0.0 is only supported via our new docker rcstack installer or helm/k8s stack
+- Please see migration guide :ref:`rcstack:migration-to-rcstack`
+- RhodeCode 5.0.0 also requires a new license for EE instances, please reach out to us via support@rhodecode.com to
+  convert your license key.
diff --git a/docs/release-notes/release-notes-5.1.0.rst b/docs/release-notes/release-notes-5.1.0.rst
new file mode 100644
--- /dev/null
+++ b/docs/release-notes/release-notes-5.1.0.rst
@@ -0,0 +1,49 @@
+|RCE| 5.1.0 |RNS|
+-----------------
+
+Release Date
+^^^^^^^^^^^^
+
+- TBA
+- available as docker "beta" tag rhodecode/rhodecode-ce:beta, rhodecode/rhodecode-ee:beta
+
+
+New Features
+^^^^^^^^^^^^
+
+- We've introduced 2FA for users. Now alongside the external auth 2fa support RhodeCode allows to enable 2FA for users
+  2FA options will be available for each user individually, or enforced via authentication plugins like ldap, or internal.
+- Email based log-in. RhodeCode now allows to log-in using email as well as username for main authentication type.
+- Ability to replace a file using web UI. Now one can replace an existing file from the web-ui.
+- GIT LFS Sync automation. Remote push/pull commands now can also sync GIT LFS objects.
+
+General
+^^^^^^^
+
+- Upgraded all dependency libraries to their latest available versions
+- Repository storage is no longer controlled via DB settings, but .ini file. This allows easier automated deployments.
+
+
+Security
+^^^^^^^^
+
+
+
+Performance
+^^^^^^^^^^^
+
+- Introduced a full rewrite of ssh backend for performance. The result is 2-5x speed improvement for operation with ssh.
+  enable new ssh wrapper by setting: `ssh.wrapper_cmd = /home/rhodecode/venv/bin/rc-ssh-wrapper-v2`
+
+
+Fixes
+^^^^^
+
+- Zip archive download breaks when a gitmodules file is present
+
+
+Upgrade notes
+^^^^^^^^^^^^^
+
+- RhodeCode 5.1.0 is a mayor feature release after big 5.0.0 python3 migration. Happy to ship a first time feature
+  rich release
diff --git a/docs/release-notes/release-notes.rst b/docs/release-notes/release-notes.rst
--- a/docs/release-notes/release-notes.rst
+++ b/docs/release-notes/release-notes.rst
@@ -3,6 +3,17 @@
 Release Notes
 =============
 
+
+|RCE| 5.x Versions
+------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   release-notes-5.0.0.rst
+   release-notes-5.1.0.rst
+
+
 |RCE| 4.x Versions
 ------------------