docs: enhance getNewestItemDate method documentation for clarity and completeness

Grotax · Grotax · commit 896ac777b317 · 2025-11-13T18:53:24.000+01:00
diff --git a/src/FeedIo/Reader/Result/UpdateStats.php b/src/FeedIo/Reader/Result/UpdateStats.php
@@ -182,7 +182,11 @@ public function getMedianInterval(): int
     }
 
     /**
-     * @return int
+     * Returns the timestamp of the newest item in the feed.
+     * The value is capped at the current time to prevent future dates from being used.
+     * If the feed has no items with valid timestamps, returns the feed's last modified timestamp.
+     * 
+     * @return int Unix timestamp of the newest item (in seconds since epoch)
      */
     public function getNewestItemDate(): int
     {

Original file line number	Diff line number	Diff line change
`@@ -182,7 +182,11 @@ public function getMedianInterval(): int`
`182`	`182`	`}`
`183`	`183`
`184`	`184`	`/**`
`185`		`- * @return int`
	`185`	`+ * Returns the timestamp of the newest item in the feed.`
	`186`	`+ * The value is capped at the current time to prevent future dates from being used.`
	`187`	`+ * If the feed has no items with valid timestamps, returns the feed's last modified timestamp.`
	`188`	`+ *`
	`189`	`+ * @return int Unix timestamp of the newest item (in seconds since epoch)`
`186`	`190`	`*/`
`187`	`191`	`public function getNewestItemDate(): int`
`188`	`192`	`{`