style: updated comments

README.md

@@ -14,10 +14,10 @@
 
 ## Features
 
-1. Support of AHT10/AHT15/AHT20/AHT21/AHT25/AHT30/AHT40
+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)
+2. Support multiple sensors on one device with [zh_pca9548a](https://github.com/aZholtikov/zh_pca9548a).
-3. CRC8 data integrity verification
+3. CRC8 data integrity verification.
-4. Error statistics tracking
+4. Error statistics tracking.
 
 ## Using
 

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;
 
     /**