diff --git a/include/cglm/vec3.h b/include/cglm/vec3.h
index c53c8ab..e67cc2f 100644
--- a/include/cglm/vec3.h
+++ b/include/cglm/vec3.h
@@ -428,8 +428,8 @@ glm_vec3_maxadd(vec3 a, vec3 b, vec3 dest) {
  *
  * it applies += operator so dest must be initialized
  *
- * @param[in]  a    vector
- * @param[in]  b    scalar
+ * @param[in]  a    vector 1
+ * @param[in]  b    vector 2
  * @param[out] dest dest += min(a, b)
  */
 CGLM_INLINE
diff --git a/include/cglm/vec4.h b/include/cglm/vec4.h
index bbd1c31..b94cf61 100644
--- a/include/cglm/vec4.h
+++ b/include/cglm/vec4.h
@@ -576,8 +576,8 @@ glm_vec4_maxadd(vec4 a, vec4 b, vec4 dest) {
  *
  * it applies += operator so dest must be initialized
  *
- * @param[in]  a    vector
- * @param[in]  b    scalar
+ * @param[in]  a    vector 1
+ * @param[in]  b    vector 2
  * @param[out] dest dest += min(a, b)
  */
 CGLM_INLINE