refactor!: Pass repository creation by value

README.md

@@ -341,15 +341,16 @@ recommended when making requests using short-lived credentials such as a
 
 ### Creating and Updating Resources ###
 
-All structs for GitHub resources use pointer values for all non-repeated fields.
-This allows distinguishing between unset fields and those set to a zero-value.
+Many resource and request structs use pointers for optional scalar fields. This
+allows distinguishing between unset fields and those set to a zero-value.
+Required fields such as `CreateRepositoryRequest.Name` use value types.
 Use the `new` builtin to easily create these pointers for string,
 bool, and int values. For example:
 
 ```go
 // create a new private repository named "foo"
-repo := &github.Repository{
-	Name:    new("foo"),
+repo := github.CreateRepositoryRequest{
+	Name:    "foo",
 	Private: new(true),
 }
 client.Repositories.Create(ctx, "", repo)

example/newrepo/main.go

@@ -41,7 +41,7 @@ func main() {
 		log.Fatal(err)
 	}
 
-	r := &github.Repository{Name: name, Private: private, Description: description, AutoInit: autoInit}
+	r := github.CreateRepositoryRequest{Name: *name, Private: private, Description: description, AutoInit: autoInit}
 	repo, _, err := client.Repositories.Create(ctx, "", r)
 	if err != nil {
 		log.Fatal(err)

github/doc.go

@@ -169,14 +169,15 @@ https://docs.github.com/rest/using-the-rest-api/best-practices-for-using-the-res
 
 # Creating and Updating Resources
 
-All structs for GitHub resources use pointer values for all non-repeated fields.
-This allows distinguishing between unset fields and those set to a zero-value.
+Many resource and request structs use pointers for optional scalar fields. This
+allows distinguishing between unset fields and those set to a zero-value.
+Required fields such as [CreateRepositoryRequest.Name] use value types.
 Use the new builtin to easily create these pointers for string,
 bool, and int values. For example:
 
 	// create a new private repository named "foo"
-	repo := &github.Repository{
-		Name:    new("foo"),
+	repo := github.CreateRepositoryRequest{
+		Name:    "foo",
 		Private: new(true),
 	}
 	client.Repositories.Create(ctx, "", repo)