Skip to content

Commit 9b48eab

Browse files
piehm-allanson
authored andcommitted
[v2] merge master into v2 (#5451)
* Use index within container Confusing as to what is being asked. Later, the docs say to `import Container from "../components/container";` * Pass through GTM environment params if present Signed-off-by: Spencer Sanchez <[email protected]> * Add abinavseelan.com to Showcase * Add Dovetail (dovetailapp.com) to website examples Thanks for creating Gatsby and for all of your hard work! We’ve enjoyed building our new marketing website with it. * change link of `gatsby-advanced-blog` in docs * Remove outdated contributing notes from gatsby-remark-prismjs * Typo: Return to wrong file I was doing the gatsby.js tutorial and I was running into one issue, the tutorial said to return to index.js, but it should be to my-files.js, I eventually figured out that this was probably just a typo, but for a long time I kept changing my index.js file and didn't understand what I was doing wrong, turns out I was editing the wrong file. For so far I have enjoyed gatsby.js, I want to use it for my personal portfolio. * Fix distance between masthead and the icon (#5068) On mobile, the masthead is overlapping with the Gatsby icon. * Update CONTRIBUTING.md * Update README.md Per issue #5073 * Add better-queue to dependencies * Remove index.js for more consistent paths * removing "a" * pre-inferring data sanitazation (#5050) * extractFieldExamples: omit not defined fields this is especially helpful with ___NODE fields - plugins/users don't have to test if there are any values and be confident that empty ___NODE values or arrays will just be omitted and not error out during bootstrap * sanitize field owner key when using createNodeField with name containing ___NODE this fixes issue with inferring fieldOwners types - gatsby would try to link to not existing nodes * Add getRenderer method (#5017) * Add getRenderer method Signed-off-by: slorber <[email protected]> * upgrade example versions Signed-off-by: slorber <[email protected]> * change name to renderer * Change name to replaceHydrateFunction * document replaceHydrateFunction * fix(gatsby): remove `.js` suffixes in require() to allow transpilation (#5087) In earlier v1, one could write files such as `gatsby-config` in typescript and use babel to transpile the file into js on the fly via `babel-node --presets @babel/preset-typescript --extensions '.ts' gatsby develop`. However, it's no longer possible in recent releases. The reason is that the current implementation put a `.js` suffix on each require(`gatsby-${env}.js`), which blocks `gatsby-{$env}` files being transpiled from other languages via babel. The PR addresses this problem by removing the unnecessary suffix and preserving the integrity. Signed-off-by: Alvis HT Tang <[email protected]> * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * stylus plugin tests Signed-off-by: Jan Winterfeld <[email protected]> * add learnstorybook.com to showcase * Bump yargs version to get help and version for free by default * Update manifest extension to .webmanifest Reason: https://sonarwhal.com/docs/user-guide/rules/rule-manifest-file-extension/ * Updated link to file * team development workflows (#5084) * team development workflows * Small typos * Revert "Small typos" This reverts commit ee7bc36. * Revert "team development workflows" This reverts commit a9e5498. * move doc to blog * excerpt * Publish - [email protected] - [email protected] - [email protected] - [email protected] * Hyperlinks, optionality, and "easy" (#5154) Added a few changes. This document needs to be reorganized eventually; I just want to add these notes in the fastest way possible now so I don't forget them. * Add bartvanderwaerden.com to showcase (#5152) * I guess I found the wrong word... (#5088) I think line 308's `src/pages/my-files.js` is wrong. It should be `src/pages/index.js` isn't it? * Add two missing spaces (minor validation error) (#5150) My previous commit missed adding a space after the backup blank `src=""` and `alt=""` attributes. This causes an HTML validation error when no `alt` value is supplied. This commit simply adds those missing spaces (i.e. `src="" ` and `alt="" `) so there will always be a space between attributes. * Adjust image processing example queries (#5158) * adjust queries to not use id as way to select by filenames this will stop working in gatsby v2 * add link to code * Update KaTeX to 0.9.0 (#4712) * Update KaTeX to 0.9.0 * Update snapshots * DCO bye-bye (#5165) * source-contentful: Add environment support (#5142) * source-contentful: Add environment support * fix lint * fix default locale logix * log error * Update lock file * Ulog the error * Update package-lock.json * revert lock changes, test shrinkwrap * remove shrinkwrap, it's unused after all, add yarn resolutions * cleanup debug console logs * Link an example that uses gatsby-transformer-json (#5169) * Publish - [email protected] - [email protected] - [email protected] - [email protected] * Update RNW plugin and example (#5174) * Update RNW example to use new plugin version Signed-off-by: slorber <[email protected]> * Update React in example Signed-off-by: slorber <[email protected]> * Enhance RNW example Signed-off-by: slorber <[email protected]> * Add link to online demo Signed-off-by: slorber <[email protected]> * Add screenshot Signed-off-by: slorber <[email protected]> * Update createRemoteFileNode documentation (#5171) * Update createRemoteFileNode documentation * Update README.md * Fix replaceHydrateFunction doc (#5175) * Fix replaceHydrateFunction doc * Add spaces * Update "how gatsby works" documentation (#243) (#5181) * Add a note about CNAME file in `static` * Fix typo in the .eslintrc file (#5173) * added my site (#5172) * Added rafael.do (#5199) * Add Eviction Free NYC blog post and link to site (#5159) * Add evictionfreenyc.org to showcase * Add Eviction Free NYC blog post * Fixing a typo * Copy edits * Self-contained images * [Ready 4 Review] SQIP - Vectorized primitive image previews (#4205) * first working version with Contentful assets only * add readme * respect width, height, aspect ratio, cropping, resize focus and background * add support for gatsby-transformer-sharp * integrate in gatsbygram * avoid useless regeneration cus contentDigest changes * proper way to get absolute path to ImageSharp nodes * queue preview generation and cache results on disk * upgrade to latest node-sqip to get rid of the GoLang dependency * replace custom svg data uri function with package * prepare images via sharp plugin and allow sharp transformations * load cached svg properly from disk * fix queue resolving to early * set contentful images to 400px * implement new sharp transformation awareness feature * WIP - extract generation and write first pseudo test * fix styling for gatsbygram post detail * finalize unit tests for actual sqip implementation * use 256px input image width to match sqip/primitive default * add using-sqip example page * some cleanup * clean up example and enhance polaroid effect * fix using-sqip dependency * remove base64 since it was not implemented and is bad for compression * remove sqip from gatsbygram example * simplify tests * Small change to trigger build * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * Add tutorial on creating a source plugin * Format * Add extensions to .eslintrc (#5206) - Add .json or .yaml extension to .eslintrc files ```shell $ cd ./packages $ rename 's/.eslintrc/.eslintrc.yaml/' `find . -name .eslintrc` $ cd ../ $ rename 's/.eslintrc/.eslintrc.json/' `find . -name .eslintrc` ``` - Tweak plopfile.js to add .json extension to examples to be generated Signed-off-by: Masato Ohba <[email protected]> * Add gatsby-starter-bulma-storybook to the starters list (#5208) Signed-off-by: Gianni Valdambrini <[email protected]> * fix: style and typo correction - Minor style tweaks (e.g. unlinked "pixabay.com" => "Pixabay") - Typo patrol - De-British some of the language (my apologies to the letter U) * Toodle-pip British u * Adjust heading hierarchy * Use relative urls for gatsbyjs.org links * Pull last few sections up a level * Minor edits and consistency tweaks * Cleanup example for the createPages API (#5216) * Update with @shannonbux's edits * Additional header * Bumps gatsby-plugin-mailchimp to 2.2.2 bc we updated its API to be more user friendly (#5215) * Add YAML data file for site showcase (#5227) * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * Update to Gitlab pages deploy (#5243) * Update to Gitlab pages deploy Gitlab pages now include a Gatsby template for CI, which makes it a lot easier to add. Have updated the documentation to reflect this. * Edit * Update README.md (#5247) Adding explanation about available option `offsetY` to solve issue #5061 Signed-off-by: Robin Cussol <[email protected]> * [gatsby-source-contentful] Fix storing new sync token (#5252) * Add https://emoji.tinder.com/ to showcase (#5257) * Fix typo (#5241) * Link to website in contributing.md (#5249) * Publish - [email protected] - [email protected] - [email protected] * Bump versions of packages that failed to publish earlier * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * Add top padding for tablet masthead (#5266) * wordpress-source-plugin-tutorial (#5235) * wordpress-source-plugin-tutorial Not sure if I got all the code samples formatted correctly. Still need to edit the index.js page so the <p> tags don't render!! Then, need a screenshot of the final result without <p> tags! * removed unnecessary backticks and corrected link to Part 7 of tutorial * Make links relative * Use graphql for syntax highlighting + minor copy edits * Image Tutorial (#5236) * Image Tutorial Would be nice to add a screenshot of the finished result. Eventually, a really cool image tutorial could include GIFs. * Remove unneeded backticks around code * Add example gif * Fix image links * added Gatsbygram link, fixed assumption spelling * we --> you * Added some more edits of my own wasn't sure whether you wanted lines 153-155 to stay the same * Changed back to previous lines 149-159 I accidentally deleted necessary stuff in my previous commit, so I'm just starting over * Edited comments per Mike's suggestions * Small tweaks * Add site (#5268) * readme: Add aQuICK QC landing page site * readme: Kill old event specific page * Quick fix for wordpress source plugin tutorial (#5276) Fragments don't work on Graphiql * Minor fix on wordpress source plugin tutorial (#5277) removed typo * Update wordpress-source-plugin-tutorial.md (#5278) * add missing underscore to graphiql URL (#5275) * add missing underscore to graphiql * Update image-tutorial.md * Update wordpress-source-plugin-tutorial.md (#5279) * Update image-tutorial.md (#5281) * Update source-plugin-tutorial.md (#5283) * add missing .npmignore and .babelrc to sqip transformer (#5282) * Publish - [email protected] * Fix typos in source-plugin-tutorial (#5284) * Add workshop-in-the-woods.com to the showcase (#5291) * Update README.md (#5288) * Update README.md Missing curly bracket * formatting * Fix doc typo (#5294) * fix: chang the url of blog in readme 🐛 (#5302) * feat: ✨ add gatsby-new-blog plugin * docs: update showcase 📝 * flag importance of plugin order for prism-js vs embed-snippet (#5313) If gatsby-remark-prism-js is declared before gatsby-remark-embed-snippet, the latter will not pick up the `embed:example.js` syntax because it is looking for an inline-code node and it will have been transformed into a p node by gatsby-remark-prism-js. This needs to be noted as this is far from obvious. * Add manifest.webmanifest to staticFileGlobs (#5300) Signed-off-by: Kaue Machado <[email protected]> * Publish - [email protected] - [email protected] - [email protected] * Fix post path comment (#5295) * Fix post path * Fix * Expand docs for custom components (#5315) * Expand docs for custom components The docs for custom components only mention defining custom components in the markdown, but don't address one of the most useful aspects - that you can map generic markdown tags/elements to your own components. I've expanded the docs to point this out and added a simple example. * Typo * plugin-feed: Note feed xml file is production only (#5305) Add note that the rss.xml feed is only generated in production. * Fixing grammar around CSS Modules (#5286) * Fix broken link to tutorial for building blog (#5273) I don't know if it's the original article but at least it looks fairly similar * added develop command options to use custom key and certs (#5056) * added develop command options to use custom key and certs * fixed typos in doc * added condition to make sure both --key-file and --cert-file are present * - passing https flag results in automatic https certs [devcert] - --cert-file, --key-file, and --https flags can be used together for custom ssl - if all flags needed for custom ssl are not present an error is displayed to the user - if provided --cert-file and --key-file paths are not real files, node gives a rejection - modified docs to express current behavior * Add portfolio to the created with gatsby section (#5331) * Documentation for images in page components #3380 (#4191) * adding first draft * adding info about fragments * cleaning up language * renaming file, this commit is for issue #3380 * technical edits on working with images in gatsby * technical edits on working with images in gatsby * punctuation and verb tense edits * more punctuation and grammar * commas * Add new docs page to sidebar (#5339) * New issue, feature and question template (#5274) * Basic template for new issues * updated issue template * updated issue template * Update ISSUE_TEMPLATE.md * Update ISSUE_TEMPLATE.md * changed bug report to the new GitHub issue template * add feature request template * question template * fixed title of question and added emojis * added RFC to question template * Update bug_report.md * Update feature_request.md * Update question.md * Typo * Update custom-html.md (#5341) * Update custom-html.md grammar corrections * Revert one change * Actually revert that one change * add plugin option examples (#5345) add plugin option examples * Remove workshop banner now that workshops have finished (#5338) * Update url-loader (#5342) * Update plugins.md * [gatsby-source-contentful]: Add fallback locale support (#5328) * Add fallback locale support * Fix linting * test: Fix test * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * [gatsby-source-wordpress] check if parent exists (#5373) * [gatsby-source-filesystem] add fs error handling, bump got retry attemps count (#5375) * [gatsby-source-filesystem] catch fs stream errors * [gatsby-source-filesystem] bump got retries from default 2 to 5 * normalize reject payload * Add context to query-runner error log (#5214) * [www] Prevent image twitching in Chrome when hovering a blog index card (#5396) * [gatsby-transformer-yaml] Update docs: GraphQL query mismatch (#5402) GraphQL query references "value" when it should actually reference "character" as per the example output. * [gatsby-transformer-json] Update docs: outdated Readme examples (#5403) `{ internal: { type } }` exists but it would actually be "LettersJson" (according to my GraphiQL checks). Seems better to just remove this, so it at least has parity with gatsby-transformer-yaml readme. * Add "Six Reasons I Chose Gatsby" blog post (#5369) * added "Six Reasons I Chose Gatsby" blog post * added site to showcase * updated content based on review comments * updated Gatsby links to be relative * Fix for IE10 not loading scripts (#5404) * Fix for IE10 not loading scripts * Fixed duplicate declaration. * Update example config for netlify-cms (#5405) Added the public_folder attribute to make the assets accessible. Also added the body field to the collection, so the html attribute of markdownRemark gets filled properly. Figuring out that the field has to be named "body" was a bit cumbersome. https://www.netlifycms.org/docs/configuration-options/#fields * Fix regression with prefix paths and gatsby-plugin-manifest (#5406) as per 69ca247#diff-079fdad4111264c646208511aa18a321 manifest.webmanifest should start with / it just works (tm) when your site is flat, but when your pages are in sub directory and prefixed, its assumes your manifest files are in the subdirectory, not the root of your site (which might be prefixed). Fixing reversion * Remove old comment (#5407) Code changed in #5404, this comment no longer relevant. * Add gatsby-starter-modern (#5427) * Publish - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] - [email protected] * Mention in building apps docs page that we use React Router under the hood (#5439) * Add a how to add search to your website section (#5272) * Add a how to add search to your website section * Update adding-search.md * Update doc-links.yaml * Update adding-search.md * Better restructuring * Update doc-links.yaml * Update adding-search.md * Address Changes * Rewrite docs * Add the link before the links to stub articles The ones ending with * are stubs * Tidy up * Grammar/punctuation edits and some wording edits * Adding Headers * Edits * More headings * Minor edits * Update adding-search.md (#5448) * regenerate yarn.lock * temporarily disable stylus tests - need to update both tests and example sites to v2 * fix wrong conflict resolution
1 parent 91d5f4f commit 9b48eab

File tree

164 files changed

+5163
-538
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

164 files changed

+5163
-538
lines changed

.eslintrc renamed to .eslintrc.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262
{
6363
"files": [
6464
"packages/**/gatsby-browser.js",
65-
"pacakges/gatsby/cache-dir/**/*"
65+
"packages/gatsby/cache-dir/**/*"
6666
],
6767
"env": {
6868
"browser": true

.github/ISSUE_TEMPLATE.md

Lines changed: 0 additions & 45 deletions
This file was deleted.
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
name: Bug Report 🐞
3+
about: Something isn't working as expected? Here is the right place to report.
4+
---
5+
6+
<!--
7+
To make it easier for us to help you — please follow the suggested format below.
8+
9+
Useful Links:
10+
- Documentation: https://www.gatsbyjs.org/docs/
11+
- How to File an Issue: https://www.gatsbyjs.org/docs/how-to-file-an-issue/
12+
13+
Before opening a new issue, please search existing issues https://github.com/gatsbyjs/gatsby/issues
14+
-->
15+
16+
## Description
17+
18+
Describe the issue that you're seeing.
19+
20+
### Steps to reproduce
21+
22+
Clear steps describing how to reproduce the issue.
23+
24+
### Expected result
25+
26+
What should happen?
27+
28+
### Actual result
29+
30+
What happened.
31+
32+
### Environment
33+
* Gatsby version (`npm list gatsby`):
34+
* gatsby-cli version (`gatsby --version`):
35+
* Node.js version:
36+
* Operating System:
37+
38+
### File contents (if changed)
39+
`gatsby-config.js`: N/A <!-- Please use a code block or just leave it as is if wasn't changed -->
40+
`package.json`: N/A <!-- Please use a code block or just leave it as is if wasn't changed -->
41+
`gatsby-node.js`: N/A <!-- Please use a code block or just leave it as is if wasn't changed -->
42+
`gatsby-browser.js`: N/A <!-- Please use a code block or just leave it as is if wasn't changed -->
43+
`gatsby-ssr.js`: N/A <!-- Please use a code block or just leave it as is if wasn't changed -->
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
name: Feature Request 💡
3+
about: Suggest a new idea for the project.
4+
---
5+
6+
<!--
7+
To make it easier for us to help you — please follow the suggested format below.
8+
9+
Useful Links:
10+
- Gatsby RFCs: https://github.com/gatsbyjs/rfcs
11+
- How to Contribute: https://www.gatsbyjs.org/docs/how-to-contribute/
12+
- How to File an Issue: https://www.gatsbyjs.org/docs/how-to-file-an-issue/
13+
14+
Before opening a new issue, please search existing issues https://github.com/gatsbyjs/gatsby/issues
15+
-->
16+
17+
## Summary
18+
19+
Brief explanation of the feature.
20+
21+
### Basic example
22+
23+
If the proposal involves a new or changed API, include a basic code example. Omit this section if it's not applicable.
24+
25+
### Motivation
26+
27+
Why are we doing this? What use cases does it support? What is the expected outcome?

.github/ISSUE_TEMPLATE/question.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
name: Question 🤔
3+
about: Usage question or discussion about Gatsby.
4+
---
5+
6+
<!--
7+
To make it easier for us to help you, please include as much useful information as possible.
8+
9+
Useful Links:
10+
- Documentation: https://www.gatsbyjs.org/docs/
11+
12+
Gatsby has several community support channels, try asking your question on:
13+
14+
- Discord: https://discord.gg/0ZcbPKXt5bVoxkfV
15+
- Spectrum: https://spectrum.chat/gatsby-js
16+
- Twitter: https://twitter.com/gatsbyjs
17+
18+
Before opening a new issue, please search existing issues https://github.com/gatsbyjs/gatsby/issues
19+
-->

CONTRIBUTING.md

Lines changed: 2 additions & 156 deletions
Original file line numberDiff line numberDiff line change
@@ -1,157 +1,3 @@
1-
---
2-
title: How to Contribute
3-
---
1+
## How to Contribute
42

5-
## Contributing
6-
7-
We want contributing to Gatsby to be fun, enjoyable, and educational for anyone and everyone. Contributions go far beyond pull requests and commits; we are thrilled to receive a variety of other contributions including the following:
8-
9-
* Blogging, speaking about, or creating tutorials about one of Gatsby's many features. Mention @gatsbyjs on Twitter and/or email shannon [at] gatsbyjs [dot] com so we can give pointers and tips (if you want them :) and help you spread the word. Please add your blog posts and videos of talks to our [Awesome Gatsby](/docs/awesome-gatsby/) page.
10-
* [Submit new feature ideas through an RFC](/blog/2018-04-06-introducing-gatsby-rfc-process/)
11-
* Submitting new documentation; titles in _italics_ on gatsbyjs.org are stubs and need contributions
12-
* Tweeting about things you build with @gatsbyjs (make sure to @ mention us!)
13-
* Submitting documentation updates, enhancements, designs, or bugfixes
14-
* Submitting spelling or grammar fixes
15-
* Adding unit or functional tests
16-
* Triaging [GitHub issues](https://github.com/gatsbyjs/gatsby/issues) -- especially determining whether an issue still persists or is reproducible
17-
* [Reporting bugs or issues](/docs/how-to-file-an-issue/)
18-
* Searching for Gatsby on Discord or Spectrum and helping someone else who needs help
19-
* Teaching others how to contribute to Gatsby's repo!
20-
21-
If you are worried or don't know where to start, you can always reach out to Shannon Soper(@shannonb_ux) on Twitter or simply submit an issue and a maintainer can help give you guidance!
22-
23-
Looking to speak about Gatsby? We'd love to review your talk abstract/CFP! You can email it to shannon [at] gatsbyjs [dot] com, and we can give pointers or tips!!!
24-
25-
### Creating your own plugins and loaders
26-
27-
If you create a loader or plugin, we would <3 for you to open source it and put it on npm. For more information on creating custom plugins, please see the documentation for [plugins](/docs/plugins/) and the [API specification](/docs/api-specification/).
28-
29-
### Contributing to the repo
30-
31-
Gatsby uses a "monorepo" pattern to manage its many dependencies and relies on
32-
lerna and yarn to configure the repository for active development.
33-
34-
You can install the latest version of Gatsby by following these steps:
35-
36-
* Clone the repo, navigate to its directory.
37-
* ensure you have the latest version of yarn installed (>= 1.0.2)
38-
https://yarnpkg.com/en/docs/install
39-
* Install dependencies using `yarn run bootstrap` in the root of the repo.
40-
41-
The usual contributing steps are:
42-
43-
* Fork the [official repository](https://github.com/gatsbyjs/gatsby).
44-
* Clone your fork: git clone `[email protected]:<your-username>/gatsby.git`
45-
* Setup up repo and install dependencies: `yarn run bootstrap`
46-
* Make sure tests are passing for you: `yarn test`
47-
* Create a topic branch: `git checkout -b topics/new-feature-name`
48-
* Run `yarn run watch` from the root of the repo to watch for changes to packages' source code and compile these changes on-the-fly as you work. Note that the watch command can be resource intensive. To limit it to the packages you're working on, add a scope flag, like `yarn run watch --scope={gatsby,gatsby-cli}`. To watch just one package, run `yarn run watch --scope=gatsby`.
49-
* Install [gatsby-dev-cli](/packages/gatsby-dev-cli/) globally: `yarn global add gatsby-dev-cli`
50-
* Run `yarn install` in each of the sites you're testing.
51-
* For each of your Gatsby test sites, run the `gatsby-dev` command there to copy
52-
the built files from your cloned copy of Gatsby. It'll watch for your changes
53-
to Gatsby packages and copy them into the site. For more detailed instructions
54-
see the [gatsby-dev-cli README](/packages/gatsby-dev-cli/)
55-
* Add tests and code for your changes.
56-
* Once you're done, make sure all tests still pass: `yarn test`
57-
* Commit with a ["Signed-off-by"](#developer-certificate-of-origin) line appended
58-
to your commit message and push to your fork.
59-
* Create a pull request from your branch.
60-
61-
### Contributing to the documentation.
62-
63-
Gatsby, unsurprisingly, uses Gatsby for its documentation website.
64-
65-
If you want to add/modify any Gatsby documentation, go to the
66-
[docs folder on GitHub](https://github.com/gatsbyjs/gatsby/tree/master/docs) and
67-
use the file editor to edit and then preview your changes. GitHub then allows
68-
you to commit the change and raise a PR right in the UI. This is the _easiest_
69-
way you can contribute to the project!
70-
71-
However, if you want to make more changes to the website, that is, change
72-
layouts, add sections/pages, follow the steps below. You can then spin up your
73-
own instance of the Gatsby website and make/preview your changes before raising
74-
a pull request.
75-
76-
* Clone the repo and navigate to `/www`
77-
* Run `yarn` to install all of the website's dependencies.
78-
* Run `gatsby develop` to preview the website in `http://localhost:8000`
79-
* The Markdown files for the documentation live in `/docs` folder. Make
80-
additions or modifications here.
81-
* Make sure to double check your grammar and capitalise correctly.
82-
* Commit with a ["Signed-off-by"](#developer-certificate-of-origin) line appended
83-
to your commit message and push to your fork.
84-
* Create a pull request from your branch.
85-
86-
### Developer Certificate of Origin
87-
88-
The Gatsby repository enforces the
89-
[Developer Certificate of Origin](https://developercertificate.org/) (DCO) on
90-
Pull Requests. It requires all commit messages to contain the `Signed-off-by`
91-
line with an email address that matches the commit author.
92-
93-
Git has a `-s` (or longer `--signoff`) command line option to append this
94-
automatically to your commit message:
95-
96-
```shell
97-
$ git commit -s -m 'This is my commit message'
98-
```
99-
100-
If you've already created a Pull Request and notice that the DCO check is failing, you
101-
can use this command to append a signoff message to your commits:
102-
103-
```shell
104-
$ git rebase --signoff
105-
```
106-
107-
or amend your last commit if you have a single commit in your Pull Request:
108-
109-
```shell
110-
$ git commit --amend -s
111-
```
112-
113-
## Development tools
114-
115-
### Redux devtools
116-
117-
Gatsby uses Redux for managing state during development and building. It's often
118-
helpful to see the flow of actions and built-up state for a site you're working
119-
on or if adding new functionality to core. We leverage
120-
[Remote Redux Devtools](https://github.com/zalmoxisus/remote-redux-devtools) and
121-
[RemoteDev Server](https://github.com/zalmoxisus/remotedev-server) to give you use the Redux
122-
devtools extension for debugging Gatsby.
123-
124-
To use this, first install
125-
[redux-devtools-extension](https://github.com/zalmoxisus/redux-devtools-extension)
126-
in your browser. Then in your Gatsby repo, run `npm run remotedev`. Then in your
127-
site directory run `REDUX_DEVTOOLS=true gatsby develop`. Depending on your
128-
operating system and shell, you may need to modify how you set the
129-
`REDUX_DEVTOOLS` environment variable.
130-
131-
At this point, your site will be sending Redux actions and state to the remote
132-
server.
133-
134-
To connect to this, you need to setup the devtools extension to talk to the
135-
remote server.
136-
137-
First open the remote devtools.
138-
139-
![how to open the redux remote devtools extension](./images/open-remote-dev-tools.png)
140-
141-
Then click settings along the bottom menu and set the host and port.
142-
143-
![how to set the host/port for the remote devtools extension to connect to Gatsby](./images/remote-dev-settings.png)
144-
145-
After this, the devtools extension _should_ connect to the remote server and
146-
you'll see actions start showing up.
147-
148-
![gatsby redux remote devtools](./images/running-redux-devtools.png)
149-
150-
**Warning!! Lots of buginess**. While having this available is extremely
151-
helpful, this setup is very buggy and fragile. There is a memory leak in the
152-
extension that's triggered it seems every time you restart the Gatsby
153-
development server. Also the extension often, for no apparent reason, just won't
154-
show any actions from the remote server. It'll also often freeze up. The best
155-
solution seems to just be turning everything off and on again. Fixing up these
156-
tools would be very helpful for us and many others using these tools if someone
157-
wants to take this on!
3+
For information related to contributing to Gatsby, please check out the [How to Contribute](https://www.gatsbyjs.org/docs/how-to-contribute/) section of the documentation at the Gatsby site.

README.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ Websites built with Gatsby:
2323
* [The freeCodeCamp Guide](https://guide.freecodecamp.org)
2424
([source](https://github.com/freeCodeCamp/guides))
2525
* [Storybook](https://storybook.js.org) ([source](https://github.com/storybooks/storybook))
26+
* [Learn Storybook](https://learnstorybook.com) ([source](https://github.com/hichroma/learnstorybook.com))
2627
* [FloydHub's Blog](https://blog.floydhub.com)
2728
* [mParticle's Documentation](https://docs.mparticle.com)
2829
* [Segment's Blog](https://segment.com/blog/)
@@ -164,7 +165,7 @@ Websites built with Gatsby:
164165
* [Portfolio / Blog of Preston Richey](https://prestonrichey.com/) ([source](https://github.com/prichey/prestonrichey.com))
165166
* [Beach Hut Poole](https://www.beachhutpoole.co.uk/)
166167
* [In Sowerby Bridge](https://www.insowerbybridge.co.uk/)
167-
* [枫上雾棋的日志](https://fengshangwuqi.github.io/fswq-blog/)
168+
* [枫上雾棋的日志](https://fengshangwuqi.github.io/)
168169
* [Juliette Pretot's Portfolio](https://juliette.sh)
169170
* [Théâtres Parisiens](http://theatres-parisiens.fr/) ([source](https://github.com/phacks/theatres-parisiens))
170171
* [Jia Hao's Website / Blog](https://jiahao.codes/) ([source](https://github.com/jiahaog/jiahao.codes))
@@ -194,8 +195,6 @@ Websites built with Gatsby:
194195
* [WebGazer](https://www.webgazer.io)
195196
* [Joe Seifi's Blog](http://seifi.org)
196197
* [Bartosz Dominiak Blog/Portfolio](http://www.bartoszdominiak.com/) ([source](https://github.com/bartdominiak/blog))
197-
* [HBTU MUN 2018](https://hbtumun18.netlify.com/)
198-
([source](https://github.com/HaoZeke/hbtuMun18))
199198
* [The Audacious Project](https://audaciousproject.org/)
200199
* [upGizmo](https://www.upgizmo.com/)
201200
* [The Bastion Bot](https://bastionbot.org/ "The Bastion Bot")
@@ -204,6 +203,18 @@ Websites built with Gatsby:
204203
* [F1 Vision](https://f1vision.com/)
205204
* [GraphQL College](https://graphql.college) ([source](https://github.com/GraphQLCollege/graphql-college))
206205
* [Hyunwoo Kim - Blog/Portfolio](https://devhalloween.com) ([source](https://github.com/khw1031/dev-blog))
206+
* [Abinav Seelan - Personal Website](https://abinavseelan.com) ([source](https://github.com/abinavseelan/abinavseelan.com))
207+
* [Dovetail](https://dovetailapp.com)
208+
* [Bart van der Waerden Blog](http://bartvanderwaerden.com/) ([source](https://github.com/BartvdWaerden/BartvdWaerden.github.io))
209+
* [Canella Riccardo - Portfolio](https://canellariccardo.it) ([source](https://github.com/thecreazy/canellariccardo.it))
210+
* [Eviction Free NYC!](https://www.evictionfreenyc.org/) ([source](https://github.com/JustFixNYC/eviction-free-nyc))
211+
* [Rafael Belliard's Portfolio](https://rafael.do) ([source](https://github.com/rebelliard/rebelliard.github.io))
212+
* [Tinder Interracial Couple Emoji Project](https://emoji.tinder.com/)
213+
* [aQuICK](https://aquick.review/)
214+
([source](https://github.com/aQuICK-Review/aQuick))
215+
* [Workshop In The Woods](https://www.workshop-in-the-woods.com/) ([source](https://github.com/ryanwiemer/workshop))
216+
* [Steven Koerts - Portfolio](http://stevenkoerts.nl/)([source](https://github.com/Steven24K/Steven24K.github.io))
217+
* [Ray Gesualdo - Personal Website](http://www.raygesualdo.com/) ([source](https://github.com/raygesualdo/raygesualdo.com))
207218

208219
## Docs
209220

docs/blog/2018-03-07-why-we-created-the-plugin-library/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ From October 2017 to February 2018, I conducted over 60 interviews with Gatsby u
1515

1616
## Jobs to be done
1717

18-
After compiling data from the interviews, I drew what’s called an “empathy map” to put myself in the shoes of Gatsby users. This map describes what a Gatsby users usually experienced when searching for plugins.
18+
After compiling data from the interviews, I drew what’s called an “empathy map” to put myself in the shoes of Gatsby users. This map describes what Gatsby users usually experienced when searching for plugins.
1919

2020
![Empathy map](empathy-map.png)
2121

0 commit comments

Comments
 (0)