From 067166d420d431853740cd00d1ce197dcf0f9e26 Mon Sep 17 00:00:00 2001
From: Jens Langhammer <jens.langhammer@beryju.org>
Date: Sat, 17 Sep 2022 14:28:04 +0200
Subject: [PATCH] website: update 2022.9 release notes

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>
---
 website/docs/releases/v2022.9.md | 101 ++++++++++++++++++++++++++++++-
 website/sidebars.js              |   3 +-
 2 files changed, 100 insertions(+), 4 deletions(-)

diff --git a/website/docs/releases/v2022.9.md b/website/docs/releases/v2022.9.md
index 7417b8131..4c7401023 100644
--- a/website/docs/releases/v2022.9.md
+++ b/website/docs/releases/v2022.9.md
@@ -3,19 +3,81 @@ title: Release 2022.9
 slug: "2022.9"
 ---
 
-## Breaking changes
-
 ## New features
 
+-   UI for Duo device Import
+
+    Instead of manually having to call an API endpoint, there's now a UI for importing Duo devices.
+
+-   Duo Admin API integration
+
+    When using a Duo MFA, Duo Access or Duo Beyond plan, authentik can now automatically import devices from Duo into authentik. More info [here](../flow/stages/authenticator_duo/index).
+
 ## API Changes
 
+#### What's New
+
+---
+
+##### `POST` /stages/authenticator/duo/{stage_uuid}/import_device_manual/
+
+##### `POST` /stages/authenticator/duo/{stage_uuid}/import_devices_automatic/
+
+#### What's Deleted
+
 ---
 
 ##### `POST` /stages/authenticator/duo/{stage_uuid}/import_devices/
 
+#### What's Changed
+
+---
+
+##### `GET` /stages/authenticator/duo/{stage_uuid}/
+
+###### Return Type:
+
+Changed response : **200 OK**
+
+-   Changed content type : `application/json`
+
+    -   Added property `admin_integration_key` (string)
+
+##### `PUT` /stages/authenticator/duo/{stage_uuid}/
+
 ###### Request:
 
-Deleted content type : `application/json`
+Changed content type : `application/json`
+
+-   Added property `admin_integration_key` (string)
+
+-   Added property `admin_secret_key` (string)
+
+###### Return Type:
+
+Changed response : **200 OK**
+
+-   Changed content type : `application/json`
+
+    -   Added property `admin_integration_key` (string)
+
+##### `PATCH` /stages/authenticator/duo/{stage_uuid}/
+
+###### Request:
+
+Changed content type : `application/json`
+
+-   Added property `admin_integration_key` (string)
+
+-   Added property `admin_secret_key` (string)
+
+###### Return Type:
+
+Changed response : **200 OK**
+
+-   Changed content type : `application/json`
+
+    -   Added property `admin_integration_key` (string)
 
 ##### `GET` /flows/executor/{flow_slug}/
 
@@ -121,8 +183,41 @@ Changed response : **200 OK**
 
     -   Property `traceback` (string)
 
+##### `POST` /stages/authenticator/duo/
+
+###### Request:
+
+Changed content type : `application/json`
+
+-   Added property `admin_integration_key` (string)
+
+-   Added property `admin_secret_key` (string)
+
+###### Return Type:
+
+Changed response : **201 Created**
+
+-   Changed content type : `application/json`
+
+    -   Added property `admin_integration_key` (string)
+
+##### `GET` /stages/authenticator/duo/
+
+###### Return Type:
+
+Changed response : **200 OK**
+
+-   Changed content type : `application/json`
+
+    -   Changed property `results` (array)
+
+        Changed items (object): > AuthenticatorDuoStage Serializer
+
+        -   Added property `admin_integration_key` (string)
+
 ## Minor changes/fixes
 
+-   stages/authenticator_duo: improved import (#3601)
 -   \*: cleanup stray print calls
 -   \*: remove remaining default creation code in squashed migrations
 -   blueprint: fix EntryInvalidError not being handled in tasks
diff --git a/website/sidebars.js b/website/sidebars.js
index 17e6e89c8..4613f3b8e 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -205,13 +205,14 @@ module.exports = {
                 description: "Release notes for recent authentik versions",
             },
             items: [
+                "releases/v2022.9",
                 "releases/v2022.8",
                 "releases/v2022.7",
-                "releases/v2022.6",
                 {
                     type: "category",
                     label: "Previous versions",
                     items: [
+                        "releases/v2022.6",
                         "releases/v2022.5",
                         "releases/v2022.4",
                         "releases/v2022.2",