Merge branch 'master' into feat/query-state-machine

gatsbyjs · Jul 3, 2020 · 28e7691 · 28e7691
2 parents d3e7a59 + c58203f
commit 28e7691
Show file tree

Hide file tree

Showing 333 changed files with 3,422 additions and 2,107 deletions.
diff --git a/.typo-ci.yml b/.typo-ci.yml
diff --git a/dictionary.txt b/dictionary.txt
@@ -124,6 +124,7 @@ Addy
 Adekunle
 Adnan
 AEM
+AgilityCMS
 Ahhh
 Airbnb
 Airtable
@@ -592,6 +593,7 @@ ecommerce
 Ehmke
 EJ
 Eka
+Ekwuno
 Elevar
 Eleventy
 EmailCaptureForm
@@ -1135,6 +1137,7 @@ Kukic
 kung
 Kurulum
 KV
+Kwong
 l33t
 labelled
 labelledby
@@ -1361,6 +1364,7 @@ nvm
 NYCHA
 NYU
 OAuth
+Obinna
 observability
 Oduye
 oEmbed
@@ -1764,6 +1768,7 @@ sexualized
 SFTP
 shadowable
 sharable
+Shardul
 shareability
 shared-ui
 ShopFlamingo

diff --git a/...here-came-from-where-going/gatsbygram.mp4 → ...blog/gatsbygram-case-study/gatsbygram.mp4 b/...here-came-from-where-going/gatsbygram.mp4 → ...blog/gatsbygram-case-study/gatsbygram.mp4
diff --git a/docs/blog/gatsbygram-case-study/index.md b/docs/blog/gatsbygram-case-study/index.md
@@ -16,7 +16,7 @@ playing with the code!
 
 <div>
   <video controls="controls" autoplay="true" loop="true">
-    <source type="video/mp4" src="/gatsbygram.mp4" />
+    <source type="video/mp4" src="gatsbygram.mp4" />
     <p>Your browser does not support the video element.</p>
   </video>
 </div>

