From b7e7f0f72025f9e52ebe70b5bfc63a5e5fb742e4 Mon Sep 17 00:00:00 2001
From: Lightos1 <124387232+Lightos1@users.noreply.github.com>
Date: Fri, 8 May 2026 18:18:32 +0200
Subject: [PATCH] clarify stable struct

---
 Source/hoc-clk/common/include/hocclk/clock_manager.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Source/hoc-clk/common/include/hocclk/clock_manager.h b/Source/hoc-clk/common/include/hocclk/clock_manager.h
index 717a6668..3ad241b7 100644
--- a/Source/hoc-clk/common/include/hocclk/clock_manager.h
+++ b/Source/hoc-clk/common/include/hocclk/clock_manager.h
@@ -32,6 +32,10 @@
 
 typedef struct {
 
+    /*
+     * This "stable struct" must never be modified. It provides a fixed memory layout so external clients can safely read the expected fields even
+     * if HocClkContext changes in newer versions and the client is not recompiled.
+     */
     struct {
         #define HocClkModuleStable_EnumMax 5
         #define HocClkThermalSensorStable_EnumMax 11