Clarify owner and parent field descriptions in response/request models

modules/structs/issue.go

@@ -37,6 +37,7 @@ type PullRequestMeta struct {
 type RepositoryMeta struct {
 	ID   int64  `json:"id"`
 	Name string `json:"name"`
+	// username of the user or organization owning the repository
 	Owner    string `json:"owner"`
 	FullName string `json:"full_name"`
 }
@@ -264,6 +265,7 @@ func (it IssueTemplate) Type() IssueTemplateType {
 type IssueMeta struct {
 	Index int64  `json:"index"`
 	Owner string `json:"owner"`
+	// name of the repo
 	Name string `json:"repo"`
 }
 

modules/structs/issue_stopwatch.go

@@ -15,6 +15,7 @@ type StopWatch struct {
 	Duration   string    `json:"duration"`
 	IssueIndex int64     `json:"issue_index"`
 	IssueTitle string    `json:"issue_title"`
+	// username of the user or organization owning the repository
 	RepoOwnerName string `json:"repo_owner_name"`
 	RepoName      string `json:"repo_name"`
 }

modules/structs/package.go

@@ -10,6 +10,7 @@ import (
 // Package represents a package
 type Package struct {
 	ID int64 `json:"id"`
+	// username of the user or organization owning the package
 	Owner      *User       `json:"owner"`
 	Repository *Repository `json:"repository"`
 	Creator    *User       `json:"creator"`

modules/structs/repo.go

@@ -49,6 +49,7 @@ type ExternalWiki struct {
 // Repository represents a repository
 type Repository struct {
 	ID int64 `json:"id"`
+	// username of the user or organization owning the repository
 	Owner       *User  `json:"owner"`
 	Name        string `json:"name"`
 	FullName    string `json:"full_name"`
@@ -57,6 +58,7 @@ type Repository struct {
 	Private     bool   `json:"private"`
 	Fork        bool   `json:"fork"`
 	Template    bool   `json:"template"`
+	// the original repository if the repository in the parameter is a fork; else empty
 	Parent        *Repository `json:"parent"`
 	Mirror        bool        `json:"mirror"`
 	Size          int         `json:"size"`
@@ -228,11 +230,11 @@ type EditRepoOption struct {
 // GenerateRepoOption options when creating repository using a template
 // swagger:model
 type GenerateRepoOption struct {
-	// The organization or person who will own the new repository
+	// username of the user or organization who will own the repository
 	//
 	// required: true
 	Owner string `json:"owner"`
-	// Name of the repository to create
+	// name of the repository to create
 	//
 	// required: true
 	// unique: true
@@ -293,6 +295,7 @@ type UpdateBranchRepoOption struct {
 // TransferRepoOption options when transfer a repository's ownership
 // swagger:model
 type TransferRepoOption struct {
+	// username of the user or organization who will own the repository
 	// required: true
 	NewOwner string `json:"new_owner"`
 	// ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories.
@@ -354,8 +357,9 @@ type MigrateRepoOptions struct {
 	CloneAddr string `json:"clone_addr" binding:"Required"`
 	// deprecated (only for backwards compatibility)
 	RepoOwnerID int64 `json:"uid"`
-	// Name of User or Organisation who will own Repo after migration
+	// username of the user or organization who will own the repository after migration
 	RepoOwner string `json:"repo_owner"`
+	// name of the repo
 	// required: true
 	RepoName string `json:"repo_name" binding:"Required;AlphaDashDot;MaxSize(100)"`
 

modules/structs/user_key.go

@@ -17,6 +17,7 @@ type PublicKey struct {
 	// swagger:strfmt date-time
 	Created time.Time `json:"created_at"`
 	Updated time.Time `json:"last_used_at"`
+	// username of the user or organization owning the key
 	Owner    *User  `json:"user,omitempty"`
 	ReadOnly bool   `json:"read_only,omitempty"`
 	KeyType  string `json:"key_type,omitempty"`