diff --git a/include/libhal-expander/tla2528.hpp b/include/libhal-expander/tla2528.hpp
index ee10f74..19ce2b7 100644
--- a/include/libhal-expander/tla2528.hpp
+++ b/include/libhal-expander/tla2528.hpp
@@ -78,7 +78,7 @@ class tla2528
    * @brief read digital output state register of an output pin
    *
    * @param p_channel pin you would like to get the ouput value
-   * @return if the pin's output value register is high If a pin is not set to
+   * @return true if the pin's output value register is high. If a pin is not set to
    * output pin the returned state will be used once it changes to an output
    * pin.
    * @throws hal::argument_out_of_domain - if p_channel out of range (>7)
@@ -98,7 +98,7 @@ class tla2528
   /**
    * @brief read the digital level of a pins
    *
-   * @return if the pin's digital read value is high. If a pin is not set to
+   * @return true if the pin's digital read value is high. If a pin is not set to
    * digital input or output the returned value may not correlate with the true
    * value.
    * @throws hal::argument_out_of_domain - if p_channel out of range. (>7)