chore(docs): Add reference guide "Modifying a Starter" #18995

AishaBlake · 2019-10-25T01:27:22Z

Description

This change introduces a new Reference Guide on modifying starters. Topics include:

Choosing a starter
Exploring the folder structure
Adding content
Querying data
Customizing styles

I'd love feedback on this, especially since it's my first Gatsby PR! Please let me know if you see parts that could be reworded or if I'm missing any important topics. I'd also particularly like to know if there are areas where my adherence to the style guide could be improved. Thanks so much in advance!

Related Issues

Addresses #18116

marcysutton

I LOVE this! It's very well written and gently guides the user into modifying a starter. I think users will love it!

I left a few small suggestions of things we could change, though it's already in great shape! A future project could be to ensure we have parity with theme docs explanations, e.g. for modifying a theme. There is a related issue of #18242...I wanted to connect the dots here for broader context.

Thanks for the PR, let me know if you have any questions or need clarification on anything!

docs/docs/modifying-a-starter.md

marcysutton · 2019-10-26T22:51:00Z

docs/docs/modifying-a-starter.md

+
+Taking the default Gatsby starter as an example, dedicate some time to looking through some of the most important files in the repository (repo). You'll find most of these in the root (or _main_) folder of your project. Doing so will give you a clearer picture of how the various parts of your Gatsby site work together.
+
+![Default starter file structure in VS Code](./images/default-starter-file-structure.png)


Love the image; it will help visual learners find their way around. It renders quite large on my screen compared to the surrounding text, probably due to a higher pixel density from a retina screen. I usually output images at 72 ppi from Photoshop to get them to render at a 1:1 in my browser, but CSS could also be worth a shot? I'm open to ideas. It will end up being a tall, skinny image, so you could consider showing more of the IDE to create a horizontal image.

Yes, totally agreed on the size issue. I went with showing more of the editor but blurred the rest of it out. I think this will give just a little more context and still keep the focus on the structure.

docs/docs/modifying-a-starter.md

marcysutton · 2019-10-26T22:54:31Z

docs/docs/modifying-a-starter.md

+}
+```
+
+Elsewhere on the site, GraphQL queries access that data and display it in the browser. The `Layout` component, for instance, runs a query for `siteMetaData`'s `title` property. It then passes that value to the `Header` component via props:


Suggested change

Elsewhere on the site, GraphQL queries access that data and display it in the browser. The `Layout` component, for instance, runs a query for `siteMetaData`'s `title` property. It then passes that value to the `Header` component via props:

Elsewhere on the site, GraphQL queries access that data and display it in the browser. The `Layout` component, for instance, runs a query for `siteMetadata`'s `title` property. It then passes that value to the `Header` component via props:

marcysutton · 2019-10-26T23:05:40Z

docs/docs/modifying-a-starter.md

+import React from "react"
+
+const Header = (
+  { siteTitle } // highlight


Suggested change

{ siteTitle } // highlight

{ siteTitle } // highlight-line

marcysutton · 2019-10-26T23:05:47Z

docs/docs/modifying-a-starter.md

+            textDecoration: `none`,
+          }}
+        >
+          {siteTitle} // highlight


Suggested change

{siteTitle} // highlight

{siteTitle} // highlight-line

marcysutton · 2019-10-26T23:05:59Z

docs/docs/modifying-a-starter.md

+export default Header
+```
+
+Try adding a property to `siteMetaData`, querying for it, and displaying the data on a page of your site. The Gatsby docs have a great introduction to [querying your data with GraphQL](/docs/graphql/).


Suggested change

Try adding a property to `siteMetaData`, querying for it, and displaying the data on a page of your site. The Gatsby docs have a great introduction to [querying your data with GraphQL](/docs/graphql/).

Try adding a property to `siteMetadata`, querying for it, and displaying the data on a page of your site. The Gatsby docs have a great introduction to [querying your data with GraphQL](/docs/graphql/).

marcysutton · 2019-10-26T23:07:07Z

docs/docs/modifying-a-starter.md

+
+You may even choose a specific starter _because_ of its approach to styling. Search the [Gatsby Starter Library](/starters/) using category filters prefixed with "Styling:" and choose the option(s) that best fit your project.
+
+![Starter Library with Styling:SCSS filter selected](./images/starter-library-scss-filter.png)


This image looks great! Awesome way to finish the section.

marcysutton · 2019-10-26T23:09:23Z

docs/tutorial/part-one/index.md

