diff --git a/src/script/api/script_town.hpp b/src/script/api/script_town.hpp
index b41b7f4012..d301cbe563 100644
--- a/src/script/api/script_town.hpp
+++ b/src/script/api/script_town.hpp
@@ -252,7 +252,8 @@ public:
 	 * @param days_between_town_growth The amount of days between town growth.
 	 * @pre IsValidTown(town_id).
 	 * @return True if the action succeeded.
-	 * @note If 'Fund Building' and 'economy.town_growth_rate' is active, the game will often set a new GrowthRate.
+	 * @note Even when setting a growth rate, towns only grow when the conditions for growth (SetCargoCoal) are met,
+	 *       and the game settings (economy.town_growth_rate) allow town growth at all.
 	 * @api -ai
 	 */
 	static bool SetGrowthRate(TownID town_id, uint16 days_between_town_growth);