diff --git a/pkg/apis/devops/v1alpha2/register.go b/pkg/apis/devops/v1alpha2/register.go
index ce33e581c6652681d151d6b28aef5b43be70223a..e3047d5197c9079384d425fd23bed01b80e7176d 100644
--- a/pkg/apis/devops/v1alpha2/register.go
+++ b/pkg/apis/devops/v1alpha2/register.go
@@ -111,6 +111,7 @@ func addWebService(c *restful.Container) error {
 		Metadata(restfulspec.KeyOpenAPITags, tags).
 		Param(webservice.PathParameter("devops", "DevOps Project's Id, e.g. project-RRRRAzLBlLEm")).
 		Param(webservice.PathParameter("member", "Member's username, e.g. admin")).
+		Returns(http.StatusOK, RespOK, devops.DevOpsProjectMembership{}).
 		Reads(devops.DevOpsProjectMembership{}).
 		Writes(devops.DevOpsProjectMembership{}))
 
@@ -137,7 +138,6 @@ func addWebService(c *restful.Container) error {
 		Param(webservice.PathParameter("devops", "DevOps Project's Id, e.g. project-RRRRAzLBlLEm")).
 		Param(webservice.PathParameter("pipeline", "The name of pipeline, e.g. sample-pipeline")).
 		Metadata(restfulspec.KeyOpenAPITags, tags).
-		Returns(http.StatusOK, RespOK, devops.ProjectPipeline{}).
 		Writes(devops.ProjectPipeline{}).
 		Reads(devops.ProjectPipeline{}))
 
diff --git a/pkg/apis/resources/v1alpha2/register.go b/pkg/apis/resources/v1alpha2/register.go
index c78ca754cf2a778b0340c41e4bfdf2e0eb4ce162..76f308ddf124fb63e434ae8b0f63c72cfcaaf5f0 100644
--- a/pkg/apis/resources/v1alpha2/register.go
+++ b/pkg/apis/resources/v1alpha2/register.go
@@ -227,11 +227,11 @@ func addWebService(c *restful.Container) error {
 		Returns(http.StatusOK, ok, errors.Error{}))
 
 	tags = []string{"Git"}
-	webservice.Route(webservice.POST("/git/readverify").
+	webservice.Route(webservice.POST("git/verify").
 		To(
 			git.GitReadVerify).
 		Metadata(restfulspec.KeyOpenAPITags, tags).
-		Doc("secret git read verify").
+		Doc("Verify that the kubernetes secret has read access to the git repository").
 		Reads(gitmodel.AuthInfo{}).
 		Returns(http.StatusOK, ok, errors.Error{}),
 	)
diff --git a/pkg/models/devops/common.go b/pkg/models/devops/common.go
index f2c51ed072d7e2973d71ef17a6099ee1655e5c51..f515c775c42515954fff2c10d2ea0226e09f138f 100644
--- a/pkg/models/devops/common.go
+++ b/pkg/models/devops/common.go
@@ -79,7 +79,7 @@ const (
 )
 
 type Role struct {
-	Name        string `json:"name" description:"role's name'"`
+	Name        string `json:"name" description:"role's name e.g. owner'"`
 	Description string `json:"description" description:"role 's description'"`
 }