Update comments based on suggestions

Co-authored-by: Ollie <43674967+outdooracorn@users.noreply.github.com>

Author: dati18

app/Http/Controllers/ConversionMetricController.php

@@ -34,16 +34,16 @@ public function index(Request $request) {
             $daysSinceLastEdit = null;
 
             if ($wikiLastEditedTime !== null) {
-                // Cast to int to avoid fractional-day values in CSV/JSON and keep cutoff logic predictable.
+                // cast to int to retain Carbon 2 behaviour of using whole days
                 $daysSinceLastEdit = (int) $wikiLastEditedTime->diffInDays($current_date, false);
             }
 
             if ($daysSinceLastEdit !== null && $daysSinceLastEdit >= 90) {
-                // Keep exported duration as whole days for stable reporting.
+                // cast to int to retain Carbon 2 behaviour of using whole days
                 $time_before_wiki_abandoned_days = (int) $wiki->created_at->diffInDays($wikiLastEditedTime, false);
             }
             if ($wikiFirstEditedTime !== null) {
-                // Keep exported duration as whole days for stable reporting.
+                // cast to int to retain Carbon 2 behaviour of using whole days
                 $time_to_engage_days = (int) $wiki->created_at->diffInDays($wikiFirstEditedTime, false);
             }
             $wiki_number_of_editors = $wiki->wikiSiteStats()->first()['activeusers'] ?? null;

app/Jobs/PlatformStatsSummaryJob.php

@@ -132,7 +132,8 @@ public function prepareStats(array $allStats, $wikis): array {
             // is it edited in the last 90 days?
             if (!is_null($stats['lastEdit'])) {
                 $lastTimestamp = MWTimestampHelper::getCarbonFromMWTimestamp(intval($stats['lastEdit']));
-                // Carbon can return fractional seconds; cast to int so threshold checks use whole-second precision.
+                // cast to int retain Carbon 2 behaviour of using whole days
+                // pass `$absolute = true` argument to retain Carbon 2 behaviour of returning an absolute diff
                 $diff = (int) $lastTimestamp->diffInSeconds($currentTime, true);
 
                 if ($diff <= $this->inactiveThreshold) {

app/Jobs/SendEmptyWikiNotificationsJob.php

@@ -34,7 +34,7 @@ public function checkIfWikiIsOldAndEmpty(Wiki $wiki) {
         $emptyDaysThreshold = config('wbstack.wiki_empty_notification_threshold');
         $createdAt = $wiki->created_at;
         $now = CarbonImmutable::now();
-        // Normalize to whole days so comparisons with the integer config threshold stay deterministic.
+        // cast to int to retain Carbon 2 behaviour of using whole days
         $emptyWikiDays = (int) $createdAt->diffInDays($now, true);
 
         $firstEdited = $wiki->wikiLifecycleEvents->first_edited;