Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Added three new sections to the docs #7121

Merged
merged 3 commits into from
Aug 9, 2018
Merged

Added three new sections to the docs #7121

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6a01ea8
Added three new sections to the docs
shannonbux Aug 7, 2018
cfe6d4e
Addressed Sam's feedback
shannonbux Aug 7, 2018
6ecd97c
updated sections
shannonbux Aug 9, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 45 additions & 12 deletions www/src/data/sidebars/doc-links.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,19 +83,30 @@
link: /docs/programmatically-create-pages-from-data/
- title: Querying data with StaticQuery
link: /docs/static-query/
- title: Headless CMS*
link: /docs/headless-cms/
- title: Sourcing content and data*
Copy link
Contributor

@calcsam calcsam Aug 7, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This whole section should be moved before the "Querying Data" section. We should be putting these sections in the order the user would be doing them, similar to the order in https://www.gatsbyjs.com/integrations/ or https://www.gatsbyjs.com/how-it-works/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(this could be done in a separate PR as well, obviously there's more re-ordering)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok! @KyleAMathews initially helped put these in order, so we'll need to sync up about this!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh wait, I was looking at the wrong section header for this comment. So, because Headless CMSs is within this category, wouldn't someone need to know how to query with GraphQL first before reading about Headless CMSs?

Copy link
Contributor

@KyleAMathews KyleAMathews Aug 8, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not a big deal one way or the other but I agree with Sam here that someone new to Gatsby would first want to read a bit about how you can source data from anywhere before they move onto using graphql to pull that data into their components.

link: /docs/sourcing-content-and-data
items:
- title: Netlify CMS
link: /docs/netlify-cms/
- title: WordPress*
link: /docs/wordpress/
- title: Drupal*
link: /docs/drupal/
- title: Contentful*
link: /docs/contentful/
- title: Prose*
link: /docs/prose/
- title: Sourcing from the filesystem*
link: /docs/sourcing-from-the-filesystem/
- title: Sourcing from databases*
link: /docs/sourcing-from-databases/
- title: Sourcing from SaaS services*
link: /docs/sourcing-from-saas-services/
- title: Sourcing from private APIs*
link: /docs/sourcing-from-private-apis/
- title: Headless CMS*
link: /docs/headless-cms/
items:
- title: Sourcing from Netlify CMS
link: /docs/sourcing-from-netlify-cms/
- title: Sourcing from WordPress*
link: /docs/sourcing-from-wordpress/
- title: Sourcing from Drupal*
link: /docs/sourcing-from-drupal/
- title: Sourcing from Contentful*
link: /docs/sourcing-from-contentful/
- title: Sourcing from Prose*
link: /docs/sourcing-from-prose/
- title: Plugins*
link: /docs/plugins/
items:
Expand All @@ -122,6 +133,19 @@
link: /docs/component-css/
- title: PostCSS*
link: /docs/post-css/
- title: Testing*
link: /docs/testing/
items:
- title: Unit testing
link: /docs/unit-testing/
- title: Testing components with GraphQL
link: /docs/testing-components-with-graphql/
- title: End-to-end testing
link: /docs/end-to-end-testing/
- title: Testing CSS-in-JS
link: /docs/testing-css-in-js/
- title: Testing React components
link: /docs/testing-react-components/
- title: Debugging
link: /docs/debugging/
items:
Expand Down Expand Up @@ -161,6 +185,15 @@
link: /docs/linking-between-pages/
- title: Search Engine Optimization (SEO)
link: /docs/seo/
- title: Adding third-party services*
link: /docs/adding-third-party-services/
items:
- title: Adding search*
link: /docs/adding-search/
- title: Adding analytics*
link: /docs/adding-analytics/
- title: Adding forms*
link: /docs/adding-forms/
- title: Performance*
link: /docs/performance/
items:
Expand Down