Document task scheduling

This relates to #484 and owncloud/docs#1900 task scheduling This relates to #484 and owncloud/docs#1900.
owncloud · Oct 18, 2019 · 96f451a · 96f451a
1 parent 6768537
commit 96f451a
Show file tree

Hide file tree

Showing 2 changed files with 34 additions and 0 deletions.
diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
@@ -8,6 +8,7 @@
 ** xref:ios_files_integration.adoc[iOS Files App and 3rd Party Apps]
 ** xref:ios_settings.adoc[Settings]
 
+* xref:ios_task_scheduling.adoc[Task Scheduling]
 * xref:ios_mdm.adoc[Mobile Device Management (MDM)]
 * xref:ios_security.adoc[Security]
 * xref:ios_troubleshooting.adoc[Troubleshooting]
diff --git a/docs/modules/ROOT/pages/ios_task_scheduling.adoc b/docs/modules/ROOT/pages/ios_task_scheduling.adoc
@@ -0,0 +1,33 @@
+= Task Scheduling
+
+Background tasks are scheduled based on the app's current context, and that context is based on a combination of factors. 
+These factors include:
+
+* Is the app backgrounded or in the foreground?
+* Is WiFi available?
+* Is the device in Low Power Mode?
+* Is the device connected to external power?
+* Has the photo library has changed?
+
+== Tasks 
+
+Currently, two tasks are available:
+
+* *Instant photo uploads:* This task is triggered when:
+** The photo library has new assets
+** The user is connected to a WiFi network
+* *Bookmark update task:* This task is triggered by the background fetch event scheduled by iOS
+
+=== Instant Photo Upload
+
+There are some things to be aware of, regarding Instant Photo Upload.
+
+* Photo and video upload can be enabled and disabled separately.
+* Before instant media upload can begin, the account and upload path have to be selected
+* Changes in the photo library are detected when the app goes into the foreground.
+* If a user removes the folder specified for instant upload, the upload task silently exits.
+* When a user first activates instant upload, the timestamp of the activation is stored and compared against the modification date of the assets to be uploaded. 
+  As soon as one asset is successfully uploaded, its modification timestamp is used to update the instant upload activation timestamp. This:
+** Prevents assets being uploaded twice
+** Removes the need to keep track of uploaded items in a database
+* Media conversion settings are taken into account by instant upload feature.