merge master

Author: LekoArts

CODEOWNERS

@@ -23,7 +23,7 @@
   <a href="https://circleci.com/gh/gatsbyjs/gatsby">
     <img src="https://circleci.com/gh/gatsbyjs/gatsby.svg?style=shield" alt="Current CircleCI build status." />
   </a>
-  <a href="https://www.npmjs.org/package/gatsby">
+  <a href="https://www.npmjs.com/package/gatsby">
     <img src="https://img.shields.io/npm/v/gatsby.svg" alt="Current npm package version." />
   </a>
   <a href="https://npmcharts.com/compare/gatsby?minimal=true">

README.md

@@ -13,7 +13,7 @@ module.exports = {
     {
       resolve: `gatsby-plugin-mdx`,
       options: {
-        lessBabel: true,
+        // lessBabel: true,
       },
     },
   ],

benchmarks/gabe-fs-mdx/gatsby-config.js

@@ -62,6 +62,10 @@ If you need an answer right away, check out the
 [Gatsby Discord](https://gatsby.dev/discord). Community & team members are happy to help you out or point you to
 useful resources.
 
+### GitHub Discussions
+
+Directly integrated into the repository, you can use [GitHub Discussions](https://github.com/gatsbyjs/gatsby/discussions) to ask for help or share ideas.
+
 ### Hashnode
 
 Many members of the community also use Hashnode to ask questions and share their tips. Read through

docs/contributing/community.md

@@ -62,7 +62,7 @@ Now define the query and pass it to `useStaticQuery`. You can also alias query i
 
 ```jsx:title=src/components/seo.js
 const SEO = ({ title, description, image, article }) => {
-  const { location } = useLocation()
+  const { pathname } = useLocation()
   const { site } = useStaticQuery(query)
 
   return null

docs/docs/add-seo-component.md

@@ -58,7 +58,7 @@ In this guide, you will learn how to deploy your Gatsby site to Firebase Hosting
            "headers": [
              {
                "key": "cache-control",
-               "value": "cache-control: public, max-age=0, must-revalidate"
+               "value": "public, max-age=0, must-revalidate"
              }
            ]
          },
@@ -85,7 +85,7 @@ In this guide, you will learn how to deploy your Gatsby site to Firebase Hosting
            "headers": [
              {
                "key": "cache-control",
-               "value": "cache-control: public, max-age=0, must-revalidate"
+               "value": "public, max-age=0, must-revalidate"
              }
            ]
          },
@@ -94,7 +94,7 @@ In this guide, you will learn how to deploy your Gatsby site to Firebase Hosting
            "headers": [
              {
                "key": "cache-control",
-               "value": "cache-control: public, max-age=0, must-revalidate"
+               "value": "public, max-age=0, must-revalidate"
              }
            ]
          }

docs/docs/deploying-to-firebase.md

@@ -66,6 +66,8 @@ gatsby new
    (Use a different starter)
 ```
 
+_Note: you can try out the experimental interactive experience from the `create-gatsby` package with the `GATSBY_EXPERIMENTAL_GATSBY_NEW_FLOW=true` flag, which will prompt you with questions about the kind of site you're building, and install the plugins you'll need automatically._
+
 See the [Gatsby starters docs](/docs/gatsby-starters/) for more details.
 
 ### `develop`

docs/docs/gatsby-cli.md

@@ -0,0 +1,185 @@
+---
+date: "2020-11-12"
+version: "2.26.0"
+---
+
+# [v2.26](https://github.com/gatsbyjs/gatsby/compare/[email protected]@2.26.0) (November 2020)
+
+---
+
+Welcome to `[email protected]` release (November 2020).
+Key highlights of this release:
+
+- [New Image Plugin (beta)](#gatsby-plugin-image010-beta) - access static images without GraphQL, high Lighthouse scores again
+- [File System Route API](#file-system-route-api) - create routes from your data using filename conventions
+- [New Release Process](#new-release-process) - more stability and clarity around Gatsby releases
+- [gatsby-source-contentful v4.0](#gatsby-source-contentful400) - new RichText implementation, performance improvements
+
+Other notable changes:
+
+- [gatsby-plugin-mdx](#gatsby-plugin-mdx140) - performance improvements
+- [Enable compression in the dev server](#enable-compression-in-the-dev-server) - speeds up remote previews
+
+Sneak peek to next releases:
+
+- [Queries on Demand](#queries-on-demand) - improves `gatsby develop` bootup time
+- [Experimental: Lazy images in develop](#experimental-lazy-images-in-develop)
+- [Documentation Reorganization](#documentation-reorganization)
+
+**Bleeding Edge:** Want to try new features as soon as possible? Install `gatsby@next` and let us know
+if you have any [issues](https://github.com/gatsbyjs/gatsby/issues).
+
+### New Release Process
+
+We are evaluating a new process that should bring more stability and clarity
+to Gatsby releases.
+
+### File System Route API
+
+This new API enables you to create routes from your GraphQL data using filename conventions,
+e.g. to create individual blog post pages for your blog. It also allows for creating client-only routes more easily.
+
+Some examples:
+
+- `src/pages/products/{Product.name}.js` will generate pages for all products with a path like `/products/burger`
+- `src/pages/products/{Product.fields__sku}.js` will generate pages for all products with a path like `/products/001923`
+- `src/pages/users/[id].js` will generate a route like `/users/:id`
+- `src/pages/image/[...].js` will generate a route like `/image/*`
+
+See [full documentation](https://www.gatsbyjs.com/docs/file-system-route-api/),
+[examples](https://github.com/gatsbyjs/gatsby/tree/master/examples/route-api)
+and related PR [#27424](https://github.com/gatsbyjs/gatsby/pull/27424).
+
+### Enable compression in the dev server
+
+This lowers the amount of data transferred for one site especially in remote situations.
+Most of that drop was from the commons.js bundle.
+
+See PR [#27948](https://github.com/gatsbyjs/gatsby/pull/27948) for details.
+
+## [email protected] (beta)
+
+[New image plugin](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-plugin-image) to replace `gatsby-image`, which greatly improves performance (Lighthouse 💯 again) and adds easy static images (no GraphQL). Part of it is also a new, simpler API for `gatsby-transformer-sharp`.
+
+### StaticImage
+
+This component is a new, simpler way to use Gatsby's image processing for static images without needing to write GraphQL queries:
+
+```js
+import React from "react"
+import { StaticImage } from "gatsby-plugin-image"
+
+export const Dino = () => (
+  <StaticImage width={100} height={100} src="trex.png" alt="T-Rex" />
+)
+```
+
+### GatsbyImage
+
+This is a complete rewrite of the Gatsby Image component, using native lazy loading whenever possible.
+In our tests it allows sites whose Lighthouse scores dropped in recent updates to get back to 100s across the board.
+
+### Simpler GraphQL for non-static images
+
+Instead of having to remember lots of different fragments for different image types,
+you can pass all your options as field arguments (and get inline help in GraphiQL):
+
+```graphql
+query {
+  file(relativePath: { eq: "plant.jpg" }) {
+    childImageSharp {
+      gatsbyImageData(maxWidth: 720, layout: FLUID, placeholder: TRACED_SVG)
+    }
+  }
+}
+```
+
+You then use the data like this:
+
+```jsx
+import { GatsbyImage, getImage } from "gatsby-plugin-image"
+
+export function Plant({ data }) {
+  const imageData = getImage(data.file)
+  return <GatsbyImage image={imageData} alt="Plant" />
+}
+```
+
+- [Details, Migration guide and discussion](https://github.com/gatsbyjs/gatsby/discussions/27950)
+- [Documentation](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-plugin-image)
+
+## [email protected]
+
+### New Rich Text Implementation
+
+**Breaking Change**: New rich text implementation for performance and usability. This is only a breaking change if you rely on the Rich Text Contentful field type.
+
+See PR [#25249](https://github.com/gatsbyjs/gatsby/pull/25249) description for details and migration guide.
+
+### Performance improvements
+
+The max of `pageLimit` option was raised from `100` to `1000` (on Contentful's side) which should lead
+to significant reduction of remote fetching times.
+
+Note that the default value for the `pageLimit` option is still `100`, so you need to change
+it manually in your site config to see performance improvements.
+
+Due to technical limitations, the response payload size is still bound by a hard chunk download
+size, so it is possible you may need to use a lower value for your particular site.
+
+## [email protected]
+
+There was a significant performance improvement by making a certain node fetching step lazy.
+This is especially noticeable at scale. See PR [#27937](https://github.com/gatsbyjs/gatsby/pull/27937) for details.
+
+## Work in progress
+
+### Queries on Demand
+
+When developing a Gatsby site there's no need to run all graphql queries before serving the site.
+Instead, Gatsby could run queries for pages as they're requested by a browser.
+This would avoid having to wait for slower queries (like image processing) if you're editing an unrelated part of a site.
+
+Try early alpha (and [let us know](https://github.com/gatsbyjs/gatsby/discussions/27620) if you have any issues with it):
+
+```
+npm install gatsby@qod
+```
+
+Enable in your `gatsby-config.js`:
+
+```js
+module.exports = {
+  // your existing configuration
+  __experimentalQueryOnDemand: true,
+}
+```
+
+[Details and discussion](https://github.com/gatsbyjs/gatsby/discussions/27620).
+
+### Experimental: Lazy images in develop
+
+We've got some feedback that the more image-heavy your website gets, the slower `gatsby develop`.
+This experimental version of `gatsby-plugin-sharp` only does image processing when the page gets requested.
+
+Try early alpha (and [let us know](https://github.com/gatsbyjs/gatsby/discussions/27603) if you have any issues with it):
+
+```
+npm install gatsby-plugin-sharp@lazy-images
+```
+
+Lazy images are enabled by-default in this version.
+
+[Details and discussion](https://github.com/gatsbyjs/gatsby/discussions/27603).
+
+### Documentation Reorganization
+
+We’ve heard repeatedly from the community that Gatsby is a powerful tool,
+but it has a steep learning curve. We want to make it easier to get started with Gatsby.
+And that means having documentation that helps y’all find the information you need when you need it.
+
+[Announcement and discussion](https://github.com/gatsbyjs/gatsby/discussions/27856).
+
+## Contributors
+
+A big **Thank You** to [everyone who contributed](https://github.com/gatsbyjs/gatsby/compare/[email protected]@2.26.0) to this release 💜

docs/reference/release-notes/v2.26/index.md

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-404-to-B-to-404-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/error-recovery/page-query.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-404-to-B-to-404-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/error-recovery/static-query.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-CO-to-B-to-CO-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-404-to-B-to-404-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-CO-to-B-to-CO-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-404-to-B-to-404-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-no-trailing-slash-A-to-B-to-A-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-CO-to-B-to-CO-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-no-trailing-slash-A-to-B-to-A-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-CO-to-B-to-CO-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-with-trailing-slash-A-to-B-to-A-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-no-trailing-slash-A-to-B-to-A-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "page-query-with-trailing-slash-A-to-B-to-A-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-no-trailing-slash-A-to-B-to-A-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-404-to-B-to-404-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-with-trailing-slash-A-to-B-to-A-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-404-to-B-to-404-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/page-query-with-trailing-slash-A-to-B-to-A-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-CO-to-B-to-CO-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-404-to-B-to-404-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-CO-to-B-to-CO-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-404-to-B-to-404-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-no-trailing-slash-A-to-B-to-A-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-CO-to-B-to-CO-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-no-trailing-slash-A-to-B-to-A-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-CO-to-B-to-CO-link.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-with-trailing-slash-A-to-B-to-A-history",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-no-trailing-slash-A-to-B-to-A-history.json

@@ -0,0 +1,4 @@
+{
+  "selector": "static-query-with-trailing-slash-A-to-B-to-A-link",
+  "status": "before-edit"
+}

e2e-tests/development-runtime/content/query-data-caches/static-query-no-trailing-slash-A-to-B-to-A-link.json

@@ -1,5 +1,6 @@
 {
   "baseUrl": "http://localhost:8000",
   "failOnStatusCode": false,
-  "chromeWebSecurity": false
+  "chromeWebSecurity": false,
+  "defaultCommandTimeout": 10000
 }