From b9f86efba080dde6740821c3cc7fb15e4cf63ecd Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Nov 2026 11:31:38 -0500 Subject: [PATCH 1/4] docs(admin): list Flow under Automation Move the Flow chapter from the Files toctree into the Automation section. Keep its source path unchanged so existing URLs and references continue to work, and retain the `file_workflows` label for cross-references. Seems like a natural follow-up to #15748. Signed-off-by: Josh --- admin_manual/contents.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index a7dc2fff270..3a3caa739d0 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -35,7 +35,6 @@ Table of contents :caption: Files configuration_files/index - file_workflows/index configuration_mimetypes/index .. toctree:: @@ -56,6 +55,7 @@ Table of contents :caption: automation automation_overview/index + file_workflows/index webhook_listeners/index webhook_listeners/budibase_workflows windmill_workflows/index From ad54e04c65924aef309f1d6afd3ad6de9dc9eaf2 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Nov 2026 11:54:12 -0500 Subject: [PATCH 2/4] docs(admin): reorganize Flow chapter Introduce Flow with a proper chapter overview and group its general configuration separately from the documented operations: File Access Control, Files Automated Tagging, and Files Retention. Link to the app store for additional Flow apps. Keep existing document paths and references unchanged. Signed-off-by: Josh --- admin_manual/file_workflows/index.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/admin_manual/file_workflows/index.rst b/admin_manual/file_workflows/index.rst index 6e7aacc0f3b..ffc42440210 100644 --- a/admin_manual/file_workflows/index.rst +++ b/admin_manual/file_workflows/index.rst @@ -4,11 +4,35 @@ Flow ==== +Flow provides rule-based automation in Nextcloud. Administrators can define +system-wide flows, while users can define personal flows (unless disabled +by the administrator). + +Apps can extend the available Flow automation capabilities. This chapter +covers three common apps: File Access Control, Files Automated Tagging +and Files Retention. + +Additional Flow apps can be found in the `Nextcloud app store +`_. + +General configuration +--------------------- + +The following settings apply to Flow itself rather than to an individual Flow app. .. toctree:: :maxdepth: 2 configuration + +Add-on Flow apps +---------------- + +Each Flow app provides its own functionality and configuration: + +.. toctree:: + :maxdepth: 2 + access_control automated_tagging retention From 6d340e7294429086684feecd78a59b23ff49f453 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Nov 2026 12:05:47 -0500 Subject: [PATCH 3/4] docs(admin): document the block file versioning operation Add a Flow chapter page for the operation provided by the Versions app. Explain how administrators can configure rules to block new versions, including a collaborative tag example and the effect on existing versions. Signed-off-by: Josh --- admin_manual/file_workflows/versioning.rst | 34 ++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 admin_manual/file_workflows/versioning.rst diff --git a/admin_manual/file_workflows/versioning.rst b/admin_manual/file_workflows/versioning.rst new file mode 100644 index 00000000000..f6f765ebc54 --- /dev/null +++ b/admin_manual/file_workflows/versioning.rst @@ -0,0 +1,34 @@ +===================== +Block file versioning +===================== + +The Versions app (``files_versions``) provides the **Block file versioning** +Flow operation. Administrators can use it to prevent new file versions from +being created when a file matches specified rules. The operation is available +for system-wide flows, not personal flows. + +Configuration +------------- + +In Administration settings, open Flow and add a **Block file versioning** +flow. Add at least one rule specifying which files should not be versioned. +The operation is evaluated when a new version would otherwise be created. + +For example, add a **File collaborative tag** rule to block version creation +for files with a particular tag. The rule also matches files in folders with +that tag; see :ref:`available-rules-label` for details. + +Effects +------- + +When a flow matches, the Versions app skips creating the new version. This +does not block the file change or delete existing versions. Existing versions +remain subject to the normal version expiration rules. + +.. warning:: + + Changes made without creating a version cannot be recovered through that + skipped version. + +For general version retention and expiration settings, see +:doc:`../configuration_files/file_versioning`. From a9de5bd5e0cd5659055618ebaf680cf92cbf084b Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Nov 2026 12:14:18 -0500 Subject: [PATCH 4/4] docs(admin): add block file versioning operation Flow chapter link Add link to Flow chapter page for the operation provided by the Versions app. Group the documented operations under a heading that also covers operations provided by general-purpose apps. Signed-off-by: Josh --- admin_manual/file_workflows/index.rst | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/admin_manual/file_workflows/index.rst b/admin_manual/file_workflows/index.rst index ffc42440210..c2a7149ead4 100644 --- a/admin_manual/file_workflows/index.rst +++ b/admin_manual/file_workflows/index.rst @@ -8,9 +8,9 @@ Flow provides rule-based automation in Nextcloud. Administrators can define system-wide flows, while users can define personal flows (unless disabled by the administrator). -Apps can extend the available Flow automation capabilities. This chapter -covers three common apps: File Access Control, Files Automated Tagging -and Files Retention. +Apps can provide additional Flow operations. This chapter covers operations +provided by File Access Control, Files Automated Tagging, Files Retention +and the Versions app. Additional Flow apps can be found in the `Nextcloud app store `_. @@ -18,17 +18,19 @@ Additional Flow apps can be found in the `Nextcloud app store General configuration --------------------- -The following settings apply to Flow itself rather than to an individual Flow app. +The following settings apply to Flow itself rather than to an individual Flow app +/ operation. .. toctree:: :maxdepth: 2 configuration -Add-on Flow apps ----------------- +Operations +---------- -Each Flow app provides its own functionality and configuration: +Each app provides its own functionality and configuration. The following Flow operations +are covered here: .. toctree:: :maxdepth: 2 @@ -36,3 +38,4 @@ Each Flow app provides its own functionality and configuration: access_control automated_tagging retention + versioning