diff --git a/docs/blog/gazette-june-2020/index.md b/docs/blog/gazette-june-2020/index.md
@@ -0,0 +1,84 @@
+---
+title: Gatsby Gazette for June 2020 - The Black Lives Matter Edition
+date: 2020-07-01
+author: Hashim Warren
+excerpt: "Learn about June's product, community, and ecosystem updates. This includes improvements to Incremental Builds and TypeScript support"
+seoTitle: Gatsby Product Updates for June 2020
+tags: ["gatsby-gazette"]
+---
+
+In June Gatsby decided to be [intentional and quieter in our social media channels](https://twitter.com/GatsbyJS/status/1267495726017323009) to make room for conversations around systemic racism.
+
+During that period Gatsby [matched donations](https://www.gatsbyjs.com/donation-matching/) to organizations that specialize in criminal justice reform, like the NAACP Legal Defense Fund and the ACLU. We also [launched Gatsby Voices](https://www.gatsbyjs.com/gatsby-voices/), a content series where members of the Gatsby community can share the story of their experiences in tech. (Please apply - those who are selected will be compensated \$500 USD for their work). We renewed our commitment to our core value of ["You Belong Here"](/docs/gatsby-core-philosophy/#you-belong-here) by taking internal action to expand our organizational identity, reevaluate our hiring and career advancement policies, bring in expert consultation, [and other steps](https://www.gatsbyjs.org/blog/2020-06-11-you-belong-here-commitment/).
+
+The efforts above are just the beginning of the work were doing to ensure Black lives matter in our world, our industry, and our company.
+
+## 🚀 New in Gatsby and Gatsby Cloud!
+
+### Improved Site Workflow in Gatsby Cloud
+
+You can now create multiple sites from the same repository in Gatsby Cloud. This new feature enables you to set up multiple configurations for the same GitHub repo (for example, to set up a long-lived staging branch or to independently build multiple sites in the same repo.)
+
+Ready to try it out? If you’re an existing [Gatsby Cloud](https://www.gatsbyjs.com/) user, you’ll need to update your GitHub permissions to access these new improvements.
+
+### 3 new CMS's (plus 1) in Gatsby Cloud
+
+We've made it easier to use [Gatsby Cloud](https://gatsbyjs.com) with three amazing CMS's:
+
+1. [Kentico Kontent](https://www.gatsbyjs.com/guides/kentico-kontent/)
+2. [Flotiq](https://www.gatsbyjs.com/guides/flotiq/)
+3. [AgilityCMS](https://www.gatsbyjs.com/guides/agility-cms/).
+
+Plus - Gatsby Cloud also has [an improved Drupal integration](https://youtu.be/Mm6wrDr2DBE) (Check it out [here](https://www.drupal.org/project/gatsby).)
+
+So, which [headless CMS](/docs/glossary/headless-cms/) should you choose? Why not try all three? With Gatsby you can swap the data provider for your project and build each site with the same Gatsby Cloud account. Then you can compare the developer experience, content editing experience, and build times for each platform.
+
+And speaking of comparing build times…
+
+### New Build Benchmarks in "Will It Build"
+
+Thank you to the team at [Sanity](https://www.sanity.io/blog/get-started-with-gatsby-and-structured-content) for adding their CMS to [Will It Build](https://willit.build/), Gatsby Cloud's benchmarking site. Sanity has one of the fastest _uncached code change_ build times of any CMS we track.
+
+But get this - in June their team also released an update to their source plugin that cut _data / content_ build times [in half](https://willit.build/details/type/blog/source/sanity/page-count/8192)!
+
+![Sanity screenshot](./sanity-benchmark.jpg)
+
+### Configure Your Gatsby Site Without Code
+
+[Gatsby Admin](https://github.com/gatsbyjs/gatsby/pull/22713) launched in alpha! This early release includes plugin and theme management, as well as a theme file shadowing interface. [Register here](https://www.gatsbyjs.com/admin-alpha/) to try out Gatsby Admin for your own project.
+
+### Partner with Gatsby
+
+If you have an agency that wants to specialize on Gatsby, or you are building tools for the Gatsby ecosystem, then we now have [an official way to work with you](/blog/2020-06-22-Announcing-Gatsby-Partner-Program/)! Partners will be able to beta test new products, access training and sales materials, and will have a direct connection to the Gatsby team. [Apply to be a partner](https://www.gatsbyjs.com/partner).
+
+## 👩🏽‍🚀 New from the Gatsby Team
+
+**Kyle Mathews** sat with Shardul Shah of Index Ventures and [talked about how Gatsby came to be](https://youtu.be/pzyX9cH0yHM).
+
+**Laurie Barth** was interviewed on the OpenHive.JS podcast, and talked about [her work maintaining Gatsby](https://anchor.fm/openhivejs/episodes/Laurie-Barth-on-Maintaining-Gatsby-ef6p8i/a-a2e0v24)
+
+**Obinna Ekwuno** produced an Egghead lesson on setting up a [Gatsby site for Incremental Builds with Contentful](https://egghead.io/lessons/gatsby-set-up-a-gatsby-site-for-incremental-builds-with-contentful-cms-on-gatsby-cloud). Obinna also appeared on the [My Life As A Software Engineer](https://anchor.fm/mylifeasasoftwareengineer/episodes/EP-12-Learning-about-Gatsby-with-Obinna-Ekwuno-edt2tk) podcast to talk about, well, his life as a software engineer 🙂.
+
+## 🌍 New from the Gatsby Community
+
+Thank you, **Kristen Kwong** for [redesigning your personal website](https://twitter.com/kristenkwng/status/1274769842717900801) using Gatsby! We love the creative drag-and-drop elements of your homepage.
+
+And thank you **Monica Powell** for your article that explores [art direction with gatsby-mage](https://www.aboutmonica.com/blog/2020-06-24-exploring-art-direction-in-gatsby).
+
+## 🪐 New from the Gatsby Ecosystem
+
+Reflex launched as [a collection of Gatsby themes and plugins](https://reflexjs.org/) to help you build beautiful sites faster. Check out their example library, showing you what you can rapidly create with Reflex.
+
+![Reflex screenshot](./reflex-examples.jpg)
+
+Ecommerce service, Snipcart dived into [Gatsby Recipes](/blog/2020-04-15-announcing-gatsby-recipes/) and showed [how to integrate a shopping cart into your site](https://snipcart.com/blog/gatsby-recipes-ecommerce) in just a few steps.
+
+WPGraphQL announced [it's path to 1.0](https://github.com/wp-graphql/wp-graphql/issues/1357)! If you're new to this plugin for WordPress, that turns your installation into a GraphQL server, then the GitHub issue linked above does a nice job of getting you up-to-speed on the project's history and rapid growth.
+
+## 💫 Next from Gatsby
+
+Be on the lookout for [gatsby-theme-blog 2.0](https://github.com/gatsbyjs/gatsby/issues/23910), our brand new [new routing API](https://www.youtube.com/watch?v=tAcAkqOcs3c) and best practices, and updates to how [headless WordPress](/docs/glossary/headless-wordpress) projects can work with Gatsby Cloud.
+
+Want to help us build this stuff? Apply to our new position for [Senior Product Manager](https://www.gatsbyjs.com/careers/senior-product-manager--marketing---content-collaboration--4027422003) Or drop your résumé in our evergreen ["Dream Job" posting](https://www.gatsbyjs.com/careers/dream-job-4011361003).
+
+Read more about our exciting in-flight work on the [Gatsby Days mega-roundup](/blog/2020-06-23-Reconfiguring-Gatsby-Days/#coming-soon). And signup for our newsletter below so you don’t miss a thing.
diff --git a/docs/blog/gazette-june-2020/reflex-examples.jpg b/docs/blog/gazette-june-2020/reflex-examples.jpg
diff --git a/docs/blog/gazette-june-2020/sanity-benchmark.jpg b/docs/blog/gazette-june-2020/sanity-benchmark.jpg
diff --git a/docs/blog/gazette-june-2020/will-it-build-sanity-screenshot.png b/docs/blog/gazette-june-2020/will-it-build-sanity-screenshot.png
diff --git a/docs/contributing/community.md b/docs/contributing/community.md
@@ -4,7 +4,7 @@ title: Community
 
 import EmailCaptureForm from "@components/email-capture-form"
 
-As of December 2019, the Gatsby community is comprised of over 2,800 contributors and tens of thousands of developers building both personal and commercial websites on Gatsby.
+As of June 2020, the Gatsby community is comprised of over 3,300 contributors and tens of thousands of developers building both personal and commercial websites on Gatsby.
 
 Open source doesn’t always have the best reputation for being friendly and welcoming, and that makes us sad. **Everyone belongs in open source, and Gatsby is dedicated to making you feel welcome.**
 

diff --git a/docs/contributing/docs-contributions.md b/docs/contributing/docs-contributions.md
@@ -2,13 +2,13 @@
 title: Docs Contributions
 ---
 
-Gatsby, unsurprisingly, uses Gatsby for its documentation website. Thank you in advance and cheers for contributing to Gatsby documentation! As of February 2019, over 800 people have contributed. It's people like you that make this community great!
+Gatsby, unsurprisingly, uses Gatsby for its documentation website. Thank you in advance and cheers for contributing to Gatsby documentation! As of June 2020, over 2,100 people have contributed. It's people like you that make this community great!
 
 > _When deciding where to contribute to Gatsby (docs or [blog](/contributing/blog-contributions/)?), check out the [docs templates](/contributing/docs-templates/) page._
 
 ## Top priorities
 
-Check the GitHub repo for issues labeled with ["documentation" and "good first issue"](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22type%3A+documentation%22+label%3A%22good+first+issue%22) for your first time contributing to Gatsby, or ["documentation" and "help wanted"](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22type%3A+documentation%22+label%3A%22help+wanted%22) to see all documentation issues that are ready for community help. Once you start a Pull Request to address one of these issues, you can remove the "help wanted" label. As well, examine the list of articles that haven't been fully fleshed out at the [Stub List](/contributing/stub-list).
+Check the GitHub repo for issues labeled with ["type: documentation" and "good first issue"](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22type%3A+documentation%22+label%3A%22good+first+issue%22) for your first time contributing to Gatsby, or [type: documentation" and "help wanted"](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22type%3A+documentation%22+label%3A%22help+wanted%22) to see all documentation issues that are ready for community help. Once you start a Pull Request to address one of these issues, you can remove the "help wanted" label. As well, examine the list of articles that haven't been fully fleshed out at the [Stub List](/contributing/stub-list).
 
 ## Options for contributing to the Gatsby docs
 

diff --git a/docs/docs/ab-testing.md b/docs/docs/ab-testing.md
@@ -1,6 +1,5 @@
 ---
 title: A/B Testing
-overview: true
 ---
 
 A/B or split testing is when you make test changes to a website. Suppose you have two buttons: a green “Buy Now!” button and a red “Buy Now!” button. You want to figure out which button will receive the most clicks. An A/B test would be an ideal way to measure engagement.

diff --git a/docs/docs/adding-app-and-website-functionality.md b/docs/docs/adding-app-and-website-functionality.md
@@ -1,6 +1,5 @@
 ---
 title: Adding App and Website Functionality
-overview: true
 ---
 
 Gatsby empowers developers and creators to make many different types of websites. One may wish to add additional functionality to their site such as search, authentication, forms, comments, and plenty of others.

diff --git a/docs/docs/adding-page-transitions.md b/docs/docs/adding-page-transitions.md
@@ -1,6 +1,5 @@
 ---
 title: Adding Page Transitions
-overview: true
 ---
 
 Page transitions give users a better experience when navigating between pages. There are a number of ways to add them to your Gatsby site.

diff --git a/docs/docs/adding-search.md b/docs/docs/adding-search.md
@@ -1,6 +1,5 @@
 ---
 title: Adding Search
-overview: true
 ---
 
 See below for a list of guides in this section, or keep reading for an overview on adding search functionality to your site.

diff --git a/docs/docs/api-reference.md b/docs/docs/api-reference.md
@@ -1,6 +1,5 @@
 ---
 title: Gatsby API Reference
-overview: true
 ---
 
 Learn more about Gatsby API methods and options, common files, and customizations.

diff --git a/docs/docs/conceptual-guide.md b/docs/docs/conceptual-guide.md
@@ -1,6 +1,5 @@
 ---
 title: Conceptual Guide
-overview: true
 ---
 
 Read high-level overviews of important Gatsby concepts and philosophies.

diff --git a/docs/docs/css-in-js.md b/docs/docs/css-in-js.md
@@ -1,6 +1,5 @@
 ---
 title: Enhancing Styles with CSS-in-JS
-overview: true
 ---
 
 CSS-in-JS refers to an approach where styles are written in JavaScript instead of in external CSS files to easily scope styles in components, eliminate dead code, encourage faster performance and dynamic styling, and more.

diff --git a/docs/docs/css-libraries-and-frameworks.md b/docs/docs/css-libraries-and-frameworks.md
@@ -1,6 +1,5 @@
 ---
 title: CSS Libraries and Frameworks
-overview: true
 ---
 
 There are many other CSS style libraries and frameworks that you can use in your Gatsby project.

diff --git a/docs/docs/customization.md b/docs/docs/customization.md
@@ -1,6 +1,5 @@
 ---
 title: Custom Configuration
-overview: true
 ---
 
 Sometimes you may find yourself in a situation where Gatsby's default configuration just isn't quite what you need for your site. If you should find yourself in this situation, have no fear my friend, you can customize Gatsby's config for `babel` and `webpack`. You can also customize `html.js`, the React component used to generate the initial HTML file of your build. You'll also find guides on how to get custom environment variables into your website, as well how to proxy API requests in development so your API calls aren't interpreted by your server as static assets.

diff --git a/docs/docs/debugging.md b/docs/docs/debugging.md
@@ -1,6 +1,5 @@
 ---
 title: Debugging
-overview: true
 ---
 
 While building your site, you’ll sometimes encounter bugs. These guides help you set up debugging in Gatsby so you can spot and squash bugs more easily.

diff --git a/docs/docs/deploying-and-hosting.md b/docs/docs/deploying-and-hosting.md
@@ -1,6 +1,5 @@
 ---
 title: Deploying and Hosting
-overview: true
 ---
 
 Getting your shiny new Gatsby site deployed and accessible is probably the first thing you will want to do now that it's built! Also, give yourself a pat on the back real quick for creating something so great!

diff --git a/docs/docs/graphql.md b/docs/docs/graphql.md
@@ -1,6 +1,5 @@
 ---
 title: GraphQL & Gatsby
-overview: true
 ---
 
 When building with Gatsby, you access your data through a query language named [GraphQL](https://graphql.org/). GraphQL allows you to declaratively express your data needs. This is done with `queries`, queries are the representation of the data you need. A query looks like this:

diff --git a/docs/docs/guides.md b/docs/docs/guides.md
@@ -1,6 +1,5 @@
 ---
 title: Reference Guides
-overview: true
 ---
 
 Dive deeper into different topics around building with Gatsby, like sourcing data, building and styling pages, deployment, and more. While the [tutorials](/tutorial/) are step-by-step instructions, reference guides are resources about the various Gatsby development techniques.

diff --git a/docs/docs/headless-cms.md b/docs/docs/headless-cms.md
@@ -1,6 +1,5 @@
 ---
 title: What is a Headless CMS and How to Source Content from One
-overview: true
 ---
 
 A _headless CMS_ is content management software that enables writers to produce and organize content, while providing developers with structured data that can be displayed using a separate system on the frontend of a website or app.

diff --git a/docs/docs/partnering-with-gatsby.md b/docs/docs/partnering-with-gatsby.md
@@ -1,6 +1,5 @@
 ---
 title: Partnering with Gatsby
-overview: true
 ---
 
 If you're an organization in the website space -- whether a vendor or an agency -- we'd love to work together with you.

diff --git a/docs/docs/performance.md b/docs/docs/performance.md
@@ -1,6 +1,5 @@
 ---
 title: Performance
-overview: true
 ---
 
 While performance is already at the heart of Gatsby, it's important to ensure you are doing all you can to make your content available to your users as fast as possible. Not all users are enjoying high speed connections, or browsing from a desktop. It's important to make no assumptions and serve the smallest and fastest site possible, to provide an optimal experience for wherever your users might be coming from. Since Gatsby is already doing a lot of the heavy lifting for you there isn't a lot required out of the box to make your site blazing fast, but by following these guides you can ensure the best possible performance and delivery of your content to your users.

diff --git a/docs/docs/plugins-themes-and-starters.md b/docs/docs/plugins-themes-and-starters.md
@@ -1,6 +1,5 @@
 ---
 title: Plugins, Themes, & Starters
-overview: true
 ---
 
 In the Gatsby ecosystem, there's more than one way to build a site. To help you understand the differences between plugins, themes, and starters, this guide will talk through some of the details.

diff --git a/docs/docs/preparing-for-site-launch.md b/docs/docs/preparing-for-site-launch.md
@@ -1,6 +1,5 @@
 ---
 title: Preparing Your Site for Launch
-overview: true
 ---
 
 So your Gatsby site is done, and you're ready to share it with the world, **congratulations**! 🎉

diff --git a/docs/docs/preparing-your-environment.md b/docs/docs/preparing-your-environment.md
@@ -1,6 +1,5 @@
 ---
 title: Preparing Your Environment
-overview: true
 ---
 
 To get started with Gatsby, you'll need to make sure you have the following software tools installed:

diff --git a/docs/docs/releases-and-migration.md b/docs/docs/releases-and-migration.md
@@ -1,6 +1,5 @@
 ---
 title: Releases & Migration
-overview: true
 ---
 
 Find release notes and guides on how to upgrade Gatsby along with third-party packages.

diff --git a/docs/docs/styling.md b/docs/docs/styling.md
@@ -1,6 +1,5 @@
 ---
 title: Styling
-overview: true
 ---
 
 There are many ways to style your website. They can roughly be grouped into three styling approaches:

diff --git a/docs/docs/testing.md b/docs/docs/testing.md
@@ -1,6 +1,5 @@
 ---
 title: Adding Testing
-overview: true
 disableTableOfContents: true
 ---
 

diff --git a/docs/docs/themes.md b/docs/docs/themes.md
@@ -1,6 +1,5 @@
 ---
 title: Themes
-overview: true
 disableTableOfContents: true
 ---
 

diff --git a/docs/docs/using-gatsby-professionally.md b/docs/docs/using-gatsby-professionally.md
@@ -1,6 +1,5 @@
 ---
 title: Using Gatsby Professionally
-overview: true
 ---
 
 As a Gatsby developer and enthusiast, you may be interested in how you can spend more of your time professionally building with Gatsby.