diff --git a/Makefile b/Makefile
index d114b6f..d40b680 100644
--- a/Makefile
+++ b/Makefile
@@ -30,7 +30,7 @@ clean: ## Delete intermediate build artifacts
 test: build ## Run unit tests
 	$(GO) test -vet=off -race -cover ./...
 	cd internal/examples/pets && $(GO) test -vet=off -race -cover ./...
-	cd internal/examples/connect+grpc && $(GO) test -vet=off -race -cover ./...
+	cd internal/examples/connect-grpc && $(GO) test -vet=off -race -cover ./...
 
 .PHONY: build
 build: generate ## Build all packages
diff --git a/internal/examples/connect+grpc/README.md b/internal/examples/connect-grpc/README.md
similarity index 100%
rename from internal/examples/connect+grpc/README.md
rename to internal/examples/connect-grpc/README.md
diff --git a/internal/examples/connect+grpc/cmd/client/main.go b/internal/examples/connect-grpc/cmd/client/main.go
similarity index 100%
rename from internal/examples/connect+grpc/cmd/client/main.go
rename to internal/examples/connect-grpc/cmd/client/main.go
diff --git a/internal/examples/connect+grpc/cmd/server/main.go b/internal/examples/connect-grpc/cmd/server/main.go
similarity index 100%
rename from internal/examples/connect+grpc/cmd/server/main.go
rename to internal/examples/connect-grpc/cmd/server/main.go
diff --git a/internal/examples/pets/internal/gen/io/swagger/petstore/v2/pets.pb.go b/internal/examples/pets/internal/gen/io/swagger/petstore/v2/pets.pb.go
index 726fc72..aab59b6 100644
--- a/internal/examples/pets/internal/gen/io/swagger/petstore/v2/pets.pb.go
+++ b/internal/examples/pets/internal/gen/io/swagger/petstore/v2/pets.pb.go
@@ -18,6 +18,16 @@
 // 	protoc        (unknown)
 // source: io/swagger/petstore/v2/pets.proto
 
+// The service defined herein comes from v2 of the Petstore service, which
+// is used as an example for Swagger/OpenAPI. The Swagger spec can be found
+// here: https://petstore.swagger.io/v2/swagger.json
+// A human-friendly HTML view of this API is also available at
+// https://petstore.swagger.io.
+//
+// This file defines only the "pet" service. The spec for this site also
+// includes "store" and "user" services which are not supported via these
+// RPC definitions.
+
 package petstorev2
 
 import (
diff --git a/internal/examples/pets/internal/gen/io/swagger/petstore/v2/petstorev2connect/pets.connect.go b/internal/examples/pets/internal/gen/io/swagger/petstore/v2/petstorev2connect/pets.connect.go
index 8c97a8c..0b751bc 100644
--- a/internal/examples/pets/internal/gen/io/swagger/petstore/v2/petstorev2connect/pets.connect.go
+++ b/internal/examples/pets/internal/gen/io/swagger/petstore/v2/petstorev2connect/pets.connect.go
@@ -16,6 +16,15 @@
 //
 // Source: io/swagger/petstore/v2/pets.proto
 
+// The service defined herein comes from v2 of the Petstore service, which
+// is used as an example for Swagger/OpenAPI. The Swagger spec can be found
+// here: https://petstore.swagger.io/v2/swagger.json
+// A human-friendly HTML view of this API is also available at
+// https://petstore.swagger.io.
+//
+// This file defines only the "pet" service. The spec for this site also
+// includes "store" and "user" services which are not supported via these
+// RPC definitions.
 package petstorev2connect
 
 import (
diff --git a/internal/examples/pets/internal/proto/io/swagger/petstore/v2/pets.proto b/internal/examples/pets/internal/proto/io/swagger/petstore/v2/pets.proto
index 88ca59e..91bd85d 100644
--- a/internal/examples/pets/internal/proto/io/swagger/petstore/v2/pets.proto
+++ b/internal/examples/pets/internal/proto/io/swagger/petstore/v2/pets.proto
@@ -14,6 +14,15 @@
 
 syntax = "proto3";
 
+// The service defined herein comes from v2 of the Petstore service, which
+// is used as an example for Swagger/OpenAPI. The Swagger spec can be found
+// here: https://petstore.swagger.io/v2/swagger.json
+// A human-friendly HTML view of this API is also available at
+// https://petstore.swagger.io.
+//
+// This file defines only the "pet" service. The spec for this site also
+// includes "store" and "user" services which are not supported via these
+// RPC definitions.
 package io.swagger.petstore.v2;
 
 import "google/api/annotations.proto";