diff --git a/libfwupd/fwupd-enums.h b/libfwupd/fwupd-enums.h
index e97814581..ccc0a9f13 100644
--- a/libfwupd/fwupd-enums.h
+++ b/libfwupd/fwupd-enums.h
@@ -864,7 +864,7 @@ typedef enum {
  * @FWUPD_KEYRING_KIND_PKCS7:			Verification using PKCS7
  * @FWUPD_KEYRING_KIND_JCAT:			Verification using Jcat
  *
- * The update state.
+ * Type of keyring used on a remote.
  **/
 typedef enum {
 	FWUPD_KEYRING_KIND_UNKNOWN, /* Since: 0.9.7 */
diff --git a/libfwupd/fwupd-release.c b/libfwupd/fwupd-release.c
index e61edc2b5..1fa9d7a4a 100644
--- a/libfwupd/fwupd-release.c
+++ b/libfwupd/fwupd-release.c
@@ -1269,7 +1269,7 @@ fwupd_release_get_license(FwupdRelease *self)
 /**
  * fwupd_release_set_license:
  * @self: a #FwupdRelease
- * @license: (nullable): the description
+ * @license: (nullable): the update license.
  *
  * Sets the update license.
  *
@@ -1310,7 +1310,7 @@ fwupd_release_get_name(FwupdRelease *self)
 /**
  * fwupd_release_set_name:
  * @self: a #FwupdRelease
- * @name: (nullable): the description
+ * @name: (nullable): the update name.
  *
  * Sets the update name.
  *