Minor docs clarifications

Author: Stephen Barlow

docs/source/graphs.md

@@ -4,7 +4,9 @@ sidebar_title: 'graph'
 description: 'Publish and retrieve your API schema'
 ---
 
-> These commands are for graphs that do _not_ use [federation](https://www.apollographql.com/docs/federation/). When working with a federated graph, instead use the [`subgraph` comamand](./subgraphs).
+These Rover commands are _primarily_ for interacting with monolithic graphs that do _not_ use [federation](https://www.apollographql.com/docs/federation/). However, you can also use [`rover graph introspect`](#fetching-via-introspection) to fetch a federated gateway's API schema.
+
+When interacting directly with with a federated subgraph, instead use [`subgraph` commands](./subgraphs).
 
 ## Fetching a schema
 
@@ -26,7 +28,7 @@ The argument `my-graph@my-variant` in the example above specifies the ID of the
 
 ### Fetching via introspection
 
-If you need to obtain a running GraphQL server's schema, you can use Rover to execute an introspection query on it. This is especially helpful if you're developing a GraphQL server that _doesn't_ define its schema via SDL, such as [`graphql-kotlin`](https://github.com/ExpediaGroup/graphql-kotlin).
+If you need to obtain the schema of a running GraphQL server or federated gateway, you can use Rover to execute an introspection query on it. This is especially helpful if you're developing a GraphQL server that _doesn't_ define its schema via SDL, such as [`graphql-kotlin`](https://github.com/ExpediaGroup/graphql-kotlin).
 
 Use the `graph introspect` command, like so:
 

docs/source/migration.md

@@ -265,7 +265,7 @@ apollo service:push --serviceName users
 
 ## Rover ##
 # (no config file needed)
-# globs don't work natively with Rover, so you can use `cat` to combine
-# multiple files on *nix machines
-cat *.graphql | rover subgraph publish my-graph@prod --name users --schema -
+# globs don't work natively with Rover, so you can use a command like `awk 1`
+# to combine multiple files on *nix machines
+awk 1 *.graphql | rover subgraph publish my-graph@prod --name users --schema -
 ```