diff --git a/api/v3/api_proto/issue_objects.proto b/api/v3/api_proto/issue_objects.proto
index 4f31aaf..790ea4b 100644
--- a/api/v3/api_proto/issue_objects.proto
+++ b/api/v3/api_proto/issue_objects.proto
@@ -156,7 +156,7 @@
   // A possibly rule-derived component for the issue.
   // Next available tag: 3
   message ComponentValue {
-    // The component.
+    // AIP resource name of the component.
     string component = 1 [
       (google.api.resource_reference) = { type: "api.crbug.com/ComponentDef" }
     ];
diff --git a/api/v3/api_proto/project_objects.proto b/api/v3/api_proto/project_objects.proto
index 21f4bc6..39c5517 100644
--- a/api/v3/api_proto/project_objects.proto
+++ b/api/v3/api_proto/project_objects.proto
@@ -317,7 +317,7 @@
   // the API will always return ComponentDef names with format:
   // projects/{project}/componentDefs/<component_def_id>.
   // However the API will accept ComponentDef names with formats:
-  // projects/{project}/componentDefs/<component_def_id>|<value>.
+  // projects/{project}/componentDefs/<component_def_id|value>.
   string name = 1;
   // String value of the component, ie 'Tools>Stability' or 'Blink'.
   string value = 2;