diff --git a/README.md b/README.md
index 06fcdec..9ad7fbd 100644
--- a/README.md
+++ b/README.md
@@ -14,10 +14,10 @@
 
 ## Features
 
-1. Support of AHT10/AHT15/AHT20/AHT21/AHT25/AHT30/AHT40
-2. Support multiple sensors on one device with [zh_pca9548a](https://github.com/aZholtikov/zh_pca9548a)
-3. CRC8 data integrity verification
-4. Error statistics tracking
+1. Support of AHT10/AHT15/AHT20/AHT21/AHT25/AHT30/AHT40.
+2. Support multiple sensors on one device with [zh_pca9548a](https://github.com/aZholtikov/zh_pca9548a).
+3. CRC8 data integrity verification.
+4. Error statistics tracking.
 
 ## Using
 
diff --git a/include/zh_aht.h b/include/zh_aht.h
index 5064df1..f31d3b2 100644
--- a/include/zh_aht.h
+++ b/include/zh_aht.h
@@ -33,6 +33,12 @@ extern "C"
 {
 #endif
 
+    /**
+     * @brief Opaque handle for AHT sensor driver.
+     *
+     * Incomplete type that encapsulates internal sensor state.
+     * Users interact with this handle exclusively through the public API functions.c
+     */
     typedef struct _zh_aht_handle_t zh_aht_handle_t;
 
     /**