Migrate to new swagger docs generation (#18)

pkg/models/team_namespace_readall.go

@@ -1,6 +1,19 @@
 package models
 
 // ReadAll implements the method to read all teams of a namespace
+// @Summary Get teams on a namespace
+// @Description Returns a namespace with all teams which have access on a given namespace.
+// @tags sharing
+// @Accept json
+// @Produce json
+// @Param id path int true "Namespace 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 the right they have."
+// @Failure 403 {object} models.HTTPError "No right to see the namespace."
+// @Failure 500 {object} models.Message "Internal error"
+// @Router /namespaces/{id}/teams [get]
 func (tn *TeamNamespace) ReadAll(search string, user *User, page int) (interface{}, error) {
 	// Check if the user can read the namespace
 	n, err := GetNamespaceByID(tn.NamespaceID)
@@ -12,7 +25,7 @@ func (tn *TeamNamespace) ReadAll(search string, user *User, page int) (interface
 	}
 
 	// Get the teams
-	all := []*teamWithRight{}
+	all := []*TeamWithRight{}
 
 	err = x.Table("teams").
 		Join("INNER", "team_namespaces", "team_id = teams.id").