diff --git a/README.md b/README.md
index b9b642f61efe1..9d832acf6f370 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@
-
+
diff --git a/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md b/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
index 0e5f147481179..9ec033331e168 100644
--- a/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
+++ b/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
@@ -140,4 +140,4 @@ While this isn't a tutorial -- more a guided walkthrough of me familiarizing and
2. Gatsby makes heavy use of [plugins](/docs/plugins/) — both official and community — for a lot of things, from one that implements [Google Analytics](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-plugin-google-analytics), to one that adds [GitHub's accessibility error scanner](https://github.com/alampros/gatsby-plugin-accessibilityjs) to all pages.
3. Read through some of the source code. I particularly enjoyed reading through [the bootstrap process](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/src/bootstrap/index.js). (It's beautifully commented).
4. Gatsby.js is a static Progressive Web App (PWA) generator, but to be PWA friendly (at least according to the [Lighthouse PWA audit](https://developers.google.com/web/tools/lighthouse/)), look into two plugins: `gatsby-plugin-manifest` and `gatsby-plugin-offline`.
-5. I did end up [deploying with Netlify](/docs/deploy-gatsby/#netlify), and I'm super happy with it. (A [previous post](/blog/2017-12-06-gatsby-plus-contentful-plus-netlify/#solution-netlify--gatsby) discussed Netlify a bit more, if you're interested).
+5. I did end up [deploying with Netlify](/docs/deploying-to-netlify), and I'm super happy with it. (A [previous post](/blog/2017-12-06-gatsby-plus-contentful-plus-netlify/#solution-netlify--gatsby) discussed Netlify a bit more, if you're interested).
diff --git a/docs/blog/2018-02-16-bright-future-for-the-web/index.md b/docs/blog/2018-02-16-bright-future-for-the-web/index.md
index 0f206624e428b..0b398af2f2859 100644
--- a/docs/blog/2018-02-16-bright-future-for-the-web/index.md
+++ b/docs/blog/2018-02-16-bright-future-for-the-web/index.md
@@ -35,5 +35,3 @@ The final piece of the puzzle was determining where to host the website. I had r
After a little over a month of tinkering on the design during nights and weekends I had a fully functional website ready to be launched. During this process I learned a fair bit of how to code with React and the Gatsby community seemed genuinely nice and happy to help me to learn. The final product was a website that felt like it belonged in 2018 while still allowing my wife to easily update content with no assistance. Not only that the website was immensely faster than the previous WordPress version, served over HTTPS, utilized a CDN and cost me $0 dollars a month thanks to the extremely generous free tiers offered by Netlify and Contentful. 😍
If you are currently on the fence about static site generators or the JAMstack in general there has never been a better time to jump in. In my humble opinion with these tools it has finally reached the level of maturity to not just be feasible for client work but actually pretty darn amazing.
-
-For those interested the source code for the website I built is available on GitHub: https://github.com/ryanwiemer/knw
diff --git a/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md b/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
index 1da15601a7292..02298cd665539 100644
--- a/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
+++ b/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
@@ -42,7 +42,7 @@ Working with another developer, a photographer, and a graphic designer, he found
“Almost all the code we used in prototyping went into production,” says Rose. “Especially back in the Drupal days, that was just not going to happen.
-Another unexpected benefit was the cost reduction of hosting static content, instead of running PHP servers. After migrating to Gatsby, Rose moved the cajunbowfishing.com website hosting over to [Netlify](www.netlify.com).
+Another unexpected benefit was the cost reduction of hosting static content, instead of running PHP servers. After migrating to Gatsby, Rose moved the cajunbowfishing.com website hosting over to [Netlify](https://www.netlify.com).
“Our bill went from $5,000 a month to $5,” he says.
diff --git a/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md b/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
index 5033f3f04ee52..cc9baf6fb31ba 100644
--- a/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
+++ b/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
@@ -265,7 +265,7 @@ I will not go in depth with how to manage state with React since there are a lot
-Since Gatsby builds "static" files you can host them on tons of services. One of my favourites is [Netlify](https://www.netlify.com/). There is also [AWS S3](https://aws.amazon.com/s3/) and more, see the [deploying Gatsby documentation](/docs/deploy-gatsby/) for examples.
+Since Gatsby builds "static" files you can host them on tons of services. One of my favourites is [Netlify](https://www.netlify.com/). There is also [AWS S3](https://aws.amazon.com/s3/) and more, see the [deploying Gatsby documentation](/docs/deploying-and-hosting/) for examples.
## Resources
diff --git a/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md b/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
index 0dcee9305c807..5b3f000135e1e 100644
--- a/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
+++ b/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
@@ -19,7 +19,7 @@ Here's how it all got started. The goal with [Gatsby Manor](https://gatsbymanor.
is to create professional designed Gatsby starters
to give your site a clean, modern look the moment you create a new project.
While creating our newest starter
-[gatsby-starter-eventually](https://gatsbymanor.com/demo/eventually),
+[gatsby-starter-eventually](https://github.com/gatsbymanor/gatsby-starter-eventually),
I wanted to organize the directory structure of the project to better fit my
workflow.
diff --git a/docs/blog/2018-08-09-swag-store/index.md b/docs/blog/2018-08-09-swag-store/index.md
index 5479741a4ff71..1a2dad0d77206 100644
--- a/docs/blog/2018-08-09-swag-store/index.md
+++ b/docs/blog/2018-08-09-swag-store/index.md
@@ -76,6 +76,6 @@ Thanks for being part of the open source community! 💪💜
[shopify]: https://www.shopify.com/
[js-buy-sdk]: https://shopify.github.io/js-buy-sdk/
[auth0]: https://auth0.com/
-[invite]: https://github.com/gatsbyjs/peril-gatsbyjs/blob/master/org/invite-collaborator.ts
+[invite]: https://github.com/gatsbyjs/peril-gatsbyjs/blob/master/rules/invite-collaborator.ts
[peril]: https://github.com/danger/peril
[contribute]: /docs/how-to-contribute/
diff --git a/docs/blog/2018-1-18-strapi-and-gatsby/index.md b/docs/blog/2018-1-18-strapi-and-gatsby/index.md
index 2c6f8df7e556e..1bc5be969336b 100644
--- a/docs/blog/2018-1-18-strapi-and-gatsby/index.md
+++ b/docs/blog/2018-1-18-strapi-and-gatsby/index.md
@@ -596,7 +596,7 @@ Since the content is managed by Strapi, the authors can write article through a
Feel free to continue this project to discover both Gatsby and Strapi advantages. Here are some features you can add: list of authors, article's categories, and comment system with the Strapi API or Disqus. You can also create other kind of websites (e-commerce shop, corporate website, etc.).
-When your project is achieved, you will probably want to deploy it. The static website generated by Gatsby can [easily be published on storage providers](https://www.gatsbyjs.org/docs/deploy-gatsby/): Netlify, S3/Cloudfront, GitHub pages, GitLab pages, Heroku, etc. The Strapi API is nothing else than a simple Node.js API, so it can be hosted on Heroku or any Linux instance that has Node.js installed.
+When your project is achieved, you will probably want to deploy it. The static website generated by Gatsby can [easily be published on storage providers](https://www.gatsbyjs.org/docs/deploying-and-hosting): Netlify, S3/Cloudfront, GitHub pages, GitLab pages, Heroku, etc. The Strapi API is nothing else than a simple Node.js API, so it can be hosted on Heroku or any Linux instance that has Node.js installed.
The [code source of this tutorial is available on GitHub](https://github.com/strapi/strapi-examples/tree/master/gatsby-strapi-tutorial). To see it live, clone the repository, run `npm run setup`, start the Strapi server (`cd api && strapi start`) and the Gatsby server (`cd blog && npm run develop`).
diff --git a/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md b/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
index f4d834d9fb339..f3811dc677eff 100644
--- a/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
+++ b/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
@@ -65,7 +65,7 @@ In Part 3, [The Rise of Modern Web Development](/blog/2018-10-11-rise-of-modern-
In Part 4, [Why Mobile Performance is Crucial](/blog/2018-10-16-why-mobile-performance-is-crucial), we’ll discuss the ROI of site speed, explore two modern, complementary trends for improving web performance and how website teams can get the best of both out of the box.
-In our conclusion, [Creating Compelling Experiences](/blog/2018-10-18-creating-compelling-experiences), we’ll discuss a step-by-step approach for choosing a content architecture, modern development environment, a performance strategy -- and most importantly, choosing a "content mesh" that makes all the other choices easy. We’ll also explore how one clear option -- Gatsby -- emerges as the most feature-complete of any content mesh alternatives.
+In our conclusion, [Creating Compelling Experiences](/blog/2018-10-18-creating-compelling-content-experiences), we’ll discuss a step-by-step approach for choosing a content architecture, modern development environment, a performance strategy -- and most importantly, choosing a "content mesh" that makes all the other choices easy. We’ll also explore how one clear option -- Gatsby -- emerges as the most feature-complete of any content mesh alternatives.
## The Modern Website Landscape
diff --git a/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md b/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
index 502e022d0167c..f2dad1839eb13 100644
--- a/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
+++ b/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
@@ -33,7 +33,7 @@ Here is a summary of the “docs decision tree,” a tool we’ll use to make de
A doc qualifies to be in the .org site if it:
-1. Deals with a piece of Gatsby-maintained software (e.g. pertains to code in the [Gatsby OSS repository](www.github.com/gatsbyjs/gatsby)), a core dependency of the code in the Gatsby OSS repo, or a third-party software that works well with Gatsby and is in high demand
+1. Deals with a piece of Gatsby-maintained software (e.g. pertains to code in the [Gatsby OSS repository](https://www.github.com/gatsbyjs/gatsby)), a core dependency of the code in the Gatsby OSS repo, or a third-party software that works well with Gatsby and is in high demand
> **Yes** --> Belongs in the docs (to make sure we don’t have to maintain docs about core dependencies and third-party software, we will focus on linking to their docs as much as possible)
diff --git a/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md b/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
index 6251889f86897..cb6a47cc3d678 100644
--- a/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
+++ b/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
@@ -112,7 +112,7 @@ For example, if you use a CDN to serve 3MB Javascript bundles, your site is stil
- Part of a network request waterfall chart for a typical enterprise website (adobe.com). The full waterfall chart is three times longer.
+ Part of a network request waterfall chart for a typical enterprise website (adobe.com). The full waterfall chart is three times longer.
diff --git a/docs/blog/2018-2-6-choosing-a-back-end/index.md b/docs/blog/2018-2-6-choosing-a-back-end/index.md
index 88ad2e079fccb..b2ebceeade133 100644
--- a/docs/blog/2018-2-6-choosing-a-back-end/index.md
+++ b/docs/blog/2018-2-6-choosing-a-back-end/index.md
@@ -33,7 +33,7 @@ You build your site. You’ve got your Sass, you’ve got your Markdown files (o
Now we need a system to manage and deliver our content in a nice API (instructed by our GraphQL of course). And there’s a whole bunch of them about. To help us out, Gatsby has plugins that cater to some Headless CMS like the WordPress API, Contentful, Cockpit, Prismic and NetlifyCMS - which Gatsby actually has a guide for. I’ll be going through a few of these to see which one might be more useful for this small project, and going forward.
-> After posting this, I heard some really good thing about [GraphCMS](https://graphcms.com/) - It’s designed to work with GraphQL inherently and they have a [Gatsby Starter Project](https://github.com/GraphCMS/graphcms-examples/tree/master/gatsby-source-plugin-blog) example to check out.
+> After posting this, I heard some really good thing about [GraphCMS](https://graphcms.com/) - It’s designed to work with GraphQL inherently and they have a [Gatsby Starter Project](https://github.com/GraphCMS/graphcms-examples/tree/master/current/gatsby-source-plugin-blog) example to check out.
Firstly, though, why do we want a Headless CMS and a JAMstack for the project? There are a few reasons most people use them, and some that are down to personal preference:
diff --git a/docs/docs/gatsby-style-guide.md b/docs/docs/gatsby-style-guide.md
index 9ad359167c620..77042e33f6e06 100644
--- a/docs/docs/gatsby-style-guide.md
+++ b/docs/docs/gatsby-style-guide.md
@@ -41,7 +41,7 @@ topic to write about it--this entire website is open source, so even if you make
If you’d like to help by writing an article, find a stub article in the Gatsby
Docs (with a grey instead of black title in the sidebar of the Docs), write the article, then
-[open a pull request (PR)](/how-to-contribute/#contributing-to-the-documentation) in the Gatsby GitHub repo to replace the stub with your article.
+[open a pull request (PR)](/docs/how-to-contribute/#contributing-to-the-documentation) in the Gatsby GitHub repo to replace the stub with your article.
If you can't find a stub about the topic you'd like to write about, you can open a PR in GitHub that creates the stub and includes your draft article. Feel free to ask questions in the PR comments if you're not sure where to put a new article in the directory structure.
@@ -52,13 +52,13 @@ Before you begin writing, make sure to read the rest of this style guide.
Docs can cover a broad range of topics. Please see the following
examples:
-- [guides](/add-404-page/)
-- [guide overviews](/styling/)
+- [guides](/docs/add-404-page/)
+- [guide overviews](/docs/styling/)
- [tutorials](/tutorial/part-one/)
- [plugin READme](/packages/gatsby-source-filesystem/)
- [starter READme](https://github.com/gatsbyjs/gatsby-starter-default)
-Please see the [Docs templates](docs/templates/) for guidelines on how to format the above kinds of documents.
+Please see the [Docs templates](/docs/templates/) for guidelines on how to format the above kinds of documents.
## Writing process
diff --git a/docs/docs/headless-cms.md b/docs/docs/headless-cms.md
index c95271f40228b..22233f4e18696 100644
--- a/docs/docs/headless-cms.md
+++ b/docs/docs/headless-cms.md
@@ -17,19 +17,19 @@ The guides in this section will walk through the process of setting up content s
Other CMS systems you can connect to include:
-- [ButterCMS](https://www.gatsbyjs.org/packages/gatsby-source-buttercms/?=gatsby-source-)
-- [Shopify](https://www.gatsbyjs.org/packages/gatsby-source-shopify/?=gatsby-source-)
-- [Contentstack](https://www.gatsbyjs.org/packages/gatsby-source-contentstack/?=gatsby-source-)
-- [Ghost](https://www.gatsbyjs.org/packages/gatsby-source-ghost/?=gatsby-source-)
-- [Prismic](https://www.gatsbyjs.org/packages/gatsby-source-prismic/?=gatsby-source-)
-- [Strapi](https://www.gatsbyjs.org/packages/gatsby-source-strapi/?=gatsby-source-)
-- [Directus](https://www.gatsbyjs.org/packages/gatsby-source-directus/?=gatsby-source-)
-- [Cockpit](https://www.gatsbyjs.org/packages/gatsby-plugin-cockpit/?=gatsby-source-)
-- [GraphCMS](https://www.gatsbyjs.org/packages/gatsby-source-graphcms-beta-patch/?=gatsby-source-)
-- [CraftCMS](https://www.gatsbyjs.org/packages/gatsby-source-craftcms/?=gatsby-source-)
-- [DatoCMS](https://www.gatsbyjs.org/packages/gatsby-source-datocms/?=gatsby-source-)
-- [Storyblok](https://www.gatsbyjs.org/packages/gatsby-source-storyblok/?=gatsby-source-)
-- [Kentico Cloud](https://www.gatsbyjs.org/packages/gatsby-source-kentico-cloud/?=gatsby-source-)
+- [ButterCMS](https://www.gatsbyjs.org/packages/gatsby-source-buttercms)
+- [Shopify](https://www.gatsbyjs.org/packages/gatsby-source-shopify)
+- [Contentstack](https://www.gatsbyjs.org/packages/gatsby-source-contentstack)
+- [Ghost](https://www.gatsbyjs.org/packages/gatsby-source-ghost)
+- [Prismic](https://www.gatsbyjs.org/packages/gatsby-source-prismic)
+- [Strapi](https://www.gatsbyjs.org/packages/gatsby-source-strapi)
+- [Directus](https://www.gatsbyjs.org/packages/gatsby-source-directus)
+- [Cockpit](https://www.gatsbyjs.org/packages/gatsby-plugin-cockpit)
+- [GraphCMS](https://www.gatsbyjs.org/packages/gatsby-source-graphcms-beta-patch)
+- [CraftCMS](https://www.gatsbyjs.org/packages/gatsby-source-craftcms)
+- [DatoCMS](https://www.gatsbyjs.org/packages/gatsby-source-datocms)
+- [Storyblok](https://www.gatsbyjs.org/packages/gatsby-source-storyblok)
+- [Kentico Cloud](https://www.gatsbyjs.org/packages/gatsby-source-kentico-cloud)
## How to add new guides to this section
diff --git a/docs/docs/migrating-from-v1-to-v2.md b/docs/docs/migrating-from-v1-to-v2.md
index 546a34a6cc17c..1c0a6fe34ba1f 100644
--- a/docs/docs/migrating-from-v1-to-v2.md
+++ b/docs/docs/migrating-from-v1-to-v2.md
@@ -733,7 +733,7 @@ exports.onCreateWebpackConfig = ({ getConfig, actions }) => {
}
```
-If you're using a preprocessor, you can pass in CSS Loader options when configuring [`gatsby-plugin-sass`](/packages/gatsby-plugin-sass/README.md#how-to-use) or [`gatsby-plugin-less`](/packages/gatsby-plugin-less/README.md#how-to-use):
+If you're using a preprocessor, you can pass in CSS Loader options when configuring [`gatsby-plugin-sass`](/packages/gatsby-plugin-sass/#how-to-use) or [`gatsby-plugin-less`](/packages/gatsby-plugin-less/#how-to-use):
```javascript
// in gatsby-config.js
diff --git a/docs/docs/sourcing-from-private-apis.md b/docs/docs/sourcing-from-private-apis.md
index aa711b6b8634e..3e86793efcc92 100644
--- a/docs/docs/sourcing-from-private-apis.md
+++ b/docs/docs/sourcing-from-private-apis.md
@@ -16,7 +16,7 @@ There are 3 approaches that you can use to source data from your private API:
1. If the data of your private API is updated very frequently or the expectation of the site is to be updated in real-time, it may make more sense to query the data directly during runtime.
-2. If you can source the data through a plugin, consider that as an alternative to sourcing via the API. For instance, if you have access to the MongoDB database that stores the data, [`gatsby-source-mongodb`](/https://www.gatsbyjs.org/packages/gatsby-source-mongodb/) will be handy. Browse the [Gatsby Plugin Library](https://www.gatsbyjs.org/plugins/) to see what plugins that you could utilize.
+2. If you can source the data through a plugin, consider that as an alternative to sourcing via the API. For instance, if you have access to the MongoDB database that stores the data, [`gatsby-source-mongodb`](https://www.gatsbyjs.org/packages/gatsby-source-mongodb/) will be handy. Browse the [Gatsby Plugin Library](https://www.gatsbyjs.org/plugins/) to see what plugins that you could utilize.
3. Depending on your build process and the availability of your private API, you may need to make other adjustments accordingly.
diff --git a/docs/docs/webpack-and-ssr.md b/docs/docs/webpack-and-ssr.md
index f3f47b9f34568..b092b6e3a77e3 100644
--- a/docs/docs/webpack-and-ssr.md
+++ b/docs/docs/webpack-and-ssr.md
@@ -10,6 +10,6 @@ The next stages of the build lean heavily on webpack for code optimization and c
All the files required by webpack are in your site's `.cache` directory. This is empty when you initialize a new project and can be safely deleted. Gatsby creates and fills it over the course of a build.
-At the start of the build, Gatsby [copies all files](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/src/bootstrap/index.js#L191) in [gatsby/cache-dir](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby/cache-dir) into your `.cache` directory. This includes things like [static-entry.js](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/cache-dir/static-entry.jsO) and [production-app.js](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/cache-dir/production-app.js) that you'll read about in the next sections. Essentially, all files that are needed by Gatsby to run in the browser, or to generate HTML, are included in `cache-dir`.
+At the start of the build, Gatsby [copies all files](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/src/bootstrap/index.js#L191) in [gatsby/cache-dir](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby/cache-dir) into your `.cache` directory. This includes things like [static-entry.js](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/cache-dir/static-entry.js) and [production-app.js](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/cache-dir/production-app.js) that you'll read about in the next sections. Essentially, all files that are needed by Gatsby to run in the browser, or to generate HTML, are included in `cache-dir`.
Since Webpack doesn't know about Redux, we also need to create files that contain all the page data that was built up during bootstrap. And these all need to be placed in `.cache` as well. This is what the previous [Write Out Pages](/docs/write-pages/) section dealt with.
diff --git a/packages/gatsby-plugin-layout/README.md b/packages/gatsby-plugin-layout/README.md
index 3cc4d347fd8aa..5f32b61705b46 100644
--- a/packages/gatsby-plugin-layout/README.md
+++ b/packages/gatsby-plugin-layout/README.md
@@ -50,7 +50,7 @@ module.exports = {
There are a few scenarios where it makes sense to reimplement the V1 layout handling:
-1. You have a large or complex V1 site and [refactoring to the new layout component](https://v2--gatsbyjs.netlify.com/docs/migrating-from-v1-to-v2/#update-layout-component) is not feasible
+1. You have a large or complex V1 site and [refactoring to the new layout component](https://www.gatsbyjs.org/docs/migrating-from-v1-to-v2/#remove-or-refactor-layout-components) is not feasible
2. Your site uses page transitions or other transitions that break if the layout component is unmounted and remounted when routes change
3. Your site attaches global state in the layout that doesn't persist if the component is unmounted and remounted
diff --git a/packages/gatsby-source-wordpress/README.md b/packages/gatsby-source-wordpress/README.md
index 27a305fcd620b..811ff5aa2608c 100644
--- a/packages/gatsby-source-wordpress/README.md
+++ b/packages/gatsby-source-wordpress/README.md
@@ -11,7 +11,7 @@ An example site for this plugin is available.
## Features
-- Pulls data from self-hosted WordPress sites, or sites hosted on [https://wordpress.com](wordpress.com)
+- Pulls data from self-hosted WordPress sites, or sites hosted on [WordPress.com](https://wordpress.com)
- Should work with any number of posts (tested on a site with 900 posts)
- Can authenticate to wordpress.com's API using OAuth 2 so media can be queried
- Easily create responsive images in Gatsby from WordPress images. See [image
@@ -62,7 +62,7 @@ module.exports = {
// If your site is hosted on wordpress.org, then set this to false.
hostingWPCOM: false,
// If useACF is true, then the source plugin will try to import the Wordpress ACF Plugin contents.
- // This feature is untested for sites hosted on Wordpress.com.
+ // This feature is untested for sites hosted on wordpress.com.
// Defaults to true.
useACF: true,
// Include specific ACF Option Pages that have a set post ID
@@ -82,7 +82,7 @@ module.exports = {
// If hostingWPCOM is true then you will need to communicate with wordpress.com API
// in order to do that you need to create an app (of type Web) at https://developer.wordpress.com/apps/
// then add your clientId, clientSecret, username, and password here
- // Learn about environment variables: https://gatsby.app/env-vars
+ // Learn about environment variables: https://www.gatsbyjs.org/docs/environment-variables
wpcom_app_clientSecret: process.env.WORDPRESS_CLIENT_SECRET,
wpcom_app_clientId: "54793",
wpcom_user: "gatsbyjswpexample@gmail.com",
@@ -918,4 +918,4 @@ process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0"
```
[dotenv]: https://github.com/motdotla/dotenv
-[envvars]: https://gatsby.app/env-vars
+[envvars]: https://www.gatsbyjs.org/docs/environment-variables
diff --git a/packages/gatsby/README.md b/packages/gatsby/README.md
index 2813de58a22d3..3d128838580cd 100644
--- a/packages/gatsby/README.md
+++ b/packages/gatsby/README.md
@@ -27,7 +27,7 @@
-
+
diff --git a/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md b/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
index 0e5f147481179..9ec033331e168 100644
--- a/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
+++ b/docs/blog/2018-01-22-getting-started-gatsby-and-wordpress/index.md
@@ -140,4 +140,4 @@ While this isn't a tutorial -- more a guided walkthrough of me familiarizing and
2. Gatsby makes heavy use of [plugins](/docs/plugins/) — both official and community — for a lot of things, from one that implements [Google Analytics](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-plugin-google-analytics), to one that adds [GitHub's accessibility error scanner](https://github.com/alampros/gatsby-plugin-accessibilityjs) to all pages.
3. Read through some of the source code. I particularly enjoyed reading through [the bootstrap process](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby/src/bootstrap/index.js). (It's beautifully commented).
4. Gatsby.js is a static Progressive Web App (PWA) generator, but to be PWA friendly (at least according to the [Lighthouse PWA audit](https://developers.google.com/web/tools/lighthouse/)), look into two plugins: `gatsby-plugin-manifest` and `gatsby-plugin-offline`.
-5. I did end up [deploying with Netlify](/docs/deploy-gatsby/#netlify), and I'm super happy with it. (A [previous post](/blog/2017-12-06-gatsby-plus-contentful-plus-netlify/#solution-netlify--gatsby) discussed Netlify a bit more, if you're interested).
+5. I did end up [deploying with Netlify](/docs/deploying-to-netlify), and I'm super happy with it. (A [previous post](/blog/2017-12-06-gatsby-plus-contentful-plus-netlify/#solution-netlify--gatsby) discussed Netlify a bit more, if you're interested).
diff --git a/docs/blog/2018-02-16-bright-future-for-the-web/index.md b/docs/blog/2018-02-16-bright-future-for-the-web/index.md
index 0f206624e428b..0b398af2f2859 100644
--- a/docs/blog/2018-02-16-bright-future-for-the-web/index.md
+++ b/docs/blog/2018-02-16-bright-future-for-the-web/index.md
@@ -35,5 +35,3 @@ The final piece of the puzzle was determining where to host the website. I had r
After a little over a month of tinkering on the design during nights and weekends I had a fully functional website ready to be launched. During this process I learned a fair bit of how to code with React and the Gatsby community seemed genuinely nice and happy to help me to learn. The final product was a website that felt like it belonged in 2018 while still allowing my wife to easily update content with no assistance. Not only that the website was immensely faster than the previous WordPress version, served over HTTPS, utilized a CDN and cost me $0 dollars a month thanks to the extremely generous free tiers offered by Netlify and Contentful. 😍
If you are currently on the fence about static site generators or the JAMstack in general there has never been a better time to jump in. In my humble opinion with these tools it has finally reached the level of maturity to not just be feasible for client work but actually pretty darn amazing.
-
-For those interested the source code for the website I built is available on GitHub: https://github.com/ryanwiemer/knw
diff --git a/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md b/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
index 1da15601a7292..02298cd665539 100644
--- a/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
+++ b/docs/blog/2018-06-14-escalade-sports-from-5000-to-5-in-hosting/index.md
@@ -42,7 +42,7 @@ Working with another developer, a photographer, and a graphic designer, he found
“Almost all the code we used in prototyping went into production,” says Rose. “Especially back in the Drupal days, that was just not going to happen.
-Another unexpected benefit was the cost reduction of hosting static content, instead of running PHP servers. After migrating to Gatsby, Rose moved the cajunbowfishing.com website hosting over to [Netlify](www.netlify.com).
+Another unexpected benefit was the cost reduction of hosting static content, instead of running PHP servers. After migrating to Gatsby, Rose moved the cajunbowfishing.com website hosting over to [Netlify](https://www.netlify.com).
“Our bill went from $5,000 a month to $5,” he says.
diff --git a/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md b/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
index 5033f3f04ee52..cc9baf6fb31ba 100644
--- a/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
+++ b/docs/blog/2018-06-18-moving-from-create-react-app-to-gatsby-js/index.md
@@ -265,7 +265,7 @@ I will not go in depth with how to manage state with React since there are a lot
-Since Gatsby builds "static" files you can host them on tons of services. One of my favourites is [Netlify](https://www.netlify.com/). There is also [AWS S3](https://aws.amazon.com/s3/) and more, see the [deploying Gatsby documentation](/docs/deploy-gatsby/) for examples.
+Since Gatsby builds "static" files you can host them on tons of services. One of my favourites is [Netlify](https://www.netlify.com/). There is also [AWS S3](https://aws.amazon.com/s3/) and more, see the [deploying Gatsby documentation](/docs/deploying-and-hosting/) for examples.
## Resources
diff --git a/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md b/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
index 0dcee9305c807..5b3f000135e1e 100644
--- a/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
+++ b/docs/blog/2018-07-07-the-gatsby-plugin-page-creator/index.md
@@ -19,7 +19,7 @@ Here's how it all got started. The goal with [Gatsby Manor](https://gatsbymanor.
is to create professional designed Gatsby starters
to give your site a clean, modern look the moment you create a new project.
While creating our newest starter
-[gatsby-starter-eventually](https://gatsbymanor.com/demo/eventually),
+[gatsby-starter-eventually](https://github.com/gatsbymanor/gatsby-starter-eventually),
I wanted to organize the directory structure of the project to better fit my
workflow.
diff --git a/docs/blog/2018-08-09-swag-store/index.md b/docs/blog/2018-08-09-swag-store/index.md
index 5479741a4ff71..1a2dad0d77206 100644
--- a/docs/blog/2018-08-09-swag-store/index.md
+++ b/docs/blog/2018-08-09-swag-store/index.md
@@ -76,6 +76,6 @@ Thanks for being part of the open source community! 💪💜
[shopify]: https://www.shopify.com/
[js-buy-sdk]: https://shopify.github.io/js-buy-sdk/
[auth0]: https://auth0.com/
-[invite]: https://github.com/gatsbyjs/peril-gatsbyjs/blob/master/org/invite-collaborator.ts
+[invite]: https://github.com/gatsbyjs/peril-gatsbyjs/blob/master/rules/invite-collaborator.ts
[peril]: https://github.com/danger/peril
[contribute]: /docs/how-to-contribute/
diff --git a/docs/blog/2018-1-18-strapi-and-gatsby/index.md b/docs/blog/2018-1-18-strapi-and-gatsby/index.md
index 2c6f8df7e556e..1bc5be969336b 100644
--- a/docs/blog/2018-1-18-strapi-and-gatsby/index.md
+++ b/docs/blog/2018-1-18-strapi-and-gatsby/index.md
@@ -596,7 +596,7 @@ Since the content is managed by Strapi, the authors can write article through a
Feel free to continue this project to discover both Gatsby and Strapi advantages. Here are some features you can add: list of authors, article's categories, and comment system with the Strapi API or Disqus. You can also create other kind of websites (e-commerce shop, corporate website, etc.).
-When your project is achieved, you will probably want to deploy it. The static website generated by Gatsby can [easily be published on storage providers](https://www.gatsbyjs.org/docs/deploy-gatsby/): Netlify, S3/Cloudfront, GitHub pages, GitLab pages, Heroku, etc. The Strapi API is nothing else than a simple Node.js API, so it can be hosted on Heroku or any Linux instance that has Node.js installed.
+When your project is achieved, you will probably want to deploy it. The static website generated by Gatsby can [easily be published on storage providers](https://www.gatsbyjs.org/docs/deploying-and-hosting): Netlify, S3/Cloudfront, GitHub pages, GitLab pages, Heroku, etc. The Strapi API is nothing else than a simple Node.js API, so it can be hosted on Heroku or any Linux instance that has Node.js installed.
The [code source of this tutorial is available on GitHub](https://github.com/strapi/strapi-examples/tree/master/gatsby-strapi-tutorial). To see it live, clone the repository, run `npm run setup`, start the Strapi server (`cd api && strapi start`) and the Gatsby server (`cd blog && npm run develop`).
diff --git a/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md b/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
index f4d834d9fb339..f3811dc677eff 100644
--- a/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
+++ b/docs/blog/2018-10-04-journey-to-the-content-mesh/index.md
@@ -65,7 +65,7 @@ In Part 3, [The Rise of Modern Web Development](/blog/2018-10-11-rise-of-modern-
In Part 4, [Why Mobile Performance is Crucial](/blog/2018-10-16-why-mobile-performance-is-crucial), we’ll discuss the ROI of site speed, explore two modern, complementary trends for improving web performance and how website teams can get the best of both out of the box.
-In our conclusion, [Creating Compelling Experiences](/blog/2018-10-18-creating-compelling-experiences), we’ll discuss a step-by-step approach for choosing a content architecture, modern development environment, a performance strategy -- and most importantly, choosing a "content mesh" that makes all the other choices easy. We’ll also explore how one clear option -- Gatsby -- emerges as the most feature-complete of any content mesh alternatives.
+In our conclusion, [Creating Compelling Experiences](/blog/2018-10-18-creating-compelling-content-experiences), we’ll discuss a step-by-step approach for choosing a content architecture, modern development environment, a performance strategy -- and most importantly, choosing a "content mesh" that makes all the other choices easy. We’ll also explore how one clear option -- Gatsby -- emerges as the most feature-complete of any content mesh alternatives.
## The Modern Website Landscape
diff --git a/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md b/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
index 502e022d0167c..f2dad1839eb13 100644
--- a/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
+++ b/docs/blog/2018-10-12-uptick-docs-contributions-hacktoberfest/index.md
@@ -33,7 +33,7 @@ Here is a summary of the “docs decision tree,” a tool we’ll use to make de
A doc qualifies to be in the .org site if it:
-1. Deals with a piece of Gatsby-maintained software (e.g. pertains to code in the [Gatsby OSS repository](www.github.com/gatsbyjs/gatsby)), a core dependency of the code in the Gatsby OSS repo, or a third-party software that works well with Gatsby and is in high demand
+1. Deals with a piece of Gatsby-maintained software (e.g. pertains to code in the [Gatsby OSS repository](https://www.github.com/gatsbyjs/gatsby)), a core dependency of the code in the Gatsby OSS repo, or a third-party software that works well with Gatsby and is in high demand
> **Yes** --> Belongs in the docs (to make sure we don’t have to maintain docs about core dependencies and third-party software, we will focus on linking to their docs as much as possible)
diff --git a/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md b/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
index 6251889f86897..cb6a47cc3d678 100644
--- a/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
+++ b/docs/blog/2018-10-16-why-mobile-performance-is-crucial/index.md
@@ -112,7 +112,7 @@ For example, if you use a CDN to serve 3MB Javascript bundles, your site is stil
