From bb0ba9abfd934415b6a8a2c24da3cab1f279b291 Mon Sep 17 00:00:00 2001
From: Oliver Bertuch <o.bertuch@fz-juelich.de>
Date: Mon, 2 Oct 2023 15:16:50 +0200
Subject: [PATCH] doc(oidc): move example JSON to downloadable file #9268

---
 .../files/root/auth-providers/oidc.json         |  8 ++++++++
 doc/sphinx-guides/source/installation/oidc.rst  | 17 +++++------------
 2 files changed, 13 insertions(+), 12 deletions(-)
 create mode 100644 doc/sphinx-guides/source/_static/installation/files/root/auth-providers/oidc.json

diff --git a/doc/sphinx-guides/source/_static/installation/files/root/auth-providers/oidc.json b/doc/sphinx-guides/source/_static/installation/files/root/auth-providers/oidc.json
new file mode 100644
index 00000000000..9df38988a25
--- /dev/null
+++ b/doc/sphinx-guides/source/_static/installation/files/root/auth-providers/oidc.json
@@ -0,0 +1,8 @@
+{
+    "id":"<a unique id>",
+    "factoryAlias":"oidc",
+    "title":"<a title - shown in UI>",
+    "subtitle":"<a subtitle - currently unused in UI>",
+    "factoryData":"type: oidc | issuer: <issuer url> | clientId: <client id> | clientSecret: <client secret> | pkceEnabled: <true/false> | pkceMethod: <PLAIN/S256/...>",
+    "enabled":true
+}
\ No newline at end of file
diff --git a/doc/sphinx-guides/source/installation/oidc.rst b/doc/sphinx-guides/source/installation/oidc.rst
index 4a0c77006e0..50cb494330b 100644
--- a/doc/sphinx-guides/source/installation/oidc.rst
+++ b/doc/sphinx-guides/source/installation/oidc.rst
@@ -95,18 +95,11 @@ Provision via REST API
 Note: you may omit the PKCE related settings from ``factoryData`` below if you don't plan on using PKCE - default is
 disabled.
 
-Please create a ``my-oidc-provider.json`` file like this, replacing every ``<...>`` with your values:
-
-.. code-block:: json
-
-    {
-        "id":"<a unique id>",
-        "factoryAlias":"oidc",
-        "title":"<a title - shown in UI>",
-        "subtitle":"<a subtitle - currently unused in UI>",
-        "factoryData":"type: oidc | issuer: <issuer url> | clientId: <client id> | clientSecret: <client secret> | pkceEnabled: <true/false> | pkceMethod: <PLAIN/S256/...>",
-        "enabled":true
-    }
+Please create a :download:`my-oidc-provider.json <../_static/installation/files/root/auth-providers/oidc.json>` file, replacing every ``<...>`` with your values:
+
+.. literalinclude:: /_static/installation/files/root/auth-providers/oidc.json
+    :name: oidc-provider-example
+    :language: json
 
 Now load the configuration into your Dataverse installation using the same API as with :doc:`oauth2`: