Improve PullReview docs (#469)

document some PullReview fields

code review

Co-authored-by: Norwin Roosen <[email protected]>
Co-authored-by: Lunny Xiao <[email protected]>
Co-authored-by: 6543 <[email protected]>
Reviewed-on: https://gitea.com/gitea/go-sdk/pulls/469
Reviewed-by: 6543 <[email protected]>
Reviewed-by: Lunny Xiao <[email protected]>
Co-Authored-By: Norwin <[email protected]>
Co-Committed-By: Norwin <[email protected]>

Author: 4 people

gitea/pull_review.go

@@ -33,15 +33,17 @@ const (
 
 // PullReview represents a pull request review
 type PullReview struct {
-	ID                int64           `json:"id"`
-	Reviewer          *User           `json:"user"`
-	State             ReviewStateType `json:"state"`
-	Body              string          `json:"body"`
-	CommitID          string          `json:"commit_id"`
-	Stale             bool            `json:"stale"`
-	Official          bool            `json:"official"`
-	CodeCommentsCount int             `json:"comments_count"`
-	Submitted         time.Time       `json:"submitted_at"`
+	ID       int64           `json:"id"`
+	Reviewer *User           `json:"user"`
+	State    ReviewStateType `json:"state"`
+	Body     string          `json:"body"`
+	CommitID string          `json:"commit_id"`
+	// Stale indicates if the pull has changed since the review
+	Stale bool `json:"stale"`
+	// Official indicates if the review counts towards the required approval limit, if PR base is a protected branch
+	Official          bool      `json:"official"`
+	CodeCommentsCount int       `json:"comments_count"`
+	Submitted         time.Time `json:"submitted_at"`
 
 	HTMLURL     string `json:"html_url"`
 	HTMLPullURL string `json:"pull_request_url"`