diff --git a/src/Chronos.php b/src/Chronos.php
index 267f96b..392be84 100644
--- a/src/Chronos.php
+++ b/src/Chronos.php
@@ -46,7 +46,7 @@
  * @property-read int<1, 31> $daysInMonth number of days in the given month
  * @property-read int $age does a diffInYears() with default parameters
  * @property-read int<1, 4> $quarter the quarter of this instance, 1 - 4
- * @property-read int<1, 2> $halfOfYear the half of year of this instance, 1 - 2
+ * @property-read int<1, 2> $halfOfYear the half of the year, with 1 for months Jan...Jun and 2 for Jul...Dec.
  * @property-read int $offset the timezone offset in seconds from UTC
  * @property-read int $offsetHours the timezone offset in hours from UTC
  * @property-read bool $dst daylight savings time indicator, true if DST, false otherwise
diff --git a/src/ChronosDate.php b/src/ChronosDate.php
index b9a194d..09e40a2 100644
--- a/src/ChronosDate.php
+++ b/src/ChronosDate.php
@@ -39,7 +39,7 @@
  * @property-read int<1, 31> $daysInMonth number of days in the given month
  * @property-read int $age does a diffInYears() with default parameters
  * @property-read int<1, 4> $quarter the quarter of this instance, 1 - 4
- * @property-read int<1, 2> $halfOfYear the half of year of this instance, 1 - 2
+ * @property-read int<1, 2> $halfOfYear the half of the year, with 1 for months Jan...Jun and 2 for Jul...Dec.
  * @psalm-immutable
  * @psalm-consistent-constructor
  */