@@ -20,7 +20,7 @@ When creating a new Gatsby site, you can use the following command structure to
 gatsby new [SITE_DIRECTORY_NAME] [URL_OF_STARTER_GITHUB_REPO]
 ```

-If you omit a URL from the end, Gatsby will automatically generate a site for you based on the [**default starter**](https://github.com/gatsbyjs/gatsby-starter-default). For this section of the tutorial, stick with the “Hello World” site you already created in tutorial part zero.
+If you omit a URL from the end, Gatsby will automatically generate a site for you based on the [**default starter**](https://github.com/gatsbyjs/gatsby-starter-default). For this section of the tutorial, stick with the “Hello World” site you already created in tutorial part zero. You can learn more about [modifying starters](/docs/modifying-a-starter) in the docs.


We've talked at times about limiting links in the tutorial to keep learners focused. This one is really compelling to add, however, as it's relevant to the task at hand (and people asked us for it in a Getting Started unconference session). My instinct is to keep it in, as there isn't a very good spot for it at the end of Tutorial Part One. It seems like it fits the best here.

Thanks! I did see a note about avoiding linking away from the tutorial. If you hadn’t mentioned it as an option in the related issue, I probably would’ve left this out. Especially given that new-to-Gatsby folks seem to be wondering how to modify a starter (I asked around a bit before writing this), I thought it would be useful here.

Sounds wise! Let's keep it.

Co-Authored-By: Marcy Sutton <[email protected]>

AishaBlake · 2019-10-27T16:16:06Z

Thank you so much, @marcysutton!! I started going through and approving the suggestions but I think I’m going to leave the rest until I’m back at a computer tomorrow (Monday) morning. I truly appreciate the thoughtful, thorough review!

AishaBlake · 2019-10-28T16:48:05Z

@marcysutton, I think this is ready for another review!

marcysutton · 2019-10-28T22:48:34Z

docs/docs/modifying-a-starter.md

+
+Taking the default Gatsby starter as an example, dedicate some time to looking through some of the most important files in the repository (repo). You'll find most of these in the root (or _main_) folder of your project. Doing so will give you a clearer picture of how the various parts of your Gatsby site work together.
+
+![Default starter file structure in VS Code](./images/default-starter-vs-code-focus.png)


Thanks for your patience on this -- I think we should try one more take at the image here, especially since the previous paragraph talks about a "clearer picture". The sidebar is pretty small now with the whole VS Code interface; is it possible to crop it to the file list without the app buttons, header, or footer? I'd recommend keeping the file view area clear instead of blurring it, potentially with gatsby-config.js open for additional context. What do you think of something like this (I couldn't seem to increase the sidebar font size independently from the file area)?

I wound up zooming in and then making the editor font smaller. Thoughts on this one? Just sending the image since my connection is pretty spotty right now. Everything's taking longer than usual. 😅

This is definitely an improvement. It's hard to fit it all in! I'd be good with this one, but I'll let @marcysutton have the final say.

Thanks, @laurieontech, and congratulations!! I just pushed the project up with that screenshot since we're about to get back on the road. We should arrive in Curitiba in about 5 hours. We'll be staying in a hotel there, so fingers crossed for more reliable WiFi!

I think this works! let's go for it!

marcysutton

I'm so excited about this change! I'm going to approve and merge it in. Thanks for the PR!

gatsbot · 2019-10-29T18:43:33Z

Holy buckets, @AishaBlake — we just merged your PR to Gatsby! 💪💜

Gatsby is built by awesome people like you. Let us say “thanks” in two ways:

We’d like to send you some Gatsby swag. As a token of our appreciation, you can go to the Gatsby Swag Store and log in with your GitHub account to get a coupon code good for one free piece of swag. We’ve got Gatsby t-shirts, stickers, hats, scrunchies, and much more. (You can also unlock even more free swag with 5 contributions — wink wink nudge nudge.) See gatsby.dev/swag for details.
We just invited you to join the Gatsby organization on GitHub. This will add you to our team of maintainers. Accept the invite by visiting https://github.com/orgs/gatsbyjs/invitation. By joining the team, you’ll be able to label issues, review pull requests, and merge approved pull requests.

If there’s anything we can do to help, please don’t hesitate to reach out to us: tweet at @gatsbyjs and we’ll come a-runnin’.

Thanks again!

* chore(docs): add lines to express need for plugin to prevent F… (#18595) * fix(gatsby-theme-blog): remove extension on bio-content import (#18555) Co-authored-by: GatsbyJS Bot <[email protected]> * chore(showcase): Add haxzie.com (#18717) * Showcase: Add haxzie.com to sites.yml Showcasing my personal blog which is built with Gatsby :sparkles: * Fix typo in url * chore(docs): Update docs to adhere to style guide (#18656) * Changed we/our to you/your * Change you/your to we/our * Change we/our to you/your * Change sentences with we to be more direct * Format documents * Update docs/docs/production-app.md Changing it to "you" doesn't make sense here. Co-Authored-By: Lennart <[email protected]> * Update docs/docs/production-app.md Using "Gatsby" makes more sense than using "you" here Co-Authored-By: Lennart <[email protected]> * Update docs/docs/production-app.md Using "Gatsby" makes more sense than using "you" here Co-Authored-By: Lennart <[email protected]> * Update docs/docs/production-app.md Using "Gatsby" makes more sense than using "you" here Co-Authored-By: Lennart <[email protected]> * chore(docs): Replaced occurences of 'we' and 'our' with 'you'… (#18696) Co-authored-by: Dallin Noel Skinner <[email protected]> * chore(docs): Title Casing Update (#18706) * chore(showcase): Add plenty of fish, bitcoin.com, frame.io and… (#18667) Co-authored-by: Lennart <[email protected]> * chore(docs): Used “you” and "you're" as the pronoun (#18707) * chore(docs): Title Casing update (#18708) * chore(docs): Used “you'll” instead of "we'll" (#18709) * chore(docs): Updated the pronouns used (#18710) * chore(docs): Minor grammar correction (#18712) * chore(showcase): Add PearlyPlan.com to site showcase (#18643) * Add PearlyPlan.com to site showcase * sites.yml * fix categories Co-authored-by: Lennart <[email protected]> * chore(docs): Updated pronouns usage (#18711) * chore(docs): Updated pronouns usage * chore(docs): updated wording of example * chore(docs): Replace 'our' with 'your' in adding-markdown-page… (#18700) * chore(docs): Update index.md to adhere to Gatsby style guide (#18724) Updated case of heading for tutorial: zero link * chore(docs): Add freecodecamp community to other resources sec… (#18725) * fix(gatsby-plugin-netlify): cast `status` to string (#18726) * fix(gatsby-plugin-netlify): cast `status` to string * Update create-redirects.js * chore(showcase): wedoplugins.com (#18693) * wedoplugins.com website added to sites.yml * newline added * chore(gastby-plugin-sharp): Use createContentDigest helper (#18139) * chore(gastby-plugin-sharp): Use createContentDigest helper Updates the plugin to use the help instead of manually handling the crypto work. Functions were added to the pass the helper down into the process-file module, similar to how setBoundActionCreators was working but with an extra level. Relates to #8805 * chore(gastby-plugin-sharp): Use createContentDigest from core-utils * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] * fix(creators): update AJonP Logo to new Branding (#18735) * Adding AJonP as creator and site * fixing aj's categories * updated icon * add anchors blog post * Revert "add anchors blog post" This reverts commit 967c41cf4ce47031703cc7b0d2a0b641d650deaa. * chore(showcase): add Dashbouquet (#18505) * add site to showcase * Update docs/sites.yml Co-Authored-By: Ward Peeters <[email protected]> * Update docs/sites.yml Co-Authored-By: Ward Peeters <[email protected]> * chore(showcase): Add North X South (#18701) * chore(showcase): Add yangmuzi.com (#18730) * Added a GatsBy blog side project * Added a Gatsby blog side project to the sites.yml * starters(readme): fix broken link (#18739) * fix flow version in .flowconfig (#18734) * grouping together minor updates in renovate.json rule (#18644) * grouping together minor updates in renovate.json rule * adding rule for patch updates * docs: Added rus and ukr articles to awesome-gatsby-resources (#18722) * chore(docs): Clear up wording in Winning Over Stakeholders (#18746) * chore(docs): three new resources to the Gatsby tutorials section (#18729) * Update awesome-gatsby-resources.md * remove duplicates * chore(docs): p-files Part2 - adjust headlines according to style guide + adjust some texts (#18716) * adjust headlines & titles to fit style guide + adjust some texts * revert non-descriptive headline * revert change * chore(blog): Grammar fix (#18747) * Update according to Style Guide Minor fixes on the following *Title casing* *Grammar* * revert title change * refactor(gatsby-cli): replace react-redux with React context (#18752) * chore(docs):title case and punctuation fixes (#18750) * chore(release): Publish - [email protected] - [email protected] * chore(docs): Grammar fixes (#18751) * Grammar fixes for docs-contributions.md * Update community-contributions.md Minor grammar change (redundancy) * chore(blog): Fix broken link (#18737) * Fix broken link Fix broken link to **gatsby-plugin-segment-js** docs * Update docs/blog/2019-08-30-speed-up-your-time-to-interactive-by-delaying-third-party-scripts/index.md Co-Authored-By: Michael <[email protected]> * added Pagepro as creator (#18756) Co-authored-by: Chris (Krzysztof) Lojniewski <[email protected]> * chore(showcase): Remove two categories from entries (#18757) * chore(docs): i-files - adjust headlines according to style gui… (#18695) * i-files: adjust headlines according to style guide + adjust some texts * trigger circleCi * revert some text changes * chore(showcase): Add robinwieruch.de (#18761) * chore(docs): Update README.md (#18733) * Update README.md Improved documentation * docs(themes): Update README.md Followed Prettier code style * Update themes/README.md Co-Authored-By: Michael <[email protected]> * Update README.md update the doc with appropriate link * Update README.md * Update README.md * Update themes/README.md Co-Authored-By: Lennart <[email protected]> * Update README.md * docs(www): Use yarn consistently in the README.md file (#18755) * docs(www): Use yarn consistently in the README.md file * Update www/README.md Co-Authored-By: Lennart <[email protected]> * chore(sites): remove sites that are no longer gatsby sites (#18765) * docs: preprocessing external images page (#17497) * Initial work on preprocessing external images page * Applying Lennart's suggestions from code review Co-Authored-By: Lennart <[email protected]> * Finishing up initial draft of post & adding images * Apply suggestions from Muescha code review Co-Authored-By: Michael <[email protected]> * Removing 2nd "That said" in intro paragraphs * Apply suggestions from code review Co-Authored-By: Michael <[email protected]> * Update docs/docs/preprocessing-external-images.md Co-Authored-By: Michael <[email protected]> * Update docs/docs/preprocessing-external-images.md Co-Authored-By: Michael <[email protected]> * Update preprocessing-external-images.md * Updating with changes suggested by Muescha and Lennart * adding punctuation * Apply suggestions from code review Co-Authored-By: Michael <[email protected]> * Update docs/docs/preprocessing-external-images.md Co-Authored-By: Michael <[email protected]> * Apply suggestions from code review Co-Authored-By: Marcy Sutton <[email protected]> * Adding alt text for featured image through guide * Update docs/docs/preprocessing-external-images.md Co-Authored-By: Michael <[email protected]> * Apply suggestions from code review Co-Authored-By: Marcy Sutton <[email protected]> * Adding paragraph for mentioning Schema Customization API before code snippet As well, renaming all instances of "blogpost" to "blog post" so the post is consistent. * Add note that new node is not part of frontmatter * Apply suggestions from code review Co-Authored-By: Marcy Sutton <[email protected]> * revert svg changes * chore: remove svg changes * docs: removing stub for reach router doc (#18784) * Adding docs to reach router * Update docs/docs/reach-router-and-gatsby.md Co-Authored-By: Mae Capozzi <[email protected]> * Update docs/docs/reach-router-and-gatsby.md Co-Authored-By: Mae Capozzi <[email protected]> * Update docs/docs/reach-router-and-gatsby.md Co-Authored-By: Kyle Gill <[email protected]> * Tweaks to wording based on suggestions * chore(themes): move themes into starters and packages (#18794) * Move theme starters into starters * Move themes into packages * Remove themes directory * Cleaned up the renovate config * Cleaned up the lerna config * Cleaned up the CI config * Exclude theme starters from markdown-magic * Cleaned up themes package.json * fix dependencies in yarn.lock * add missing peer dependency * fix(gatsby-plugin-feed): Remove wrong overriding in plugin-feed (#18793) * fix(gatsby-cli): re-add reporter._setStage as no-op function (#18797) * fix(gatsby-cli): re-add reporter._setStage as no-op function * fix version range in comment * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * fix(www): fix issue with showcase titles (#18799) * chore(docs):Replaced the word 'easy' to use more inclusive lan… (#18813) * moving content around * Topics/free headless cms (#18694) * Add blog post - free headless CMS * add updates to free CMS blog posts * removed "gatsby-plugin-sharp duotone fixed 2" * Fix linting * chore(showcase): add visitrestore.com (#18814) * chore(showcase): add visitrestore.com   ## Description  ## Related Issues  * chore: format * fix(showcase): URL change from evergov to papergov in showcase (#18773) * chore(docs): Remove reach-router stub asterisk from sidebar (#18800) * chore(showcase): Add regex.guide (#18789) * feat(gatsby): Move webpackCompilationHash into app-data.json (#16686) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] * refactor(gatsby-transformer-sharp): Use explicit graphql type definition vs inferring (#18871) * refactor(gatsby-transformer-sharp): Use explicit graphql type definition vs inferring (#17531) * Change minimal version of gatsby dependency to the one having schema customization API * feat(showcase): add Rockwong Blog (#18772) * Rockwong Blog added to showcase Added Rockwong which is a techncal blog containing content realted to various web technologies. * Update docs/sites.yml Updated main url of the blog built by Gatsby Co-Authored-By: Michal Piechowiak <[email protected]> * chore(starters): add iceberg-gatsby-multilang (#18807) * chore(starters): add iceberg-gatsby-multilang * chore(starters): add iceberg-gatsby-multilang * chore(starters): add iceberg-gatsby-multilang * fixing syntaxe * feat(showcase): add diff001a's blog (#18770) * diff001a's blog added diff001a's blog which contains blogs realted to programming is added to Showcase * Update sites.yml * chore(release): Publish - [email protected] - [email protected] - [email protected] * fix(www): mobile nav for iPhone X (#18845) * fix: fix bottom navbar on Iphone X * fix: remove unused property * fix: (gatsby-plugin-mdx)update readme (#18885) * Update working-with-images-in-markdown.md (#18825) * Update gatsby-in-the-enterprise.md (#18826) * Update working-with-gifs.md (#18829) Fix grammar * Gatsby Style Guide for Title (#18824) Keeping consistent with other Gatsby title's that are using "with" as lowercase on their titles. * Updated with of title to lowercase (#18859) Updated with of title to lowercase to make it consistent with other titles. * chore(docs): Update pronouns on "Behind the scenes" (#18428) * updated doc to use you and your * updated doc to use you and your * updated last q doc to use you and your * Update docs/docs/query-behind-the-scenes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-behind-the-scenes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-execution.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/query-extraction.md Co-Authored-By: Marcy Sutton <[email protected]> * Issue for image heavy site (#18421) * chore(docs): Fix MD syntax in MDX docs (#18766) * Fix and add syntax Fix rendering syntac inside `code` for `table` and `tr` and add examples of `code` and `pre`. * chore: format Co-authored-by: GatsbyJS Bot <[email protected]> * chore(starters): add MDX to gatsby-starter-morning-dew (#18832) * chore(starters): gatsby-starter-grayscale-promo (#18815) * gatsby-starter-grayscale-promo * tags fixed * move to bottom Co-authored-by: Lennart <[email protected]> * chore(docs): Fix broken link (docs/audit with Lighthouse) (#18837) * Updated "with" in lowercase in title. (#18861) Updated "with" in lowercase in title to make it more consistent with other titles. * chore(showcase): Add Utah Pumpkins (#18842) Co-authored-by: Lennart <[email protected]> * chore(docs): Replace 'our' with 'your' in bulma and blog docs (#18876) * chore(showcase): Add mysteps.netlify.com (#18846) * Added mysteps.netlify.com to sites.yml. Thanks! * chore: format Co-authored-by: Lennart <[email protected]> Co-authored-by: GatsbyJS Bot <[email protected]> * chore(starters): gatsby-tailwind-emotion-starter (#18888) * Add gatsby-tailwind-emotion-starter to starters.yml * Fix backticks Co-authored-by: Lennart <[email protected]> * chore(showcase): Add Keycodes to showcase (#18868) Co-authored-by: Lennart <[email protected]> * chore(docs): Update query-extraction - fixed some broken links (#18878) * Update query-extraction.md Found some broken links that were easy enough to fix. * Update query-extraction.md Co-authored-by: Lennart <[email protected]> * chore(showcase): Add two sites to sites.yml and add author fie… (#18869) * Adds two sites to sites.yml and adds author field I already had one site on here and updated who authored it. * remove community category Co-authored-by: Lennart <[email protected]> * chore(showcase): Removing Mixkit (#18880) The Site Showcase found it was no longer a Gatsby site (now using NextJS), so I'm removing it from the showcase * chore(showcase): Add Global Adviser Alpha (#18870) Co-authored-by: Keeko Montojo <[email protected]> Co-authored-by: Lennart <[email protected]> * chore(showcase): Add Roger Ramos Journal (#18843) Co-authored-by: Lennart <[email protected]> * chore(docs): Update with in lowercase in title (#18860) Update "with" lowercase in title to make it consistent with other titles. * chore(docs): clarify the message about links (#18899) * [contributing] I18n onboarding doc (#18424) * add translation guide * add links to docs on community page * add more info about team conventions * PR feedback * PR feedback, updates from reviews * more feedback and linting! * last bits of PR feedback * update heading levels for maintainer section * chore(docs): make ordered list more consistent (#18900) * make ordered list more consistent * chore: format Co-authored-by: GatsbyJS Bot <[email protected]> * adding bululueventos.cl (#18901) Co-authored-by: Lennart <[email protected]> * fix(blog): Fixing the link (#18905) * fix(gatsby-source-wordpress): add undefined check to avoid mapPostsToTagsCategories error (#18895) * fix(gatsby-cli): properly update chalk color level (#18533) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * Convert docs introduction to mdx (#18014) * docs: convert docs introduction to mdx * docs: remove table of contents * feat(gatsby-source-drupal): secrets and delete functionality (#18345) * added functionality to delete nodes and enforce secret for more secure preview instances * added documentation for secret in config * updated handleWebhookData and destructured varaibled from request * using deleteNode from actions * deleteNode working and reporting deleted node to user * updated documentation on using secrets to be consistent with the rest of the readme. * change destructuring due to failing tests * fix undefined res * added return for lint * chore(release): Publish - [email protected] * fix(gatsby): ensure `@childOf` adds convenience fields before root field arguments (#18935) * Added failing test for the convenience root field * Ensure convenience fields are added before root field arguments * feat(gatsby): Ensure status is set to Failed for thrown errors or panicOnBuild in plugins (#18887) * cause gatsby develop to error for errored createPages in plugins * add ActivityErrored action to list of internal actions * ensure activity.end() is called after activity.panicOnBuild * override reporter panicOnBuild in plugins * flag progress activity when panicOnBuild is called instead of ending immediately * fail `createPagesStatefully` activity on errors * fail activity on errors in `onCreatePage` * add test to assert that calling reporter.panicOnBuild will fail the activity * use localReporter variable to prevent code duplication * fix: fix overriding default options of `gatsby-plugin-page-creator` on Windows (#18828) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * chore(docs): update to match the starter (#18947) * Updates author information for Ilesh (#18948) * Remove Azure Pipeline runs since Windows tests run on CircleCI * Add gatsby-plugin-colorblind-filters to Hacktoberfest blog post (#18938) * docs: fix incorrect filename (#18955) `import "./commands"` is actually found in `cypress/support/index.js` . I think this either changed recently by Cypress or was an error. This PR proposes changing filename from `cypress/support/commands.js` to `cypress/support/index.js` where `import "./commands"` is now found. * fix(www): use UTC timezone to display dates on events page (#18954) * Add UTC timezone The source of the dates, Airtable was changed to send dates using UTC timezone. This code change will correct dates that are currently being displayed as 1 day off. * chore: format * fix(www): Showcase site detail modal responsiveness (#18956) * chore(starters): gatsby-starter-typescript-contentful (#18972) * chore: change workflow schedule (#18979) * chore: change workflow schedule Switch from daily to weekly for this action * Switch to Tuesday * update `gatsby-starter-orga` info (#18957) * fix(renovate): disable yarn upgrades (#18981) * fix(renovate): disable yarn upgrades * fix(renovate): disable upgrading all engines * chore(docs): Edited pronouns to use second person pronouns (#18962) * edited pronouns to use second person pronouns * edited passive voice to use active voice * removed let's * more pronoun changes * Docs: Recipe for Contentful data source (#17318) * Added recipe for sourcing from contentful * Editing * Moved Conentful recipe into recipe.md * Prettier formatting * Apply suggestions from code review Co-Authored-By: Marcy Sutton <[email protected]> * Removed issue note Co-Authored-By: Marcy Sutton <[email protected]> * More base-relative URLs. * Linting * Added example repo * Added readme to sample * Stronger language on environment variables * Semantic example Co-Authored-By: Marcy Sutton <[email protected]> * Removed unneeded files from example, news in index * Formatting for step 4 * Define example field types * Tightened up a sentence * Changed to using seeded blog space * Use page context * Unused graphql variable * Edited readme * Added env vars note * Changed recipe to use contentful blog seed * Removed duplicate content * Applied suggestions from review Co-Authored-By: Marcy Sutton <[email protected]> Co-Authored-By: Michael <[email protected]> * Extra space Co-Authored-By: Michael <[email protected]> * Applied code review suggestions Co-Authored-By: Marcy Sutton <[email protected]> Co-Authored-By: Michael <[email protected]> * Update working-with-images-in-markdown.md (#17806) * Update working-with-images-in-markdown.md I was having lots of troubles getting this to recognize the path I used for my image in my markdown file as a File. It turns out it's because I wasn't loading my images directory in `gatsby-source-filesystem`. This should help prevent others from having issues with this. * Update working-with-images-in-markdown.md * Update docs/docs/working-with-images-in-markdown.md * add separate sections for sourcing images/Markdown * restoring original inline example w/ original img * docs: New page for Shopify (#17793) * Added shopify ecommerce site * Better Shopify instructions * Better heading * It's an imperative verb, not a noun * Added shopify-buy * Cleanup, editing * Apply suggestions from code review Co-Authored-By: Michael <[email protected]> * Apply suggestions from code review Co-Authored-By: Kyle Gill <[email protected]> * chore(docs): Add "Gentics Mesh" guide (#18506) * Fix usage of wrong command in graphcms source guide * Add Gentics Mesh source guide * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Fix formatting * Apply gatsby style guide * Simplify wording * Add Gentics Mesh to list of headless CMS * Update docs/docs/sourcing-from-graphcms.md Co-Authored-By: Michael <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Michael <[email protected]> * Reduce link title length * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Lennart <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Kyle Gill <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Kyle Gill <[email protected]> * Update docs/docs/sourcing-from-gentics-mesh.md Co-Authored-By: Kyle Gill <[email protected]> * added newly created guide to doc sidebar (#18986) * test: pin cypress version in some e2e-tests (#18989) * fix(gatsby): Fix matchpath ordering (#18478) * Add a test that fails when a * matchpath shadows an index page. * Trailing * is removed during matchPath page weight scoring, this places glob paths at an equal level to index paths. Test for glob path prescedence now uses `toEqual` for deep object comparison. * Place all static paths before matchPaths using wildcard sort field before score. * Test case is more difficult with pages nested more deeply in matchPaths. * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] * fix(gatsby): fix hashes used in webpack for output (#18973) * fix(gatsby): use hashes as module identifiers for webpack caching * fix(gatsby): disable hmr on production builds for css * update absolute path to relative ones * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] * Don't use "static" to describe what Gatsby does (#18999) See also https://github.com/gatsbyjs/gatsby/pull/18998 * fix: update minor updates in packages (#18875) * Don't use "static" to describe what Gatsby does (#18998) * Don't use "static" to describe what Gatsby does The word just confuses people as they think you can't do app-y stuff now. * chore: format * docs: fix code snippet in working-with-video.md (#19000) Fixes Video component file. * feat(gatsby-source-shopify): add SEO field to articles (#18985) Add seo field to Article query * chore(starters): Set exit status for default test npm script (#18879) * Set exit status for default (unimplemented) test command * Set exit status for default test command in default starter * Set exit status for default test command in blog starter * Added Gatsby-Docs-Kit to Gatsby tools section (#19005) * docs: clarify that `loader.js` is a function by calling it in… (#19008) This change makes it a bit more obvious that `loaders.js` is a function and should be called. * docs: Update storybook 5.* configuration (#19006) * Update storybook 5.* configuration The config can be simplified as seen in https://storybook.js.org/docs/guides/guide-react/#step-3-create-the-config-file * chore: format * fix(gatsby-plugin-mdx): don't use jsx (#18982) * fix: don't use jsx * chore: format * fix(gatsby): Remove internal Node modules in getNonGatsbyCallS… (#19009) * Remove internal Node modules in getNonGatsbyCallSite * Update packages/gatsby/src/utils/stack-trace-utils.js Co-Authored-By: Michal Piechowiak <[email protected]> * chore(docs): Clarify blog posting approval note (#18941) * (chore)docs: clarify blog posting approval Make this language slightly clearer. * Update docs/contributing/blog-and-website-contributions.md * [Docs][Recipes]Sourcing from Wordpress (#17374) * [Docs][Recipes]Sourcing from Wordpress * Update docs/docs/recipes.md Co-Authored-By: Michael <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Michael <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * Update directions for Sourcing from WordPress * Include code for post.js * Update docs/docs/recipes.md Co-Authored-By: Marcy Sutton <[email protected]> * chore: format * remove extra character for consistency * remove unneeded query fields and set html * docs(recipes): using wordpress example (#19014) * Create post.js * Create package.json * Create gatsby-node.js * Create gatsby-config.js * Create index.js * Docs: Example for sourcing from Wordpress * Docs: Example for sourcing from Wordpress * Docs: Example for sourcing from Wordpress * Docs: Example for sourcing from Wordpress * Create page.js * Docs: Example for sourcing from Wordpress * Docs: Example for sourcing from Wordpress * Docs: Example for sourcing from Wordpress * Fixed closing tag errors * Fixed closing tag errors * Fixed closing tag errors * chore: format * Update examples/gatsby-sourcing-wordpress/gatsby-config.js Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/gatsby-sourcing-wordpress/package.json Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/gatsby-sourcing-wordpress/src/templates/post.js Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/gatsby-sourcing-wordpress/src/templates/page.js Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/gatsby-sourcing-wordpress/src/templates/page.js Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/gatsby-sourcing-wordpress/src/templates/post.js Co-Authored-By: Marcy Sutton <[email protected]> * chore: format * Update folder name and readme * Revert "Update folder name and readme" This reverts commit 5f7481e7a889d3eef6cf00e1e6fcd7f2d5d349b5. * rename examples * Update examples/using-wordpress-with-acf/README.md Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/using-wordpress-with-acf/README.md Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/using-wordpress-with-acf/gatsby-config.js Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/using-wordpress-with-acf/package.json Co-Authored-By: Marcy Sutton <[email protected]> * Update examples/using-wordpress-with-acf/package.json Co-Authored-By: Marcy Sutton <[email protected]> * Restore comments * Restore comments * chore: format * fix linting issues * feat(starter): expand .gitignore in default starter to ignore… (#19015) * docs: Fix broken links to gatsby blog theme and gatsby notes theme (#19011) * feat(starters): Update .gitignore in all starters to ignore .env, .env.development, .env.production, etc. (#18968) * Update '.env' line in .gitignore to '.env*' so that it works for .env.development, .env.production, etc. files * Update '.env' line in the .gitignore file of other starters to '.env*' so that it works for .env.development, .env.production, etc. files * feat(site-showcase-validator): check 'source_url' for private… (#18840) * feat(site-showcase-validator): check 'source_url' for private repositories * feat(site-showcase-validator): adjust the exit code * feat(site-showcase-validator): modify the warning message * chore(gatsby): Move duplicate node path check to gatsby-core-utils (#19017) * chore(gatsby): Move duplicate node path check to gatsby-core-utils * chore(gatsby): Rename utility function and add unhappy path to the unit test * chore(showcase): Add veryben.com (#18996) * chore(showcase): Update iammatthias.com entry (#18991) * Update sites.yml Update listing for https://iammatthias.com * Update docs/sites.yml Co-Authored-By: Benjamin Lannon <[email protected]> * chore(starters): Add gatsby-starter-point (#18997) * Remove 'shortcut' link type before 'icon' (#19007) * chore(www): remove sentry from .org (#19020) * Fix README.md on nomjs.com by replacing :rocket: with rocket emoji (#19022) * chore(showcase): Add brentrunsmarathons.com and pedrolatorre.c… (#18987) * added brentrunsmarathons.com website to sites.yml * Add pedrolatorre.com and brentrunsmarathons.com * fixed typo * chore: format * fix(gatsby-plugin-netlify): don't add `/undefined` in generated `_headers` file (#18925) * fix(gatsby-plugin-netlify): /undefined in generated _headers file * Explicitly check that /undefined is not in output of buildHeadersProgram * Fix matcher * Update awesome-gatsby-resources.md (#18915) * No need of inverted commas here (#18953) * added Bare Advertising & Communications as creator (#19026) * core(docs): add better link text (#18910) * changed some we to you (#18913) * chore(docs): Fix spellings of frontend, backend, end user (#18958) * chore(docs): explain shadowing a bit more (#18931) * Remove appveyor.yml * chore(docs): explain import vs require (#18930) * explain import vs require * Update docs/tutorial/part-two/index.md * chore(docs): clarify API usage (#18926) * clarify API usage * Update docs/tutorial/part-seven/index.md * Update docs/tutorial/part-seven/index.md * blog: Update link to shadowing documentation (#18929) * chore(starters): gatsby-starter-dev-portfolio (#18924) * chore(starters): gatsby-starter-dev-portfolio * Update starters.yml * chore: format * feat(gatsby-cli): Add command-line argument for logger (#18818) * Update cli to set logger based on command line argument * Fix regression for choosing default reporter * Expose only JSON logger * updated title (#19041) removed . from title * feat(site-showcase-validator): Add user-agent for HTTP requests (#19031) * feat(site-showcase-validator): Add user-agent for HTTP requests * Swapped fetch call to wrapper function * docs(gatsby-source-graphql): Fix English and clarify fieldName and typeName (#18937) * Fix English and clarify fieldName and typeName * chore: format * Apply suggestions from code review * Updated according to Gatsby Style Guide. (#19040) Updated according to Gatsby Style Guide. Shifted perspective from the first-person perspective ("I", "we") to the secondary perspective ("you") per the Gatsby Style guide. * Mention useStaticQuery hook in documentation (#18920) Adds a mention of the new `useStaticQuery` hook in the Static Query vs. Normal Query documentation. Points users to helpful Gatsby documentation on how to use `useStaticQuery` to query data at build time. * fix(docs): Sentence fragment in translation docs (#19047) * Update Our to Your (#19037) * Update Our to Your * Add suggestion changes Co-Authored-By: Sidhartha Chatterjee <[email protected]> * Fix broken link in Themes API reference (#19045) * chore(showcase): Add kentarom's portfolio to showcase list (#19052) * Update README.md (#19051) * Add more context to creating new languages (#19066) * Add more context to creating new languages * chore: format * chore(starters): gatsby-starter-zurgbot (#18907) * adding gatsby-starter-zurgbot to starters library * Update docs/starters.yml Co-Authored-By: Lennart <[email protected]> * Update docs/starters.yml Co-Authored-By: Lennart <[email protected]> * chore: format * fix weird merge issue Co-authored-by: GatsbyJS Bot <[email protected]> Co-authored-by: Lennart <[email protected]> * chore(showcase): Add MDX Blog starter (#18950) * Update starters.yml Add a Gatsby Starter * Update starters.ymsl * Update docs/starters.yml Co-Authored-By: Sidhartha Chatterjee <[email protected]> * Update docs/starters.yml Co-Authored-By: Sidhartha Chatterjee <[email protected]> * Update docs/starters.yml Co-Authored-By: Sidhartha Chatterjee <[email protected]> * chore: format * Update docs/starters.yml Co-Authored-By: Sidhartha Chatterjee <[email protected]> * chore(starters): gatsby-typescript-storybook-starter (#19068) * add start storybook and ts * Remove "Netlify" tag Co-authored-by: GatsbyJS Bot <[email protected]> Co-authored-by: Lennart <[email protected]> * chore(docs): add Language repos to the list (#19069) * chore(docs): add Polish repo to the list * add other languages Co-authored-by: Lennart <[email protected]> * chore(showcase): Add Fuzzy String Matching (#19071) * Update sites.yml * delete empty line * delete incorrect category Co-authored-by: Lennart <[email protected]> * chore(starters): update lewis-gatsby-starter-blog (#19076) Co-authored-by: GatsbyJS Bot <[email protected]> * fix(www): support dark mode in 'Collapse all' btn on hover (#19062) * chore(docs): Update pronouns (#19079) * docs(gatsby-plugin-mdx): fix error in MDXProvider component ref (#19075) * fix: update minor updates in packages (#19080) * feat(redirects): allow multiple redirects from same path when they have different options (#19048) This updates how the redirects reducer prevents duplicates so that it allows redirects with the same fromPath when the other options are different. * chore(docs): Fix unclickable links (#19067) * chore(showcase): Add MotionThat, TEN ALPHAS, SalesGP and Source Separation Systems (#19073) * chore(gatsby-image): Add missing type definitions for GatsbyImageProps (#18916) * Add missing properties to GatsbyImageProps typedef Added missing properties from Gatsby Image prop types (https://github.com/gatsbyjs/gatsby/blob/3776d39e15368fdd1468d4424c93c8b4ffa3415e/packages/gatsby-image/src/index.js#L660-L685) to TypeScript type definitions of Gatsby Image. * Add sync comment to GatsbyImage propTypes * Add sync comment to GatsbyImageWithIEPolyfill propTypes * Replace paths by GitHub URLs in GatsbyImageWithIEPolyfill comment * Replace paths by GitHub URLs in GatsbyImage comment * Update gatsby-docs-translation-guide.md (#19082) * chore(gatsby-transformer-screenshot): Use createContentDigest helper for file name (#18830) * update gatsby plugins to use new createContentDigest helper at gatsby-transformer-screenshot & replace peerDependency for gatsby-transformer-sqip * change to use contentDigest * Update yarn.lock * Make changes from review * Move dependency to right package * fix(gatsby-cli): handle git commit failures (#18839) * remove git support if initial commit fails * add info log when removing git support * fix(gatsby-dev-cli): Default to no dependencies before running diff (#19085) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * fix: update minor updates in packages (#19086) * feat(gatsby-core-utils): Add isCI and getCIName (#19039) Fixes https://github.com/gatsbyjs/gatsby/issues/19018 * Docs/contributing index to mdx (#19057) * Converted pages/contributing/index.js to mdx * Removed rundant h1, it is created by the template from frontmatter title. * Renamed to index.mdx * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * fix: update minor updates in packages (#19087) * [docs] added code blocks to highlight code specific to steps 4 and 5 in Using Gatsby Image doc (#18790) * added code blocks to highlight code specific to step 4 and 5 * changed queries to useStaticQuery * fix(www): Eliminate horizontal scroll on mobile devices (#18892) * fix(www): Make egghead iframe videos responsive (eliminate horizontal scroll on mobile) * fix: Eliminate linter/prettier errors * refactor: wrap useCallback around settIframeWidth function * fix: use VIDEO_RATIO variable instead of magic number * Update www/src/components/shared/egghead-embed.js Co-Authored-By: Sidhartha Chatterjee <[email protected]> * chore: format * chore: Remove Flow (#19028) * chore(docs): Fix case of GitHub, GitLab, JavaScript, TypeScript and WordPress. (#19091) * chore: update dependency aws-sdk to ^2.558.0 (#19096) * Add script to create new translation repositories (#18893) * add the create script * description of env * add reference to comment. * edit README * more information in README * update create script * add pulling logic * add maintainers to organization * add comment * add discord link * add more discord references * Move script explanations to the README * Update scripts/i18n/README.md Co-Authored-By: Marcy Sutton <[email protected]> * link to translation guide * Update create.js * remove style guide from list of scripts * Fix - Broken link & syntax highlighting on Recipes: Sourcing f… (#19084) * fix: Broken link and syntax highlighting problem * Fix broken link * Correct caching warning footnote about 'no-cache' (#18763) * Correct caching warning footnote about 'no-cache' Footnote was incorrectly warning against using 'no-cache', and could use a little additional clarification. [1]: https://tools.ietf.org/html/rfc7234#section-5.2.2.1 [2]: https://developers.google.com/web/fundamentals/performance/optimizing-content-efficiency/http-caching#no-cache_and_no-store * run prettier * fix(gatsby-plugin-mdx): display better error message for MDX `html` field in development (#19111) * Update sites.yml (#19107) * chore(showcase): add leavemealone.app to sites.yml (#19104) * chore(showcase): add leavemealone.app to sites.yml * chore(showcase): Updated main_url in sites.yml for leavemealone.app * format * chore(showcase): Add open techiz website (#19109) * open techiz website added to showcase We use strapi source and host on netlify, we have validated performance and follow all best practices * Update sites.yml * format * chore: format * chore(docs): Fix case of Drupal, Gatsby and WordPress. (#19100) * [docs] describe console logging of the build process (#18816) * describe console logging of the build process * rephrase build debugging doc * fix(docs): Fix broken link to Documentation PRs (#19121) * chore(docs): Add reference guide "Modifying a Starter" (#18995) * Draft 'Modifying a Starter' * Link to 'Modifying a Starter' from parent page and tutorial * Add 'Modifying a Starter' to navigation menu * Link to Gatsby resources instead of external ones Co-Authored-By: Marcy Sutton <[email protected]> * Add a dash to ‘e-commerce’ Co-Authored-By: Marcy Sutton <[email protected]> * link to Gatsby GraphQL resource & correct siteMetadata typo Co-Authored-By: Marcy Sutton <[email protected]> * Replace folder structure screenshot & correct typos * Correct 'SiteMetaData' typos in blog post and GraphQL reference * Update default starter files screenshot * docs(gatsby-source-mongodb): fix mapping configuration example (#19120) * Removed extra bracket and added missing comma * chore: format * update highlight to focus on changed piece (#18969) * update highlight to focus on changed piece * chore: format * chore(docs): Fix the heading order (#18881) * fix(docs): Fix the heading order * Update docs/docs/adding-markdown-pages.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-markdown-pages.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-markdown-pages.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/sourcing-from-buttercms.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/sourcing-from-buttercms.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/sourcing-from-netlify-cms.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/gatsby-on-linux.md Co-Authored-By: Marcy Sutton <[email protected]> * Update sourcing-from-buttercms.md * Update docs/docs/sourcing-from-buttercms.md Co-Authored-By: Marcy Sutton <[email protected]> * chore: format * [docs] How to manage suggestions section on the How to Open Pull Requests guide (#18745) * resolves #14598 Adds a reference guide on how to upgrade Gatsby and its dependencies * Fixed typos and added related content * Fixed additional typos * Fixed additional typos, one with the name of the file, added links for the doc-links.yaml file, escaped < and > characters in markdown thata were causing some errors * Updated title based on @marcysutton suggestions Co-Authored-By: Marcy Sutton <[email protected]> * Solves suggested changes such as modifying links for relative urls, removing yarn instructions and alignments to Gatsby style guide * Apply additional suggestions Co-Authored-By: Marcy Sutton <[email protected]> * Added a section on how to handle reviews on your PR * Apply suggestions from code review Co-Authored-By: Marcy Sutton <[email protected]> * add section on how to change default package manager. (#19098) * add section on how to change default package manager. Changing the default package manager used by `gatsby-cli`can be tricky for newcomers as there is no CLI command for this. I've added some explanation to help those who want to change it by modifying the configstore file. * be more explicit on the purpose of this change This default package manager change only concerns future projects using gatsby new. * prettier ok * Update docs/docs/gatsby-cli.md Co-Authored-By: Marcy Sutton <[email protected]> * chore(docs): p-files Part1 - adjust headlines according to style guide + adjust some texts (#18715) * production-app: just adjust headlines to fit style guide * progressive-web-app: adjust some text & headlines - handle Progressive Web App like Markdown in the spelling * adjust headlines & titles to fit style guide + adjust some texts * revert a few things * change Window to * pixabay-source-plugin-tutorial: replace Usage: npm <command> where <command> is one of: access, adduser, audit, bin, bugs, c, cache, ci, cit, clean-install, clean-install-test, completion, config, create, ddp, dedupe, deprecate, dist-tag, docs, doctor, edit, explore, get, help, help-search, hook, i, init, install, install-ci-test, install-test, it, link, list, ln, login, logout, ls, org, outdated, owner, pack, ping, prefix, profile, prune, publish, rb, rebuild, repo, restart, root, run, run-script, s, se, search, set, shrinkwrap, star, stars, start, stop, t, team, test, token, tst, un, uninstall, unpublish, unstar, up, update, v, version, view, whoami npm <command> -h quick help on <command> npm -l display full usage info npm help <term> search for help on <term> npm help npm involved overview Specify configs in the ini-formatted file: /Users/codingcookie/.npmrc or on the command line via: npm <command> --key value Config info can be viewed via: npm help config [email protected] /usr/local/lib/node_modules/npm with npm * add requested review changes * fix(www): Fix Compare with Gatsby button on smaller breakpoints (#19063) * fix(www): No kebab case for CSS properties in objects (#19129) * chore(docs): u-files - minor punctuation and grammar fixes (#18762) * feat(gatsby): enable local themes (#15856) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * fix(gatsby-plugin-sharp): fix "Cannot set property 'multipassCount' of undefined" error (#19131) * chore(release): Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * chore(www): Import from `gatsby-plugin-theme-ui`… (#19134) instead of `gatsby-design-tokens`; we're noew only importing from `gatsby-design-tokens` once, in `src/gatsby-plugin-theme-ui`. Refactor a couple (related) things along the way. Ref. #19115 * chore(docs): Fix two things in partnering doc (#19139) * chore(docs): fix language for code highlighting from sh to she… (#19135) * fix(www): /guidelines/color modal title color for dark mode (#19147) * fix(www): /guidelines/color modal title color * chore(www): Remove utils/guidelines/theme * Docs define acronyms (RFC and SEO) (#19148) * add RFC definition on contributor docs * add SEO acronym definition * Update docs/contributing/gatsby-style-guide.md Co-Authored-By: Amberley <[email protected]> * remove acronym from header * keep header, but change first sentence * Use soft line-feeds for Code of Conduct (#19166) This makes it easier to translate, since the entire paragraph can be translated instead of weird word breaks. * Correct count of contributors (#19160) * Update gatsby-docs-translation-guide.md (#19094) * docs: add adding react components doc (#18651) * docs: add initial revision of adding react components doc * docs: add react components doc link to sidebar * docs(add react components): swap to american spelling Co-Authored-By: Kyle Gill <[email protected]> * docs(add react components): add info about using third party components * docs(add react components): remove sections from other pages and cross-reference * docs(porting from cra): add class component examples for browser global use * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/porting-from-create-react-app-to-gatsby.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/porting-from-create-react-app-to-gatsby.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/porting-from-create-react-app-to-gatsby.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Remove references to other package managers * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update docs/docs/adding-react-components.md Co-Authored-By: Marcy Sutton <[email protected]> * Update adding-react-components.md * Update docs/docs/adding-react-components.md Co-Authored-By: Michael <[email protected]> * Apply suggestions from code review Co-Authored-By: Michael <[email protected]> * chore(docs):capitalization and grammar fixes (#18788) * capitalization and grammar fixes * fix docs pr based on feedback * Use gatsby-theme name convention on getting started (#19154) * Fix capitalize (#19177) * Site submission oberion (#19176) * Submit to site showcase: Oberion * Remove category gaming * add hint about how to disable ESLint (#19170) * chore(examples): Update graphql-reference (#19180) * chore(showcase): Update site showcase in response to errors in… (#19182) - Bottender Docs is no longer using Gatsby. Removing entry - Citywide Holdup's repo is no longer public. Removing source_url - Dale Blackburn's portfolio repo is no longer public. Removing source_url - Rou Hun Fan's portfolio repo is no longer public. Removing source_url - nehalist.io's repo is no longer public. Removing source_url * chore(docs): fix language for code highlighting and highlight line (#19163)

Aisha Blake added 4 commits October 24, 2019 20:58

Draft 'Modifying a Starter'

bc36e84

Link to 'Modifying a Starter' from parent page and tutorial

dbd3bb0

Add 'Modifying a Starter' to navigation menu

13d2611

Merge remote-tracking branch 'upstream/master' into docs-modify-starter

bad3d8a

AishaBlake requested review from a team as code owners October 25, 2019 01:27

AishaBlake changed the title ~~Add reference guide: Modifying a Starter~~ (docs) Add reference guide: Modifying a Starter Oct 25, 2019

AishaBlake changed the title ~~(docs) Add reference guide: Modifying a Starter~~ (docs): Add reference guide: Modifying a Starter Oct 25, 2019

marcysutton self-assigned this Oct 25, 2019

marcysutton suggested changes Oct 26, 2019

View reviewed changes

Aisha Blake and others added 3 commits October 27, 2019 13:10

Link to Gatsby resources instead of external ones

0735c0e

Co-Authored-By: Marcy Sutton <[email protected]>

Add a dash to ‘e-commerce’

96ce97a

Co-Authored-By: Marcy Sutton <[email protected]>

link to Gatsby GraphQL resource & correct siteMetadata typo

bef4b1e

Co-Authored-By: Marcy Sutton <[email protected]>

LekoArts changed the title ~~(docs): Add reference guide: Modifying a Starter~~ chore(docs): Add reference guide "Modifying a Starter" Oct 28, 2019

LekoArts added the type: documentation An issue or pull request for improving or updating Gatsby's documentation label Oct 28, 2019

Aisha Blake added 2 commits October 28, 2019 12:45

Replace folder structure screenshot & correct typos

48633cd

Correct 'SiteMetaData' typos in blog post and GraphQL reference

eabbceb

marcysutton reviewed Oct 28, 2019

View reviewed changes

Update default starter files screenshot

720c887

marcysutton approved these changes Oct 29, 2019

View reviewed changes

marcysutton merged commit 6c50369 into gatsbyjs:master Oct 29, 2019

marcysutton mentioned this pull request Oct 30, 2019

[docs][guides] How to Modify a Starter #18116

Closed

marcysutton added the Hacktoberfest label Nov 6, 2019

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(docs): Add reference guide "Modifying a Starter" #18995

chore(docs): Add reference guide "Modifying a Starter" #18995

AishaBlake commented Oct 25, 2019

marcysutton left a comment

marcysutton Oct 26, 2019

AishaBlake Oct 28, 2019

marcysutton Oct 26, 2019

marcysutton Oct 26, 2019

marcysutton Oct 26, 2019

marcysutton Oct 26, 2019

marcysutton Oct 26, 2019

marcysutton Oct 26, 2019

AishaBlake Oct 28, 2019

marcysutton Oct 28, 2019

AishaBlake commented Oct 27, 2019

AishaBlake commented Oct 28, 2019

marcysutton Oct 28, 2019

AishaBlake Oct 29, 2019

laurieontech Oct 29, 2019

AishaBlake Oct 29, 2019

marcysutton Oct 29, 2019

marcysutton left a comment

gatsbot bot commented Oct 29, 2019


		Taking the default Gatsby starter as an example, dedicate some time to looking through some of the most important files in the repository (repo). You'll find most of these in the root (or _main_) folder of your project. Doing so will give you a clearer picture of how the various parts of your Gatsby site work together.

		![Default starter file structure in VS Code](./images/default-starter-file-structure.png)

	Elsewhere on the site, GraphQL queries access that data and display it in the browser. The `Layout` component, for instance, runs a query for `siteMetaData`'s `title` property. It then passes that value to the `Header` component via props:
	Elsewhere on the site, GraphQL queries access that data and display it in the browser. The `Layout` component, for instance, runs a query for `siteMetadata`'s `title` property. It then passes that value to the `Header` component via props:

	Try adding a property to `siteMetaData`, querying for it, and displaying the data on a page of your site. The Gatsby docs have a great introduction to [querying your data with GraphQL](/docs/graphql/).
	Try adding a property to `siteMetadata`, querying for it, and displaying the data on a page of your site. The Gatsby docs have a great introduction to [querying your data with GraphQL](/docs/graphql/).


		You may even choose a specific starter _because_ of its approach to styling. Search the [Gatsby Starter Library](/starters/) using category filters prefixed with "Styling:" and choose the option(s) that best fit your project.

		![Starter Library with Styling:SCSS filter selected](./images/starter-library-scss-filter.png)

chore(docs): Add reference guide "Modifying a Starter" #18995

chore(docs): Add reference guide "Modifying a Starter" #18995

Conversation

AishaBlake commented Oct 25, 2019

Description

Related Issues

marcysutton left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

AishaBlake commented Oct 27, 2019

AishaBlake commented Oct 28, 2019

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

marcysutton left a comment

Choose a reason for hiding this comment

gatsbot bot commented Oct 29, 2019