From fb49cd9757abf158bd473d417ec73b2a782116f4 Mon Sep 17 00:00:00 2001 From: Marcy Sutton Date: Wed, 19 Jun 2019 05:01:22 -0700 Subject: [PATCH] fix(tutorials): rename "advanced" to "additional (#14847) * fix(tutorials): advanced -> additional This gives us room to add step-by-step content that isn't necessarily advanced in nature ahead of the big Tutorials overhaul * Update www/gatsby-node.js Co-Authored-By: Sidhartha Chatterjee --- docs/tutorial/additional-tutorials.md | 7 ++++++ docs/tutorial/advanced-tutorials.md | 7 ------ docs/tutorial/index.md | 6 ++--- docs/tutorial/part-eight/index.md | 2 +- www/gatsby-node.js | 7 +++++- www/src/data/sidebars/doc-links.yaml | 2 -- www/src/data/sidebars/tutorial-links.yaml | 4 ++-- www/src/pages/docs/index.js | 28 +++++++++-------------- 8 files changed, 30 insertions(+), 33 deletions(-) create mode 100644 docs/tutorial/additional-tutorials.md delete mode 100644 docs/tutorial/advanced-tutorials.md diff --git a/docs/tutorial/additional-tutorials.md b/docs/tutorial/additional-tutorials.md new file mode 100644 index 0000000000000..006155a2a91a3 --- /dev/null +++ b/docs/tutorial/additional-tutorials.md @@ -0,0 +1,7 @@ +--- +title: Additional Tutorials +--- + +There are many use cases for Gatsby, from the very common "happy paths" to more specific and complex integrations. With additional Gatsby tutorials, learn about more topics that go beyond [the basics](/tutorial/) and gain development superpowers. + + diff --git a/docs/tutorial/advanced-tutorials.md b/docs/tutorial/advanced-tutorials.md deleted file mode 100644 index bb79193e6849f..0000000000000 --- a/docs/tutorial/advanced-tutorials.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Advanced Tutorials ---- - -There are many use cases for Gatsby, from the very common "happy paths" to more specific and complex integrations. With the advanced Gatsby tutorials, learn about topics that go beyond [the basics](/tutorial/) and gain development superpowers. - - diff --git a/docs/tutorial/index.md b/docs/tutorial/index.md index 72100973d86f1..0b38a5cc5e2bf 100644 --- a/docs/tutorial/index.md +++ b/docs/tutorial/index.md @@ -23,8 +23,8 @@ In these intermediate tutorials, you'll learn how to pull data from almost anywh 7. [Programmatically create pages from data](/tutorial/part-seven/): Learn how to programmatically create a set of pages for your blog posts. 8. [Preparing a site to go live](/tutorial/part-eight/): Learn how to audit your site for performance and best practices for accessibility, SEO, and more. -## Advanced tutorials +## Additional tutorials -There are many use cases for Gatsby, some which aren't covered in beginner or advanced tutorials to keep you focused while learning. The advanced Gatsby tutorials section is a collection of advanced use cases shown step-by-step, such as using source plugins for images and CMS content. +There are many use cases for Gatsby, some which aren't covered in the first set of tutorials to keep you focused while learning. Gatsby's Additional Tutorials section is a collection of resources showing how to complete even more Gatsby tasks step-by-step, such as using source plugins for images and CMS content. -Go deeper with the [advanced Gatsby tutorials](/tutorial/advanced-tutorials/). +Go deeper with [additional Gatsby tutorials](/tutorial/additional-tutorials/). diff --git a/docs/tutorial/part-eight/index.md b/docs/tutorial/part-eight/index.md index 290a742ede708..37728e600e87e 100644 --- a/docs/tutorial/part-eight/index.md +++ b/docs/tutorial/part-eight/index.md @@ -247,7 +247,7 @@ Lighthouse is a great tool for site improvements and learning -- Continue lookin ## That's all, folks -Well, not quite; just for this tutorial. There are also [Advanced Tutorials](/tutorial/advanced-tutorials/) to check out for more guided use cases. +Well, not quite; just for this tutorial. There are [Additional Tutorials](/tutorial/additional-tutorials/) to check out for more guided use cases. This is just the beginning. Keep going! diff --git a/www/gatsby-node.js b/www/gatsby-node.js index 9d8b13bc0ba54..34163212a9042 100644 --- a/www/gatsby-node.js +++ b/www/gatsby-node.js @@ -268,7 +268,12 @@ exports.createPages = ({ graphql, actions, reporter }) => { createRedirect({ fromPath: `/docs/advanced-tutorials/`, - toPath: `/tutorial/advanced-tutorials/`, + toPath: `/tutorial/additional-tutorials/`, + isPermanent: true, + }) + createRedirect({ + fromPath: `/tutorial/advanced-tutorials/`, + toPath: `/tutorial/additional-tutorials/`, isPermanent: true, }) createRedirect({ diff --git a/www/src/data/sidebars/doc-links.yaml b/www/src/data/sidebars/doc-links.yaml index 9fb87d1a635c7..8197207bf86a7 100644 --- a/www/src/data/sidebars/doc-links.yaml +++ b/www/src/data/sidebars/doc-links.yaml @@ -530,8 +530,6 @@ link: /docs/gatsby-vendor-partnership/ - title: Agency Partnership Program link: /docs/gatsby-agency-partnership/ - - title: Advanced Tutorials - link: /tutorial/advanced-tutorials/ - title: Commands (Gatsby CLI) link: /docs/gatsby-cli/ - title: Cheat Sheet diff --git a/www/src/data/sidebars/tutorial-links.yaml b/www/src/data/sidebars/tutorial-links.yaml index e8eb9b2c0d494..2bb0a3b707239 100644 --- a/www/src/data/sidebars/tutorial-links.yaml +++ b/www/src/data/sidebars/tutorial-links.yaml @@ -111,8 +111,8 @@ link: /tutorial/part-eight/#add-page-metadata - title: Keep making it better link: /tutorial/part-eight/#keep-making-it-better - - title: Advanced Tutorials - link: /tutorial/advanced-tutorials/ + - title: Additional Tutorials + link: /tutorial/additional-tutorials/ items: - title: Making a Site with User Authentication link: /tutorial/authentication-tutorial/ diff --git a/www/src/pages/docs/index.js b/www/src/pages/docs/index.js index d950c895fa0c9..013e03ce828c3 100644 --- a/www/src/pages/docs/index.js +++ b/www/src/pages/docs/index.js @@ -27,13 +27,14 @@ class IndexRoute extends React.Component {

