Merge pull request #12561 from nextcloud/feat/file-conversion-docs

elzody · web-flow · commit 37483040410d · 2025-02-25T16:50:56.000-05:00
feat: file conversion docs
diff --git a/admin_manual/configuration_files/file_conversion.rst b/admin_manual/configuration_files/file_conversion.rst
@@ -0,0 +1,7 @@
+===============
+File conversion
+===============
+
+In the majority of cases, it is recommended that either the Pandoc or :doc:`Nextcloud Office <../office/installation>` apps
+are enabled, as they provide the majority of file conversions available. Other apps may also
+support their own file conversions for other file types if more specific conversions are required.
diff --git a/admin_manual/configuration_files/index.rst b/admin_manual/configuration_files/index.rst
@@ -20,3 +20,4 @@ File sharing and management
     previews_configuration
     file_versioning
     trashbin_configuration
+    file_conversion
diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_31.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_31.rst
@@ -55,7 +55,8 @@ to check whether the current Files app instance is a public share or not, and if
 Added APIs
 ^^^^^^^^^^
 
-- TBD
+- If an app supports file conversion, it may now register an ``\OCP\Files\Conversion\ConversionProvider`` which will
+  be called automatically based on the supported MIME types. An app may register as many of these as needed.
 
 Changed APIs
 ^^^^^^^^^^^^
