gatsbyjs · TylerBarnes · Feb 5, 2021 · Feb 5, 2021 · Feb 5, 2021 · Feb 5, 2021
diff --git a/README.md b/README.md
@@ -23,9 +23,22 @@
   </a>
 </p>
 
-# gatsby-source-wordpress@v4 BETA
+# This package is now published as `gatsby-source-wordpress`
 
-This plugin is the official recommended way to use WordPress with Gatsby. We're currently publishing on a separate package to make migrating from `gatsby-source-wordpress@v3` easier. If you're coming from `v3` this allows you to activate the new version of the plugin alongside `gatsby-source-wordpress` and migrate your codebase one piece at a time ⭐️
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/README.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
 
 ## Overview 🌞
 

diff --git a/add-docs-deprecation-notice.js b/add-docs-deprecation-notice.js
@@ -0,0 +1,19 @@
+const deprecationNotice = require(`./plugin/deprecation-notice.json`)
+const fs = require(`fs-extra`)
+const path = require(`path`)
+const globby = require(`globby`)
+
+;(async () => {
+  const docsPaths = await globby(path.join(__dirname, `docs`, `**`, `*.md`))
+
+  for (const mdPath of docsPaths) {
+    const fileContents = await fs.readFile(mdPath, `utf8`)
+    const relativePath = mdPath.replace(__dirname, ``)
+    const hasMovedToMessage = `This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress${relativePath})`
+
+    const newFileContents = `**${hasMovedToMessage}**\n\n${deprecationNotice}\n\n${fileContents}`
+
+    await fs.writeFile(mdPath, newFileContents, { encoding: `utf8` })
+    console.log(`Deprecated ${relativePath}`)
+  }
+})()
diff --git a/docs/community-and-support.md b/docs/community-and-support.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/community-and-support.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Community & Support
 
 Fortunately there are very strong WPGraphQL and Gatsby communities!

diff --git a/docs/debugging-and-troubleshooting.md b/docs/debugging-and-troubleshooting.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/debugging-and-troubleshooting.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Debugging and Troubleshooting
 
 - [Debugging and Troubleshooting](#debugging-and-troubleshooting)

diff --git a/docs/features/caching.md b/docs/features/caching.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/caching.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Build Caching :ballot_box:
 
 Due to our [WPGatsby](https://github.com/gatsbyjs/wp-gatsby) WordPress plugin which tracks data changes in WordPress, we can do very aggressive caching.

diff --git a/docs/features/compatibility-api.md b/docs/features/compatibility-api.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/compatibility-api.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Compatibility API
 
 Because we have so many remote depencies (WordPress, WPGraphQL, and WPGatsby), we've baked a remote compatibility API into this plugin.

diff --git a/docs/features/gatsby-link.md b/docs/features/gatsby-link.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/gatsby-link.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Gatsby Link
 
 Anchor tag src's in html that are links to your WP instance are automatically rewritten to relative links (`https://yoursite.com/beautiful-page` becomes `/beautiful-page`). For this reason, it's recommended to use your WordPress page and post [uri's](https://github.com/TylerBarnes/using-gatsby-source-wordpress-experimental/blob/master/gatsby-node.js#L29) to create your [Gatsby page paths](https://github.com/TylerBarnes/using-gatsby-source-wordpress-experimental/blob/master/gatsby-node.js#L68).

diff --git a/docs/features/graphql-wordpress-and-gatsby.md b/docs/features/graphql-wordpress-and-gatsby.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/graphql-wordpress-and-gatsby.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # GraphQL, WordPress and Gatsby
 
 This document is intended to provide more information on how GraphQL to allow WordPress to be a

diff --git a/docs/features/index.md b/docs/features/index.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/index.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Features
 
 1. :zap: [Build Caching](./caching.md)

diff --git a/docs/features/limit-nodes-during-development.md b/docs/features/limit-nodes-during-development.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/limit-nodes-during-development.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Limit nodes during development
 
 For very large sites it may take quite a while to start `gatsby develop` when you start working on a project. To mitigate this annoyance, we've added a plugin option to limit the number of nodes that will be pulled on any type.

diff --git a/docs/features/media-item-processing.md b/docs/features/media-item-processing.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/media-item-processing.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Image/File Processing & Handling
 
 ## Only referenced media items are sourced

diff --git a/docs/features/preview.md b/docs/features/preview.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/preview.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Preview
 
 This plugin supports [Preview](https://www.gatsbyjs.com/preview/) and has been designed to replicate the normal WordPress admin preview experience as closely as possible.

diff --git a/docs/features/security.md b/docs/features/security.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/security.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Security
 
 This plugin is built with your WP site security in mind. For that reason, we've intentionally left out any authentication options. The reason is that any data fetched by Gatsby should be considered public data. Any Gatsby site may potentially have a publically queryable GraphQL server running when Gatsby is running in Preview mode (either via self-hosted Preview or on Gatsby Cloud). If we were to source data from WordPress while authenticated, all of the data we sourced would be available in Gatsby, which means it could easily be leaked to anyone who happens upon your Preview instance. For this reason, auth options have been intentionally excluded.

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/getting-started.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Installation & Getting Started :baby_chick:
 
 If you've had previous experience with Gatsby or you like to move fast, you can use the quick start steps below to get up and running quickly. If you'd like to take a step back and learn more first, head over to our [tutorials](./tutorials/index.md) :footprints:

diff --git a/docs/hosting.md b/docs/hosting.md
@@ -1,3 +1,20 @@
+**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/hosting.md)**
+
+Hi there! 👋 thank you so much for being a beta/alpha tester of this plugin!
+You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!
+
+We've shipped this plugin as `gatsby-source-wordpress@4.0.0`.
+`gatsby-source-wordpress-experimental` is now deprecated.
+Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.
+
+We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.
+
+Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.
+
+Thank you! 💜
+
+
+
 # Hosting WordPress :house:
 
 Any mid-to-high performance WordPress host will work great. You may also have success on low performance WordPress hosts for smaller or medium sized sites, but a better server is recommended.