diff --git a/pkg/apis/resources/v1alpha2/register.go b/pkg/apis/resources/v1alpha2/register.go
index c78ca754cf2a778b0340c41e4bfdf2e0eb4ce162..bd4dd0c94c8a48cf1612960bc211cc57ff0a06ed 100644
--- a/pkg/apis/resources/v1alpha2/register.go
+++ b/pkg/apis/resources/v1alpha2/register.go
@@ -187,18 +187,18 @@ func addWebService(c *restful.Container) error {
 	webservice.Route(webservice.GET("/components").
 		To(components.GetComponents).
 		Metadata(restfulspec.KeyOpenAPITags, tags).
-		Doc("").
+		Doc("List the system components.").
 		Returns(http.StatusOK, ok, map[string]models.Component{}))
 	webservice.Route(webservice.GET("/components/{component}").
 		To(components.GetComponentStatus).
 		Metadata(restfulspec.KeyOpenAPITags, tags).
-		Doc("").
+		Doc("Describe the specified system component.").
 		Param(webservice.PathParameter("component", "component name")).
 		Returns(http.StatusOK, ok, models.Component{}))
 	webservice.Route(webservice.GET("/componenthealth").
 		To(components.GetSystemHealthStatus).
 		Metadata(restfulspec.KeyOpenAPITags, tags).
-		Doc("").
+		Doc("Get the health status of system components.").
 		Returns(http.StatusOK, ok, map[string]int{}))
 
 	tags = []string{"Quotas"}