diff --git a/src/hb-common.cc b/src/hb-common.cc
index c453443e7..6db801cdd 100644
--- a/src/hb-common.cc
+++ b/src/hb-common.cc
@@ -1162,8 +1162,9 @@ hb_variation_to_string (hb_variation_t *variation,
 
 /**
  * hb_color_get_alpha:
+ * color: a #hb_color_t we are interested in its channels.
  *
- *
+ * Return value: Alpha channel value of the given color
  *
  * Since: REPLACEME
  */
@@ -1175,8 +1176,9 @@ uint8_t
 
 /**
  * hb_color_get_red:
+ * color: a #hb_color_t we are interested in its channels.
  *
- *
+ * Return value: Red channel value of the given color
  *
  * Since: REPLACEME
  */
@@ -1188,8 +1190,9 @@ uint8_t
 
 /**
  * hb_color_get_green:
+ * color: a #hb_color_t we are interested in its channels.
  *
- *
+ * Return value: Green channel value of the given color
  *
  * Since: REPLACEME
  */
@@ -1201,8 +1204,9 @@ uint8_t
 
 /**
  * hb_color_get_blue:
+ * color: a #hb_color_t we are interested in its channels.
  *
- *
+ * Return value: Blue channel value of the given color
  *
  * Since: REPLACEME
  */
diff --git a/src/hb-directwrite.cc b/src/hb-directwrite.cc
index d8076c922..8f2e66025 100644
--- a/src/hb-directwrite.cc
+++ b/src/hb-directwrite.cc
@@ -930,7 +930,9 @@ _hb_directwrite_font_release (void *data)
 
 /**
  * hb_directwrite_face_create:
- * @font_face:
+ * @font_face: a DirectWrite IDWriteFontFace object.
+ *
+ * Return value: #hb_face_t object corresponding to the given input
  *
  * Since: 2.4.0
  **/
@@ -945,7 +947,9 @@ hb_directwrite_face_create (IDWriteFontFace *font_face)
 
 /**
 * hb_directwrite_face_get_font_face:
-* @face:
+* @face: a #hb_face_t object
+*
+* Return value: DirectWrite IDWriteFontFace object corresponding to the given input
 *
 * Since: REPLACEME
 **/