docs(): update to generating sdl, add accessing schema section

Author: kamilmysliwiec

content/graphql/quick-start.md

@@ -171,6 +171,16 @@ definitionsFactory.generate({
 
 A fully working schema first sample is available [here](https://github.com/nestjs/nest/tree/master/sample/12-graphql-schema-first).
 
+#### Accessing generated schema
+
+To access the generated schema (in either code first or schema first approach), use the `GraphQLHost` class:
+
+```typescript
+const { schema } = app.get(GraphQLSchemaHost);
+```
+
+> info **Hint** Make sure to call the `GraphQLSchemaHost#schema` getter when the application is already initialized (after the `onModuleInit` hook triggered by either `app.listen()` or `app.init()` method.
+
 #### Async configuration
 
 When you need to pass module options asynchronously instead of statically, use the `forRootAsync()` method. As with most dynamic modules, Nest provides several techniques to deal with async configuration.

content/graphql/schema-generator.md

@@ -1,8 +1,8 @@
-### Schema generator
+### Generating SDL
 
 ##### This chapter applies only to code first approach
 
-To manually build (without running an application) a GraphQL schema, use the `GraphQLSchemaBuilderModule`.
+To manually generate (without running an application, connecting to the database, hooking up resolvers, etc.) a GraphQL SDL, use the `GraphQLSchemaBuilderModule`.
 
 ```typescript
 async function generateSchema() {

src/app/homepage/menu/menu.component.ts

@@ -114,7 +114,7 @@ export class MenuComponent implements OnInit {
         { title: 'Unions', path: '/graphql/unions' },
         { title: 'Enums', path: '/graphql/enums' },
         { title: 'Mapped types', path: '/graphql/mapped-types' },
-        { title: 'Schema generator', path: '/graphql/schema-generator' },
+        { title: 'Generating SDL', path: '/graphql/generating-sdl' },
         {
           title: 'Other features',
           path: '/graphql/tooling',

src/app/homepage/pages/graphql/graphql.module.ts

@@ -92,9 +92,9 @@ const routes: Routes = [
     data: { title: 'GraphQL + TypeScript - Mapped types' },
   },
   {
-    path: 'schema-generator',
+    path: 'generating-sdl',
     component: SchemaGeneratorComponent,
-    data: { title: 'GraphQL + TypeScript - Schema generator' },
+    data: { title: 'GraphQL + TypeScript - Generating SDL' },
   },
 ];