…uide overview pages (#19296)

… doc and updates to building apps over… (#19214)

…ion of Prettier

… incorrect (#19405)

the `/styles/` from the docs about `src/styles/global.css` is written as
`/styles/styles/`

…e.md (#19404)

Changes link to Hemingway App from `https://www.hemingwayapp.com/` to `https://hemingwayapp.com/` because `https://www.hemingwayapp.com/` has an invalid SSL certificate and is flagged as a security risk.

…nging deeplinks when editing headings (#19186)

…slint-loader with custom config (#19399)

… graphql query export (#19366)

…ome-gatsby (#19315)

…cs for themes (#19211)

* docs(gatsby): html.js docs for themes

#19181

* docs(html): html.js custom placement

* docs(htm): Update docs/docs/custom-html.md

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

…ctory tree in _Shadowing other themes_ (#19140)

…logy for hydration (#19449)

…plugin documentation (#19413)

* add better source plugin documentation

* chore: format

* Apply suggestions from code review

…o include divisive

…out file extensions (#19464)

…in resolution logic for theme dir resolution (#19470)

…sby-plugin-catch-links in gatsby link… (#19424)

…tation for tailwindcss support (#17747)

* Added documentation for tailwindcss support

Additionally I fixed some highlight and intendation mistakes

* Fixed code highlighting

Inside the code sample was SCSS code instead of Sass. So, I changed the file extenstion into `scss`.

* chore: format

* consistent code formatting

* removed tailwindcss instructions

* added sass implementation of tailwind css

* consistent use of tailwindcss and Tailwind CSS

* imcorporate requested changes

Co-authored-by: GatsbyJS Bot <[email protected]>
Co-authored-by: Lennart <[email protected]>

…ESLint (#19171)

* Add hint how to disable ESLint #19170

* Run prettier

* Apply code review suggestion for docs/docs/eslint.md

Co-Authored-By: LB <[email protected]>

* Run prettier

* Add explanatory paragraph back

* chore: format

…eCommerce tutorial index (#19494)

…guage in transalation list (#19467)

* Add Gujarati, French, Mongolian langulage to new transalation list

* Add the entries alphabetically sorted by the language code

…19500)

* Added F12 key hint for devtools

* Add import headers for full-copy-paste

This brings the code examples in line with the other examples, which can be fully copy-pasted into the file without error.

…language to translation list in doc (#19498)

…y steps on building ecommerce sites wi… (#18669)

* 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]>

* Little typo with the npm-force-resolutions package name is fixed

* Added two additional steps for the tutorial on how to build ecommer sites with Stripe that were required by stripe for the example to work

* Added missing screenshot files

* Removed intstructions from the old Stripe UI

* Removes the now unused images and integrates suggestions from gatsby learning

* Changed integration to function when referring to the `redirectToCheckout` function

Co-Authored-By: Michael <[email protected]>

* Rewrote the requirements to use this integration, changed pronouns, fixed typos, changed quotes

* Added missing screenshot file

* Apply suggestions from code review

Co-Authored-By: LB <[email protected]>

* Apply suggestions from code review

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

…es correctly outside GraphQL (#17061)

Co-authored-by: Ward Peeters <[email protected]>
Co-authored-by: GatsbyJS Bot <[email protected]>

…ese language in transalation list (#19539)

… to include title field which is missing (#19542)

title field is missing from second block which makes the code confusing when printing the title within H1 but title is not included in fields queried via GraphQL statement.

…tes.io to awesome-gatsby-resources.md (#19503)

…ttps://www.gatsbyjs.com/

… preparing-for-deployment (#19566)

…-gatsby.md file (#19560)

…o Kontent (#19114)

* Changes for renaming of Kentico Kontent

* fix linting problem

* add redirect for renamed tutorial

* Add additional redirect

* Update link in blog post

* Remove old blog post

* Add renamed starter back in

* Change npm for yarn

* Fix location of kontent starter

* chore: format

…Static vs Normal Queries to focus more on internals (#19219)

* remove TODOs and focus the doc more on internals

* Apply suggestions from code review

Co-Authored-By: Michael <[email protected]>

* Apply suggestions from code review

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

* updates to remove implementation details and clarify more concepts

* add one more example to show differences

* Apply suggestions from code review

Co-Authored-By: LB <[email protected]>

* Update docs/docs/static-vs-normal-queries.md

Co-Authored-By: LB <[email protected]>

…and directives" section in schema-cust… (#19625)

… to "Building Themes" (#19330)

…er configurations for client side rout… (#19554)

* add more detail on server configurations

* fix heading

* Update client-only-routes-and-user-authentication.md

* chore: format

… wordpress-source-plugin-tutorial.md (#19629)

Correct the spelling in the path

… Gatsby, Strapi, Bootstrap and WordPress (#19626)

…(#19495)

…ectory reference in recipe snippet (#19650)

… old maintainer meeting (#19660)

…auth and client only routes (#19551)

* initial improvements

* update example and add explanations for client only routes

* add overview of auth

* more auth example code

* finishing touches to connect docs and smooth out overall flow

* chore: format

* chore: format

* Apply suggestions from code review

Co-Authored-By: LB <[email protected]>
Co-Authored-By: Michael <[email protected]>

* added section on differences and fixed some hanging sentences

* Update docs/docs/building-a-site-with-authentication.md

Co-Authored-By: LB <[email protected]>

* update to fall in line with new content on configuring server for client only routes

* chore: format

* Update docs/docs/client-only-routes-and-user-authentication.md

Co-Authored-By: LB <[email protected]>

…deployment to Microsoft IIS (#19371)

* Added information about deployment to Microsoft Internet Information Server (IIS) to the docs; especially with regards to caching.

* Update docs/docs/deploying-to-iis.md

Co-Authored-By: Michael <[email protected]>

* Converted tabs to spaces to make formatting of XML consistent.

* Update docs/docs/deploying-to-iis.md

Co-Authored-By: Michael <[email protected]>

* Added deploying-to-iis to doc-links.yaml.

* chore: format

…ages in RootConfig.Plugins array of code-copy section in docs. (#19671)

* [docs/mdx-plugin/gatsby-remark-images]
including options.plugins entry

* [docs/mdx-plugin] fixing lint error

* [docs/mdx-plugin/gatsby-remark-images__config-update]

Adding gatsby-remark-images to root plugins array

* [docs/mdx-plugin/gatsby-remark-images]
Responding to change request:

Adding detail to sentence above code section block.

…urcing page (#19411)

* Fix and clarify Ghost sourcing page

* Update docs/docs/sourcing-from-ghost.md

Co-Authored-By: Mikhail Novikov <[email protected]>

…: fix progressbar & caching layer (#19717)

…an html site to gatsby (#18609)

* docs: guide for porting part of a html site to gatsby

* fix: add missing normalize.css file to trees, build sentence rewrite

* fix: change links to be relative paths

* Apply suggestions from code review

Co-Authored-By: Kyle Gill <[email protected]>

* Apply suggestions from @gillkyle code review

* Clearer and Consistenter(heh) prefix descriptions

* format is aggressive about wrapping here, switching to start/end marks!

* bracket typo, square the curl

* Apply suggestions from code review

Co-Authored-By: Michael <[email protected]>

* parting more ports and the complete Gatsby section, per @muescha suggestion

* Update docs/docs/porting-part-of-a-html-site-to-gatsby.md

Co-Authored-By: Michael <[email protected]>

* Make page more general, for porting part and the whole

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

* Apply suggestions from code review

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

* Style guide: less we more you

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

* Apply suggestions from code review

- Briefly explain JSX and add in some mentions.
- Expand and clarify JavaScript / JSX passages.

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

* Review: Clarify tooling and building points.

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

* condense why section and link off to core philosophy

* expand on isolation -> integration in porting process

* add file example for adjusting Link tags in porting more parts

* fix heading structure: add h1 on each page and make logo a styled anchor

* change name to match new title

* update sidebar and breadcrumb titles

* remove assetPrefix from example project, add link as note

* restructure for full html site port, with note for prefix options

* fix out of date directory name

* correct contradicting sentence about not changing copied over html markup

* expand opening to position guide relative to main tutorial

* Apply suggestions from code review

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

* fix gatsby-site path roots

* Apply suggestion from code review - gatsby serve tip

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

* add partial porting note to introduction and hosting section

* consistent flag --

* swap  broken link

* Update broken link

…contributions.md (#19756)

* Update blog-and-website-contributions.md

Corrected few of the Grammatical and spelling errors.

* Update docs/contributing/blog-and-website-contributions.md

* Update docs/contributing/blog-and-website-contributions.md

…al-dev-environment): beautify some parts (#19349)

* Update setting-up-your-local-dev-environment.md

* capitals for Node

* add help link to fork

* fix with prettier (#19365)

* Update docs/contributing/setting-up-your-local-dev-environment.md

Co-Authored-By: LB <[email protected]>

* Update docs/contributing/setting-up-your-local-dev-environment.md

Co-Authored-By: LB <[email protected]>

* add github help pages about sync

* removed pull app, fixed Github->GitHub

* removed obsolete headline

…odifying-a-starter (#19824)

…igrating-from-v1-to-v2.md (#19826)

…h text in docs/tutorial/wordpress-sour… (#19828)

…adless-cms (#19822)

* chore(doc): 404 on /docs/headless-cms

* chore: format

Co-authored-by: GatsbyJS Bot <[email protected]>

…guide per style guide (#19787)

* update plugin authoring guide per style guide

Adds more explanations to terminology, as some readers may not be familiar with the concepts

* Apply suggestions from code review

Co-Authored-By: LB <[email protected]>

… (#19853)

* fix link in adding-react-components.md

* fix link to twitter gill kyle

* remove link to not existing GIPHY

* changed twitter handle ( https://www.katiefujihara.com/ )

* removed non existing user at twitter @fernandopoumian - can not find a new one :(

* fix wrong link to react-rehydration -> react-hyadration

* reactfaq.site is abandoned ( timarney/react-faq#39 )

* fixed link for gatsby-starter-theme-workspace

* fixed link for gatsby-theme-blog and gatsby-theme-notes

* fixed link for rfcs 0004-native-graphql-source

* fixed link for octoverse.github.com/#top-languages

* fixed link for gatsby-theme-apollo-docs project-config-panel.mdx

* fixed link for github.com/nicholaswyoung

Co-authored-by: Muescha <>

…ce to MDX blog post to main docs (#19804)

Co-authored-by: Laurie Barth <[email protected]>

…links to use always ./images (#19875)

Co-authored-by: Muescha <>

…ar fix (#19884)

…ar fix (#19893)

…emove duplicate stub (#19918)

* Rename Routing Doc and remove duplicate stub

* add redirect

… page (#19700)

* Update routing main docs page

* Update docs/docs/routing.md

Co-Authored-By: Sidhartha Chatterjee <[email protected]>

* Update docs/docs/routing.md

Co-Authored-By: Kyle Gill <[email protected]>

* Update docs/docs/routing.md

* Update docs/docs/routing.md

Co-Authored-By: Kyle Gill <[email protected]>

* Update docs/docs/routing.md

Co-Authored-By: Kyle Gill <[email protected]>

* Update docs/docs/routing.md

* Prefetching is explained elsewhere. We should change the structure of the docs and point to the content inside the main routing landing page.

* Update docs/docs/routing.md

Co-Authored-By: Michael <[email protected]>

* Update docs/docs/routing.md

* Update docs/docs/routing.md

* Update docs/docs/routing.md

* Feedback from conversation with Brittney

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* Update docs/docs/routing.md

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

* chore: format

…Gatsby internal docs for update (#19848)

* update(docs): mark Gatsby internal docs for update

* update(docs): mark Gatsby internal docs for update

* Update docs/docs/node-tracking.md

Co-Authored-By: Aisha Blake <[email protected]>

* Update docs/docs/query-behind-the-scenes.md

Co-Authored-By: Aisha Blake <[email protected]>

…g-from-forestry doc page (#18426)

* Add sourcing-from-forestry doc page; Sort headless-cms table to be alphabetical

* Fix formatting for linter

* Revert table sorting; Add Forestry to table

* Add requested changes

* Update sourcing-from-forestry page; Run prettier

* Update sourcing-from-forestry page to include development workflow

* Run format script

* Revert "Run format script"

This reverts commit 5c01c04d6cda4a4ba335ea0180c4b42bbe974592.

Revert prettier edits

* Remove Netlify CMS reference in sourcing-from-forestry page

* Update docs/docs/sourcing-from-forestry.md

Co-Authored-By: LB <[email protected]>

* chore: format