[DX-913] Add release notes for the portal v1.8.2 (#3792)

* [DX-913] Add release notes for the portal v1.8.2 --------- Co-authored-by: dcs3spp <[email protected]> Co-authored-by: Simon Pears <[email protected]>
TykTechnologies · Dec 23, 2023 · 9e46d91 · 9e46d91
1 parent 16855c9
commit 9e46d91
Show file tree

Hide file tree

Showing 2 changed files with 74 additions and 0 deletions.
diff --git a/...ent/product-stack/tyk-enterprise-developer-portal/release-notes/portal-1.8.2.md b/...ent/product-stack/tyk-enterprise-developer-portal/release-notes/portal-1.8.2.md
@@ -0,0 +1,70 @@
+---
+title: Tyk Enterprise Developer Portal v1.8.2
+description: Release notes documenting updates, enhancements and changes for Tyk Enterprise Developer Portal v1.8.2
+tags: ["Developer Portal", "Release notes", "changelog", "v1.8.2"]
+menu:
+main:
+parent: "Release Notes"
+weight: 7
+---
+
+**Licensed Protected Product**
+
+### Support Lifetime
+We strive to avoid any long-term support arrangements for our enterprise portal. We run a regular 6-week release cadence which delivers new capability, extension of existing capability, and bug fixes. Our policy is that we aim to avoid any breaking changes, so in effect, the entire enterprise portal is supported. Here we'd increment our version as a minor version - 1.3.0, 1.4.0, 1.5.0 etc.
+
+Occasionally, we may see a need to issue a critical fix if there is a system down or a critical security defect. Here we would release this as soon as is physically possible and the semantic versioning would reflect a patch (1.3.1, 1.4.1 etc).
+
+The only exception to this policy is if we ever need to release a breaking change. This would mean that we have to release a new major version (i.e. releasing version 2.0). In this exceptional circumstance we would support both the old major version and the new one concurrently for six months - please note that the old version only gets supported in terms of critical fixes, not new functionality. After six months, the previous major version falls out of support.
+
+##### Release Date 22 Dec 2023
+
+#### Breaking Changes
+This release has no breaking changes.
+
+#### Future breaking changes
+This release doesn't introduce future breaking changes.
+
+#### Deprecations
+There are no deprecations in this release.
+
+#### Upgrade instructions
+If you are on 1.8.1 or an older version we advise you to upgrade ASAP directly to this release.
+
+To upgrade the portal's theme please follow the [upgrade instructions]({{< ref "product-stack/tyk-enterprise-developer-portal/upgrading/theme-upgrades" >}}) for the portal's themes.
+
+
+## Release Highlights
+The 1.8.2 release addresses multiple high-priority bugs:
+- Fixed the bug where an API Consumer could add incompatible products to a cart making its state inconsistent.
+- Fixed the bug where it was possible to use the same session cookie from different IP addresses making the portal vulnerable to the [Cross-Site Request Forgery (CSRF) attack](https://en.wikipedia.org/wiki/Cross-site_request_forgery).
+- Fixed the bug where an admin user couldn't create a new team in Kubernetes environment.
+- Fixed the bug where the navigation in the API documentation was broken when Redoc is selected as a documentation rendering engine.
+- Fixed the bug where an API Consumer could bypass the access request rate limit by creating additional applications.
+- Fixed the bug where the page rendering fails if the page refers to a template that has no template/layout pair definition in the theme manifest.
+- Fixed the bug where creating new content blocks in non-default themes led to duplication of those content blocks in the admin UI.
+- Fixed the bug where `.Markdown` content blocks where not shown.
+
+## Download
+- [Docker image to pull](https://hub.docker.com/layers/tykio/portal/v1.8.2/images/sha256-944b6fd5bead39b77cbfa50706098d52ce4c003b483b1f5e20456c65ede40fb2?context=explore)
+- [The default theme package](https://github.com/TykTechnologies/portal-themes/blob/main/v1.8.2/default.zip)
+
+## Changelog
+
+#### Fixed
+- Fixed the bug where an API Consumer could add incompatible products to a cart making its state inconsistent.
+- Fixed the bug where it was possible to use the same session cookie from different IP addresses making the portal vulnerable to the [Cross-Site Request Forgery (CSRF) attack](https://en.wikipedia.org/wiki/Cross-site_request_forgery).
+- Fixed the bug where an admin user couldn't create a new team in Kubernetes environment.
+- Fixed the bug where the navigation in the API documentation was broken when Redoc is selected as a documentation rendering engine.
+- Fixed the bug where an API Consumer could bypass the access request rate limit by creating additional applications.
+- Fixed the bug where the page rendering fails if the page refers to a template that has no template/layout pair definition in the theme manifest.
+- Fixed the bug where creating new content blocks in non-default themes led to duplication of those content blocks in the admin UI.
+- Fixed the bug where `.Markdown` content blocks where not shown.
+
+## Further Information
+
+### Upgrading Tyk
+Please refer to the [upgrading Tyk]({{< ref "upgrading-tyk" >}}) page for further guidance with respect to the upgrade strategy.
+
+### FAQ
+Please visit our [Developer Support]({{< ref "frequently-asked-questions/faq" >}}) page for further information relating to reporting bugs, upgrading Tyk, technical support and how to contribute.
diff --git a/tyk-docs/data/menu.yaml b/tyk-docs/data/menu.yaml
@@ -3078,6 +3078,10 @@ menu:
         category: Directory
         show: True
         menu:
+          - title: "Version 1.8.2"
+            path: /product-stack/tyk-enterprise-developer-portal/release-notes/portal-1.8.2
+            category: Page
+            show: True
           - title: "Version 1.8.1"
             path: /product-stack/tyk-enterprise-developer-portal/release-notes/portal-1.8.1
             category: Page