docs: improve comment clarity

shvlv · shvlv · commit 0b3cce741137 · 2024-09-04T12:53:53.000+03:00
diff --git a/src/Infrastructure/Repository/TimestampRepository.php b/src/Infrastructure/Repository/TimestampRepository.php
@@ -20,9 +20,9 @@ public function created(DegreeProgramId $id): ?DateTimeInterface
     }
 
     /**
-     * The custom field is updated even if related settings or terms are updated.
-     * If the custom field is missing, we can use the native
-     * WordPress "post modified" property as a fallback.
+     * The custom field is updated when the degree program or related settings or terms are updated.
+     * If the custom field does not exist,
+     * we fall back to the core WordPress "post modified" property.
      */
     public function modified(DegreeProgramId $id): ?DateTimeInterface
     {

Original file line number	Diff line number	Diff line change
`@@ -20,9 +20,9 @@ public function created(DegreeProgramId $id): ?DateTimeInterface`
`20`	`20`	`}`
`21`	`21`
`22`	`22`	`/**`
`23`		`- * The custom field is updated even if related settings or terms are updated.`
`24`		`- * If the custom field is missing, we can use the native`
`25`		`- * WordPress "post modified" property as a fallback.`
	`23`	`+ * The custom field is updated when the degree program or related settings or terms are updated.`
	`24`	`+ * If the custom field does not exist,`
	`25`	`+ * we fall back to the core WordPress "post modified" property.`
`26`	`26`	`*/`
`27`	`27`	`public function modified(DegreeProgramId $id): ?DateTimeInterface`
`28`	`28`	`{`