docs: consider updating to gatsby 3

[EverlastingBugstopper]

Gatsby 2 has exited its maintenance window and is only receiving critical security updates - I imagine we'd want to update across each of the different netlify docsets across apollo, but it's quite possible we could do these updates piece by piece.

For quick reference, the migration guide can be found here

[lorensr]

This would fix #1164.

When I update this repo to Gatsby v3, I get these errors (after switching to minimum Node 12):

warn Plugin gatsby-plugin-emotion is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-plugin-react-helmet is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-plugin-less is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-theme-apollo-core is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.13.80 warn Plugin gatsby-source-filesystem is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.2.0 warn Plugin gatsby-transformer-remark is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.12.0 warn Plugin gatsby-plugin-google-gtag is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-theme-apollo-docs is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.13.80 warn Plugin gatsby-remark-autolink-headers is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-remark-copy-linked-files is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-remark-prismjs is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-plugin-emotion is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-plugin-react-helmet is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-plugin-less is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-theme-apollo-core is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.13.80 warn Plugin gatsby-source-filesystem is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.2.0 warn Plugin gatsby-remark-autolink-headers is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-remark-copy-linked-files is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-remark-prismjs is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-transformer-remark is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.12.0 warn Plugin gatsby-plugin-google-gtag is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.0.0 warn Plugin gatsby-theme-apollo-docs is not compatible with your gatsby version 3.6.1 - It requires gatsby@^2.13.80 success load plugins - 1.605s success onPreInit - 0.035s success initialize cache - 0.009s success copy gatsby files - 0.121s success onPreBootstrap - 0.021s success createSchemaCustomization - 0.257s warn code block or inline code language not specified in markdown. applying generic code block success Checking for changed pages - 0.002s success source and transform nodes - 3.027s success building schema - 0.472s success createPages - 0.087s success createPagesStatefully - 0.053s info Total nodes: 178, SitePage nodes: 23 (use --verbose for breakdown) success Checking for changed pages - 0.001s success update schema - 0.087s success write out redirect data - 0.001s success onPostBootstrap - 0.001s info bootstrap finished - 9.019s success onPreExtractQueries - 0.001s success extract queries from components - 0.396s success write out requires - 0.007s success run static queries - 0.014s - 2/2 146.14/s success run page queries - 0.685s - 3/3 4.38/s

ERROR

Invalid configuration object. Webpack has been initialized using a configuration object that does not match the API schema.

• configuration.module.rules[11] should be one of these:
  ["..." | object { compiler?, dependency?, descriptionData?, enforce?, exclude?, generator?, include?, issuer?, issuerLayer?, layer?,
  loader?, mimetype?, oneOf?, options?, parser?, realResource?, resolve?, resource?, resourceFragment?, resourceQuery?, rules?, scheme?,
  sideEffects?, test?, type?, use? }, ...]
  -> A rule.
  Details:
  • configuration.module.rules[10].issuer has an unknown property 'test'. These properties are valid:
    object { and?, not?, or? }
    -> Logic operators used in a condition matcher.
  • configuration.module.rules[11].issuer has an unknown property 'test'. These properties are valid:
    object { and?, not?, or? }
    -> Logic operators used in a condition matcher.

ValidationError: Invalid configuration object. Webpack has been initialized using a configuration object that does not match the API schema.

• configuration.module.rules[11] should be one of these:
  ["..." | object { compiler?, dependency?, descriptionData?, enforce?, exclude?, generator?, include?, issuer?, issuerLayer?, layer?, load
  er?, mimetype?, oneOf?, options?, parser?, realResource?, resolve?, resource?, resourceFragment?, resourceQuery?, rules?, scheme?, sideEffec
  ts?, test?, type?, use? }, ...]
  -> A rule.
  Details:

  • configuration.module.rules[10].issuer has an unknown property 'test'. These properties are valid:
    object { and?, not?, or? }
    -> Logic operators used in a condition matcher.
  • configuration.module.rules[11].issuer has an unknown property 'test'. These properties are valid:
    object { and?, not?, or? }
    -> Logic operators used in a condition matcher.

• validate.js:104 validate
  [docs]/[webpack]/[schema-utils]/dist/validate.js:104:11

• validateSchema.js:78 validateSchema
  [docs]/[webpack]/lib/validateSchema.js:78:2

• webpack.js:109 create
  [docs]/[webpack]/lib/webpack.js:109:24

• webpack.js:151 webpack
  [docs]/[webpack]/lib/webpack.js:151:32

• index.js:55 f
  [docs]/[webpack]/lib/index.js:55:16

• build-html.ts:67
  [docs]/[gatsby]/src/commands/build-html.ts:67:24

• debuggability.js:384 Promise._execute
  [docs]/[bluebird]/js/release/debuggability.js:384:9

• promise.js:518 Promise._resolveFromExecutor
  [docs]/[bluebird]/js/release/promise.js:518:18

• promise.js:103 new Promise
  [docs]/[bluebird]/js/release/promise.js:103:10

• build-html.ts:65 runWebpack
  [docs]/[gatsby]/src/commands/build-html.ts:65:3

• build-html.ts:142 doBuildRenderer
  [docs]/[gatsby]/src/commands/build-html.ts:142:49

• build-html.ts:179 buildRenderer
  [docs]/[gatsby]/src/commands/build-html.ts:179:10

• start-server.ts:114 createIndexHtml
  [docs]/[gatsby]/src/utils/start-server.ts:114:32

• start-server.ts:152 startServer
  [docs]/[gatsby]/src/utils/start-server.ts:152:5

• start-webpack-server.ts:44 startWebpackServer
  [docs]/[gatsby]/src/services/start-webpack-server.ts:44:7

https://github.com/lorensr/apollo/tree/gatsby-v3