From a278071c43f81607ff3101e4fd8bcde689566bec Mon Sep 17 00:00:00 2001 From: shannonbux Date: Thu, 9 Aug 2018 15:07:06 -0600 Subject: [PATCH 1/3] Stub Articles and new names @calcsam I think we'll need to use some redirects for these new names, correct? If so, I'm happy to learn from someone how to do that or assign it to someone. Tell me which one you think makes sense! --- docs/docs/sourcing-content-and-data.md | 19 +++++++++++++++++++ docs/docs/sourcing-from-contentful.md | 8 ++++++++ .../{prose.md => sourcing-from-databases.md} | 2 +- .../{wordpress.md => sourcing-from-drupal.md} | 2 +- ...fy-cms.md => sourcing-from-netlify-cms.md} | 2 +- docs/docs/sourcing-from-private-apis.md | 8 ++++++++ .../{contentful.md => sourcing-from-prose.md} | 2 +- docs/docs/sourcing-from-saas-services.md | 8 ++++++++ docs/docs/sourcing-from-the-filesystem.md | 8 ++++++++ docs/docs/sourcing-from-wordpress.md | 8 ++++++++ docs/docs/{drupal.md => testing.md} | 2 +- 11 files changed, 64 insertions(+), 5 deletions(-) create mode 100644 docs/docs/sourcing-content-and-data.md create mode 100644 docs/docs/sourcing-from-contentful.md rename docs/docs/{prose.md => sourcing-from-databases.md} (83%) rename docs/docs/{wordpress.md => sourcing-from-drupal.md} (85%) rename docs/docs/{netlify-cms.md => sourcing-from-netlify-cms.md} (99%) create mode 100644 docs/docs/sourcing-from-private-apis.md rename docs/docs/{contentful.md => sourcing-from-prose.md} (85%) create mode 100644 docs/docs/sourcing-from-saas-services.md create mode 100644 docs/docs/sourcing-from-the-filesystem.md create mode 100644 docs/docs/sourcing-from-wordpress.md rename docs/docs/{drupal.md => testing.md} (91%) diff --git a/docs/docs/sourcing-content-and-data.md b/docs/docs/sourcing-content-and-data.md new file mode 100644 index 0000000000000..dfde034ef14e6 --- /dev/null +++ b/docs/docs/sourcing-content-and-data.md @@ -0,0 +1,19 @@ +--- +title: Sourcing Content and Data +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. + +### Notes on this document: + +Tl;dr: This doc is part of creating an onboarding experience more similar to express/flask/create-react-app/react-static). It will be like a `create-gatsby-app` experience. This will include making it clearer that you can start building with Gatsby without GraphQL (through adding unstructured data, for example) and make it clear that GraphQL is a more "advanced" requirement for ambitious use cases. It will also involve building different CLI's for different types of sites. + +### Why make these big changes? + +- GraphQL learning curve is one of the top 3 pain points of Gatsby users +- GraphQL learning curve drives many people away from Gatsby +- Many people think GraphQL is a requirement for using Gatsby, which isn't true +- Probably 5% need GraphQL but we're making 100% of them go through GraphQL. diff --git a/docs/docs/sourcing-from-contentful.md b/docs/docs/sourcing-from-contentful.md new file mode 100644 index 0000000000000..cf42b20519d54 --- /dev/null +++ b/docs/docs/sourcing-from-contentful.md @@ -0,0 +1,8 @@ +--- +title: Sourcing from Contentful +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. diff --git a/docs/docs/prose.md b/docs/docs/sourcing-from-databases.md similarity index 83% rename from docs/docs/prose.md rename to docs/docs/sourcing-from-databases.md index a49fc9e127a49..9c56ef4192763 100644 --- a/docs/docs/prose.md +++ b/docs/docs/sourcing-from-databases.md @@ -1,5 +1,5 @@ --- -title: Prose +title: Sourcing from Databases --- This is a stub. Help our community expand it. diff --git a/docs/docs/wordpress.md b/docs/docs/sourcing-from-drupal.md similarity index 85% rename from docs/docs/wordpress.md rename to docs/docs/sourcing-from-drupal.md index 7868177aeaf4e..a5827ceca1ead 100644 --- a/docs/docs/wordpress.md +++ b/docs/docs/sourcing-from-drupal.md @@ -1,5 +1,5 @@ --- -title: WordPress +title: Sourcing from Drupal --- This is a stub. Help our community expand it. diff --git a/docs/docs/netlify-cms.md b/docs/docs/sourcing-from-netlify-cms.md similarity index 99% rename from docs/docs/netlify-cms.md rename to docs/docs/sourcing-from-netlify-cms.md index 85996c4cc82fc..d165cd16d0821 100644 --- a/docs/docs/netlify-cms.md +++ b/docs/docs/sourcing-from-netlify-cms.md @@ -1,5 +1,5 @@ --- -title: Netlify CMS +title: Sourcing from Netlify CMS --- In this guide, we'll walk through setting up a site with content management using [Netlify diff --git a/docs/docs/sourcing-from-private-apis.md b/docs/docs/sourcing-from-private-apis.md new file mode 100644 index 0000000000000..dc36662a8dc66 --- /dev/null +++ b/docs/docs/sourcing-from-private-apis.md @@ -0,0 +1,8 @@ +--- +title: Sourcing from Private APIs +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. diff --git a/docs/docs/contentful.md b/docs/docs/sourcing-from-prose.md similarity index 85% rename from docs/docs/contentful.md rename to docs/docs/sourcing-from-prose.md index 9554c8070437c..5db28e5e73389 100644 --- a/docs/docs/contentful.md +++ b/docs/docs/sourcing-from-prose.md @@ -1,5 +1,5 @@ --- -title: Contentful +title: Sourcing from Prose --- This is a stub. Help our community expand it. diff --git a/docs/docs/sourcing-from-saas-services.md b/docs/docs/sourcing-from-saas-services.md new file mode 100644 index 0000000000000..7c03f04fb84ff --- /dev/null +++ b/docs/docs/sourcing-from-saas-services.md @@ -0,0 +1,8 @@ +--- +title: Sourcing from SaaS Services +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. diff --git a/docs/docs/sourcing-from-the-filesystem.md b/docs/docs/sourcing-from-the-filesystem.md new file mode 100644 index 0000000000000..77d034bed3523 --- /dev/null +++ b/docs/docs/sourcing-from-the-filesystem.md @@ -0,0 +1,8 @@ +--- +title: Sourcing from the Filesystem +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. diff --git a/docs/docs/sourcing-from-wordpress.md b/docs/docs/sourcing-from-wordpress.md new file mode 100644 index 0000000000000..0b63d3cc9b75a --- /dev/null +++ b/docs/docs/sourcing-from-wordpress.md @@ -0,0 +1,8 @@ +--- +title: Sourcing from WordPress +--- + +This is a stub. Help our community expand it. + +Please use the [Gatsby Style Guide](/docs/gatsby-style-guide/) to ensure your +pull request gets accepted. diff --git a/docs/docs/drupal.md b/docs/docs/testing.md similarity index 91% rename from docs/docs/drupal.md rename to docs/docs/testing.md index 4cc60f30d82b0..ac14fbfc402d1 100644 --- a/docs/docs/drupal.md +++ b/docs/docs/testing.md @@ -1,5 +1,5 @@ --- -title: Drupal +title: Testing --- This is a stub. Help our community expand it. From c5f32f968a4c35b57836759a87959295f16060d6 Mon Sep 17 00:00:00 2001 From: shannonbux Date: Thu, 9 Aug 2018 16:33:33 -0600 Subject: [PATCH 2/3] Where to put this in the sidebar? #6810 Wondering where to put this doc in the left hand sidebar. --- docs/docs/custom-components.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/docs/custom-components.md diff --git a/docs/docs/custom-components.md b/docs/docs/custom-components.md new file mode 100644 index 0000000000000..e69de29bb2d1d From 90bed1384c1ddd039100b56982351281794be03a Mon Sep 17 00:00:00 2001 From: shannonbux Date: Fri, 10 Aug 2018 14:18:59 -0600 Subject: [PATCH 3/3] redirect for `/netlify-cms/` ok @calcsam hope I did this correctly! --- www/gatsby-node.js | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/www/gatsby-node.js b/www/gatsby-node.js index b2ae38f9d41b9..92bf9d51b3770 100644 --- a/www/gatsby-node.js +++ b/www/gatsby-node.js @@ -41,6 +41,13 @@ exports.createPages = ({ graphql, actions }) => { isPermanent: true, }) + createRedirect({ + fromPath: `/docs/netlify-cms`, + isPermanent: true, + redirectInBrowser: true, + toPath: `/docs/sourcing-from-netlify-cms`, + }) + return new Promise((resolve, reject) => { const docsTemplate = path.resolve(`src/templates/template-docs-markdown.js`) const blogPostTemplate = path.resolve(`src/templates/template-blog-post.js`)