Migrate to new swagger docs generation (#18)

pkg/models/team_list_readall.go

@@ -1,6 +1,19 @@
 package models
 
 // ReadAll implements the method to read all teams of a list
+// @Summary Get teams on a list
+// @Description Returns a list with all teams which have access on a given list.
+// @tags sharing
+// @Accept json
+// @Produce json
+// @Param id path int true "List ID"
+// @Param p query int false "The page number. Used for pagination. If not provided, the first page of results is returned."
+// @Param s query string false "Search teams by its name."
+// @Security ApiKeyAuth
+// @Success 200 {array} models.TeamWithRight "The teams with their right."
+// @Failure 403 {object} models.HTTPError "No right to see the list."
+// @Failure 500 {object} models.Message "Internal error"
+// @Router /lists/{id}/teams [get]
 func (tl *TeamList) ReadAll(search string, u *User, page int) (interface{}, error) {
 	// Check if the user can read the namespace
 	l := &List{ID: tl.ListID}
@@ -12,7 +25,7 @@ func (tl *TeamList) ReadAll(search string, u *User, page int) (interface{}, erro
 	}
 
 	// Get the teams
-	all := []*teamWithRight{}
+	all := []*TeamWithRight{}
 	err := x.
 		Table("teams").
 		Join("INNER", "team_list", "team_id = teams.id").