Expand docs.

Author: chmac

src/Task/Occurrence.ts

@@ -57,8 +57,11 @@ export class Occurrence {
             return window.moment(this.dueDate);
         }
 
-        // If the `removeScheduledDateOnRecurrence` setting is enabled, pick the
-        // `startDate` before the `scheduledDate`.
+        // If the `removeScheduledDateOnRecurrence` setting is enabled, it does
+        // not make sense to pick the scheduled date over the start date because
+        // the scheduled date will be deleted in the newly created task. So if
+        // this setting is enabled, and there is a start date, we pick that date
+        // now before falling back on the standard logic below.
         const { removeScheduledDateOnRecurrence } = getSettings();
         if (removeScheduledDateOnRecurrence && this.startDate) {
             return window.moment(this.startDate);