Gatsby is a blazing fast modern site generator for React.

Get Started

-

There are four main ways to get started with Gatsby:

+

There are five main ways to get started with Gatsby:

  1. - Tutorial: Step-by-step instructions - on how to install Gatsby and start a project: written for people - without Gatsby or web development experience, though it has - helped developers of all skill levels. + Tutorials: Step-by-step + instructions on how to install Gatsby and start a project: + written for people without Gatsby or web development experience, + though these learning resources have helped developers of all + skill levels.
  2. Quick start: One page @@ -53,11 +54,6 @@ class IndexRoute extends React.Component { about the many different topics around building with Gatsby, like sourcing data, deployment, and more.
    3. -
  3. - Ecosystem: Check out libraries - for Gatsby starters and plugins, as well as external - community resources. -
  4. Gatsby API Reference: Learn more about Gatsby APIs and configuration. @@ -77,13 +73,6 @@ class IndexRoute extends React.Component { Gatsby Internals: Dig into how Gatsby works behind the scenes.
    5. -
  5. - - Advanced Tutorials - - : Learn about topics that are too large for a doc and - warrant a tutorial. -
  6. Using Gatsby Professionally @@ -94,6 +83,11 @@ class IndexRoute extends React.Component {
    7. +
  7. + Check out the Ecosystem libraries + for Gatsby starters and plugins, as well as external community + resources. +

Visit the Contributing section to