chore: clean up comments and docs

src/util/create-hooks.svelte.ts

@@ -61,7 +61,7 @@ export type PointerDateTime = Writable<{
   type?: "dateTime" | "date" | undefined;
 }>;
 
-function useTasks(props: {
+export function useTasks(props: {
   settingsStore: Writable<DayPlannerSettings>;
   combinedIcalSyncTrigger: Readable<object>;
   debouncedTaskUpdateTrigger: Readable<object>;
@@ -71,6 +71,7 @@ function useTasks(props: {
   visibleDays: Readable<Moment[]>;
   layoutReady: Readable<boolean>;
   dataviewFacade: DataviewFacade;
+  // todo: replace with metadata cache
   app: App;
   dataviewSource: Readable<string>;
   currentTime: Readable<Moment>;
@@ -210,6 +211,7 @@ function useTasks(props: {
     tasksForToday,
     currentTime,
   });
+
   return {
     tasksWithActiveClockProps,
     getDisplayedTasksWithClocksForTimeline,

src/util/scheduler.ts

@@ -29,6 +29,10 @@ const cancelJob =
     clearTimeout(id);
   });
 
+/**
+ * A scheduler accepts a list of tasks (a batch) and reports back when all of them are done.
+ * If a new batch of tasks is added, the scheduler will discard the previous batch and run the new one.
+ */
 export function createBackgroundBatchScheduler<T>(
   onFinish: (results: T[]) => void,
 ) {
@@ -54,13 +58,6 @@ export function createBackgroundBatchScheduler<T>(
     if (tasks.length > 0) {
       currentTaskHandle = enqueueJob(runTaskQueue);
     } else {
-      performance.mark("batch-end");
-      // const { duration } = performance.measure(
-      //   "batch",
-      //   "batch-start",
-      //   "batch-end",
-      // );
-
       onFinish(results);
       currentTaskHandle = null;
     }