documentation ...

routers/api/v1/repo/issue.go

@@ -211,7 +211,7 @@ func ListIssues(ctx *context.APIContext) {
 	//   type: string
 	// - name: milestones
 	//   in: query
-	//   description:  comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded
+	//   description: comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded
 	//   type: string
 	// - name: page
 	//   in: query
@@ -259,6 +259,8 @@ func ListIssues(ctx *context.APIContext) {
 	var mileIDs []int64
 	if part := strings.Split(ctx.Query("milestones"), ","); len(part) > 0 {
 		for i := range part {
+			// uses names and fall back to ids
+			// non existent milestones are discarded
 			mile, err := models.GetMilestoneByRepoIDANDName(ctx.Repo.Repository.ID, part[i])
 			if err == nil {
 				mileIDs = append(mileIDs, mile.ID)