diff --git a/src/easy/easy.hpp b/src/easy/easy.hpp
index e947bca..ede4aad 100644
--- a/src/easy/easy.hpp
+++ b/src/easy/easy.hpp
@@ -120,7 +120,7 @@ namespace Easy
      *
      *  @param  streamdata  Data from get_stream()
      *
-     *  @return vector of stream events
+     *  @return vector of Easy::stream_event
      *
      *  @since  before 0.11.0
      */
diff --git a/src/easy/entity.hpp b/src/easy/entity.hpp
index 94eabcf..33058b6 100644
--- a/src/easy/entity.hpp
+++ b/src/easy/entity.hpp
@@ -90,9 +90,9 @@ namespace Easy
         void from_string(const string &json);
 
         /*!
-         *  @brief  Returns the JSON object of the Entity
+         *  @brief  Returns the JSON of the Entity as string.
          *
-         *  @return JSON object
+         *  @return JSON string
          *
          *  @since  before 0.11.0
          */