Review comments

I didn't rename Reference yet, since I want to think about that a little
more.

generate/traverse.go → generate/convert.go

@@ -2,9 +2,9 @@ package generate
 
 // This file implements the core type-generation logic of genqlient, whereby we
 // traverse an operation-definition (and the schema against which it will be
-// executed), and decide what Go types to generate for that operation.  It
-// returns data structures representing the types to be generated; these are
-// defined, and converted into code, in types.go.
+// executed), and convert that into Go types.  It returns data structures
+// representing the types to be generated; these are defined, and converted
+// into code, in types.go.
 //
 // The entrypoints are convertOperation, which builds the response-type for a
 // query, and convertInputType, which builds the argument-types.
@@ -84,7 +84,6 @@ var builtinTypes = map[string]string{
 func (g *generator) typeName(prefix string, typ *ast.Definition) (name, nextPrefix string) {
 	typeGoName := upperFirst(typ.Name)
 	if typ.Kind == ast.Enum || typ.Kind == ast.InputObject {
-		// STOPSHIP: hopefully inline this
 		// If we're an enum or an input-object, there is only one type we
 		// will ever possibly generate for this type, so we don't need any
 		// of the qualifiers.  This is especially helpful because the

generate/generate.go

@@ -237,7 +237,7 @@ func Generate(config *Config) (map[string][]byte, error) {
 
 	// Step 2: For each operation, convert it into data structures representing
 	// Go types (defined in types.go).  The bulk of this logic is in
-	// traverse.go.
+	// convert.go.
 	g := newGenerator(config, schema)
 	for _, op := range document.Operations {
 		if err = g.addOperation(op); err != nil {

generate/types.go

@@ -2,7 +2,7 @@ package generate
 
 // This file defines the data structures from which genqlient generates types,
 // and the code to write them out as actual Go code.  The main entrypoint is
-// goType, which represents such a type, but traverse.go also constructs each
+// goType, which represents such a type, but convert.go also constructs each
 // of the implementing types, by traversing the GraphQL operation and schema.
 
 import (