From b26da4a609cd331240d85c7246406a7e242a3e5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Baki=20Burak=20=C3=96=C4=9F=C3=BCn?=
 <63836730+bakiburakogun@users.noreply.github.com>
Date: Sat, 29 Aug 2026 05:58:38 +0300
Subject: [PATCH] docs(ai/assistant): document the assistant data folder name
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

docs(ai/assistant): document the assistant data folder name

The assistant creates a folder in each user's files for the content it

generates. Its name is now configurable server-wide and per user, but neither

the key nor the behaviour around existing folders was written down anywhere.

Documents both settings next to the other assistant occ options, and the two

things that surprise people: changing the name leaves existing folders alone,

and a user who already has a folder under the built-in name keeps it rather

than getting a second one.

Adds the user facing side to the user manual as well: where the assistant saves

what it generates, that the name can be changed in the personal settings, and

that changing it leaves the existing folder alone. The skills path is stated

relative to that folder rather than hardcoded, since the skills folder is

resolved inside it.

Signed-off-by: Baki Burak Öğün <63836730+bakiburakogun@users.noreply.github.com>

[skip ci]
---
 admin_manual/ai/app_assistant.rst | 27 +++++++++++++++++++++++++++
 user_manual/ai_assistant.rst      | 19 +++++++++++++++++--
 2 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/admin_manual/ai/app_assistant.rst b/admin_manual/ai/app_assistant.rst
index 5f66636e7f0..6ecf74c8a30 100644
--- a/admin_manual/ai/app_assistant.rst
+++ b/admin_manual/ai/app_assistant.rst
@@ -190,6 +190,33 @@ To enable/disable the text-to-image smart picker for all the users.
 
 To enable/disable the speech-to-text smart picker for all the users.
 
+5. Data folder
+
+.. code-block::
+
+   occ config:app:set assistant default_data_folder --value="Assistant" --type=string
+
+The assistant stores the content it generates, such as generated images and speech-to-text
+output, in a folder in the files of each user. This sets the name that folder is given when
+it is created. It defaults to ``Assistant``, and is also editable in the Assistant admin
+settings.
+
+Users can choose their own name in their personal Assistant settings, which is stored per
+user and takes precedence over the server-wide default:
+
+.. code-block::
+
+   occ user:setting $USER_ID assistant data_folder "Assistant"
+
+Two things to keep in mind:
+
+* Changing either value does not rename or move a folder that already exists. It only
+  affects the name used the next time a folder has to be created, so existing generated
+  content stays where it is.
+* A user who already has a folder under the built-in name ``Assistant``, from before a
+  default was set, keeps using it. This avoids starting a second folder for them and
+  leaving their earlier output behind.
+
 Task processing
 ~~~~~~~~~~~~~~~
 
diff --git a/user_manual/ai_assistant.rst b/user_manual/ai_assistant.rst
index ce59e71e8e5..0892e42dec3 100644
--- a/user_manual/ai_assistant.rst
+++ b/user_manual/ai_assistant.rst
@@ -20,8 +20,23 @@ Personal settings
 -----------------
 
 The assistant personal settings are in **Personal settings** under the **Artificial intelligence**
-section. You can disable the assistant top menu entry there, and enable or disable the
-AI-related smart pickers.
+section. You can disable the assistant top menu entry there, enable or disable the
+AI-related smart pickers, and change the name of the folder the assistant saves its output to.
+
+Where generated content is saved
+--------------------------------
+
+Content the assistant generates for you, such as generated images and speech-to-text output, is
+saved to a folder in your Files. It is called ``Assistant`` unless your administrator has chosen
+a different name for the instance.
+
+You can pick your own name for it under **Data folder** in the assistant personal settings. Leave
+the field empty to keep the name your administrator has set; the placeholder shows what that is.
+
+.. note::
+
+   Changing the name does not rename or move the folder you already have. It applies the next
+   time a folder has to be created, so anything generated before the change stays where it is.
 
 Running a task
 --------------