general pass of README cleanup

example/README.md

@@ -20,14 +20,6 @@ It's already checked in to github, but to generate `generated.go`:
 go generate ./...
 ```
 
-## Generating the schema files
+## Generating the schema file
 
-These are also checked in, but to update them:
-
-```sh
-npm install -g graphql-introspection-json-to-sdl
-curl -H "Authorization: bearer <your token>" https://api.github.com/graphql >example/schema.json
-graphql-introspection-json-to-sdl example/schema.json >example/schema.graphql
-```
-
-TODO: something better
+The schema file is also checked in, but to update it, download from the [GitHub API documentation](https://docs.github.com/en/graphql/overview/public-schema).