improved report card

example/example.go

@@ -4,6 +4,7 @@ import "context"
 
 //go:generate moq -out mockpersonstore_test.go . PersonStore
 
+// Person represents a real person.
 type Person struct {
 	ID      string
 	Name    string
@@ -11,6 +12,7 @@ type Person struct {
 	Website string
 }
 
+// PersonStore provides access to Person objects.
 type PersonStore interface {
 	Get(ctx context.Context, id string) (*Person, error)
 	Create(ctx context.Context, person *Person, confirm bool) error

generate/generate.go

@@ -5,6 +5,7 @@ package generate
 
 //go:generate moq -out generated.go . MyInterface
 
+// MyInterface is a test interface.
 type MyInterface interface {
 	One() bool
 	Two() int