comment: Explain the new recurrence status logic

The comments were kindly written by @asokawotulo in:
#2516 (comment)

Co-Authored-By: Asoka Wotulo <32058490+asokawotulo@users.noreply.github.com>

src/Task.ts

@@ -432,13 +432,16 @@ export class Task {
             let nextStatus = statusRegistry.getNextStatusOrCreate(newStatus);
             if (nextStatus.type !== StatusType.TODO) {
                 let searchStatus = nextStatus;
+                // The goal here is to avoid an infinite loop. By limiting the search to the number of
+                // configured statuses, we ensure it doesn't continue indefinitely.
                 for (let i = 0; i < statusRegistry.registeredStatuses.length - 1; i++) {
                     searchStatus = statusRegistry.getNextStatusOrCreate(searchStatus);
                     if (searchStatus.type === StatusType.TODO) {
                         nextStatus = searchStatus;
                         break;
                     }
                 }
+                // If it fails to find any TODO status, it will use the next symbol after DONE.
             }
             const nextTask = new Task({
                 ...this,