diff --git a/energyplugin/etm/adapters/sgreadyadapter.h b/energyplugin/etm/adapters/sgreadyadapter.h
index 57dcb5b..cd8d433 100644
--- a/energyplugin/etm/adapters/sgreadyadapter.h
+++ b/energyplugin/etm/adapters/sgreadyadapter.h
@@ -91,8 +91,11 @@ public:
 private:
     /*!
      * \brief Fenêtre d'états autorisée à \p now par le verrou minStateHold (symétrique).
-     * \param[out] minState / maxState  Gel total (== \c m_currentState) si \c minStateHold
-     *   non écoulé ; sinon [min, max] des états déclarés.
+     * \param now       Temps de cycle (\c ctx.timestamp) — jamais l'horloge.
+     * \param[out] minState  Borne basse : \c m_currentState si \c minStateHold non écoulé
+     *   (gel total), sinon le plus petit état déclaré.
+     * \param[out] maxState  Borne haute : \c m_currentState si \c minStateHold non écoulé
+     *   (gel total), sinon le plus grand état déclaré.
      */
     void lockWindow(const QDateTime &now, int &minState, int &maxState) const;
 
diff --git a/energyplugin/etm/config/loadconfigstore.h b/energyplugin/etm/config/loadconfigstore.h
index 373b73f..548fda8 100644
--- a/energyplugin/etm/config/loadconfigstore.h
+++ b/energyplugin/etm/config/loadconfigstore.h
@@ -13,8 +13,9 @@
  * energy-load-configuration.json, à côté de \c energy-manager-configuration.json) et émet
  * \c changed() — l'arbitre reconstruit ses adaptateurs sur ce signal, le handler notifie l'app.
  *
- * Format fichier : \c {"version":1,"loads":[ <LoadConfig §4>, ... ]}. Le tableau \c loads[]
- * est **mot pour mot** le \c LoadDescriptor §4 (jonction inter-repos avec l'app).
+ * Format fichier : \c {"version":1,"loads":[ ... ]}, chaque entrée étant un \c LoadConfig §4.
+ * Le tableau \c loads[] est **mot pour mot** le \c LoadDescriptor §4 (jonction inter-repos
+ * avec l'app).
  *
  * \invariant Écriture atomique (fichier temporaire + \c rename) — jamais de fichier mi-écrit.
  * \invariant \c setConfigs() rejette en bloc (rien persisté) si une seule entrée est invalide.