Docs Progress

[xmartinezpujol]

🚨 Please Read this before contributing 🚨

Maintainer List

@Darking360 @horacioh @nucliweb @gusma @xmartinezpujol

For New Translators

To translate a page:

1. Check that no one else has claimed your page in the checklist and comments below. Do not create new issues claiming for new work please, let's keep everything here. If you already have an issue opened, please close it after your PR gets merged 🎉. Thanks!
2. Comment below with the name of the page you would like to translate. Take only one page at a time.
3. Submit a PR, assign @horacioh, @Darking360, @nucliweb, @gusma or @xmartinezpujol and add a link to it to your comment!

Please check the Style guide to make sure translations are written in a consistent manner.

Work List

• 🏃 Work in Progress
• 👀 In Review
• 🎉 Done

Docs/Docs

• [x] add-404-page.md
• [x] add-a-manifest-file.md
• [x] add-a-service-worker.md
• [x] add-custom-webpack-config.md
• [ ] add-offline-support-with-a-service-worker.md (@elpuas) 👀
• [x] add-page-metadata.md
• [x] add-seo-component.md (@jorgeepc) 🎉
• [x] adding-a-list-of-markdown-blog-posts.md (@SerotoninaAbad) 🎉
• [x] adding-an-rss-feed.md
• [x] adding-analytics.md
• [x] adding-comments.md
• [x] adding-forms.md (@anblave) 🎉
• [x] adding-markdown-pages.md (@jotagarciaz) 🎉
• [x] adding-page-transitions-with-plugin-transition-link.md (@anblave) 🎉
• [x] adding-page-transitions.md (@alvaromontoro) 🎉
• [x] adding-pagination.md (@kararade) 🎉
• [x] adding-search-with-algolia.md (@SerotoninaAbad) 🎉
• [ ] adding-search-with-elasticlunr.md // stub
• [ ] adding-search-with-js-search.md (@anblave) 🏃
• [x] adding-search.md
• [x] adding-tags-and-categories-to-blog-posts.md (@jorgeepc) 🎉
• [x] adding-website-functionality.md (@jose4125) 🎉
• [x] answering-it-security.md (@kararade) 🎉
• [ ] api-proxy.md (@anblave) 🏃
• [x] api-reference.md (@kinduff) 🏃
• [x] api-specification.md (@alvaromontoro) 🎉
• [ ] asset-prefix.md (@kinduff) 🏃
• [x] audit-with-lighthouse.md (@jorgeepc) 🎉
• [ ] awesome-gatsby.md (@luucamay) 🏃
• [ ] babel-plugin-macros.md (@anblave) 🏃
• [x] babel.md (@Diegoavilap) 🎉
• [ ] basic-hardware-software-requirements.md // stub
• [ ] best-practices-for-orgs.md // stub
• [x] browser-support.md (@kararade) 🎉
• [x] build-caching.md
• [ ] building-a-blog.md // stub
• [ ] building-a-contact-form.md (@SerotoninaAbad) 🏃
• [x] building-a-portfolio.md (@jatempa) 🎉
• [ ] building-a-site-with-asynchronous-data.md // stub
• [x] building-a-site-with-authentication.md (@JuanJavier1979) 🎉
• [ ] building-an-e-commerce-site.md // stub
• [ ] building-an-image-heavy-site.md // stub
• [x] building-apps-with-gatsby.md (@JuanJavier1979) 🎉
• [x] building-with-components.md (@JuanJavier1979) 🎉
• [ ] bulma.md (@blackfile) 🏃
• [ ] caching.md (@ginoemiliozzi) 🏃
• [ ] centralizing-your-sites-navigation.md
• [x] cheat-sheet.md (@pastenes) 🎉
• [x] client-data-fetching.md (@pastenes) 🎉
• [x] client-only-routes-and-user-authentication.md (@pastenes) 🎉
• [ ] coming-from-react-to-gatsby.md // stub
• [x] component-libraries.md (@pastenes) 🎉
• [x] conceptual-guide.md (@gusma) 🏃
• [x] configuring-ca-certificates.md (@palehox) 🎉
• [x] content-and-data.md (@YeisonTapia) 🎉
• [x] convincing-others.md
• [x] creating-a-local-plugin.md (@kararade) 🎉
• [x] creating-a-sitemap.md
• [x] creating-a-source-plugin.md (@JuanJavier1979) 🏃
• [x] creating-a-starter.md (@JuanJavier1979) 🎉
• [x] creating-a-transformer-plugin.md (@JuanJavier1979) 🎉
• [x] creating-and-modifying-pages.md (@pastenes) 🎉
• [x] creating-global-styles.md (@kararade) 🎉
• [x] creating-plugins.md (@kararade) 🎉
• [x] creating-prefixed-404-pages-for-different-languages.md (@alvaromontoro) 🎉
• [x] creating-slugs-for-pages.md (@pastenes) 🎉
• [x] css-in-js.md
• [x] css-libraries-and-frameworks.md
• [ ] css-modules.md (@spaceinvadev) 🏃
• [x] custom-html.md
• [ ] customization.md (@pastenes) 🏃
• [ ] data-storage-redux.md // stub
• [ ] debugging-async-lifecycles.md (@pastenes) 🏃
• [ ] debugging-cache-issues.md (@pastenes) 🏃
• [ ] debugging-html-builds.md (@pastenes) 🏃
• [ ] debugging-replace-renderer-api.md
• [ ] debugging-the-build-process.md
• [ ] debugging.md // stub
• [x] deploying-and-hosting.md (@dantehemerson) 🎉
• [ ] deploying-to-aerobatic.md (@Diegoavilap) 🏃
• [ ] deploying-to-aws-amplify.md (@ManudeQuevedo) 🏃
• [ ] deploying-to-gitlab-pages.md
• [ ] deploying-to-heroku.md
• [ ] deploying-to-netlify.md (@ManudeQuevedo) 🏃
• [ ] deploying-to-render.md
• [ ] deploying-to-s3-cloudfront.md
• [ ] deploying-to-surge.md
• [ ] deploying-to-zeit-now.md (@ManudeQuevedo) 🏃
• [ ] different-organization-types.md
• [x] emotion.md (@zombispormedio) 🎉
• [ ] end-to-end-testing.md
• [ ] environment-variables.md
• [x] eslint.md
• [x] faster-recruiting.md
• [ ] files-gatsby-looks-for-in-a-plugin.md
• [ ] first-professional-project.md
• [ ] gatsby-agency-partnership.md
• [ ] gatsby-cli.md (@jatempa ) 🏃
• [ ] gatsby-config.md
• [ ] gatsby-core-philosophy.md
• [x] gatsby-for-agencies.md (@dantehemerson) 🎉
• [ ] gatsby-for-companies.md
• [ ] gatsby-for-freelancers.md // stub
• [ ] gatsby-image.md
• [ ] gatsby-in-the-enterprise.md
• [ ] gatsby-internals-terminology.md
• [ ] gatsby-internals.md
• [ ] gatsby-lifecycle-apis.md
• [ ] gatsby-link.md
• [x] gatsby-on-linux.md (@kinduff) 🏃
• [ ] gatsby-on-windows.md
• [x] gatsby-project-structure.md
• [ ] gatsby-repl.md
• [ ] gatsby-source-filesystem-programmatic-import.md // stub
• [ ] gatsby-vendor-partnership.md
• [ ] glamor.md
• [x] global-css.md
• [ ] glossary.md
• [x] going-gatsby-only.md (@spaceinvadev) 🎉
• [ ] graphql-api.md
• [ ] graphql-concepts.md (@jorgeepc) 🏃
• [ ] graphql-reference.md
• [x] graphql.md
• [x] guides.md (@YeisonTapia) 🎉
• [x] headless-cms.md (@JuanJavier1979) 🎉
• [ ] how-code-splitting-works.md
• [x] how-gatsby-boosts-career.md (@spaceinvadev) 🎉
• [ ] how-gatsby-works-with-github-pages.md
• [ ] how-plugins-apis-are-run.md
• [ ] how-shadowing-works.md
• [ ] how-to-add-a-list-of-markdown-blog-posts.md // stub
• [ ] html-generation.md (@AlejandroRV) 🏃‍♂️
• [x] images-and-files.md (@YeisonTapia) 🎉
• [ ] importing-assets-into-files.md
• [ ] importing-media-content.md
• [ ] interactive-pages.md // stub
• [ ] internal-data-bridge.md
• [ ] layout-components.md (@remediosaraya) 🏃‍♂️
• [ ] life-and-times-of-a-gatsby-build.md // stub
• [ ] linking-and-prefetching-with-gatsby.md // stub
• [ ] linking-between-pages.md
• [ ] loading-plugins-from-your-local-plugins-folder.md
• [ ] local-https.md
• [ ] localization-i18n.md (@YeisonTapia )🏃‍♂️
• [ ] lower-bids-more-profit.md
• [ ] maintaining-a-plugin.md // stub
• [ ] making-components-discoverable.md
• [ ] making-your-site-accessible.md
• [ ] migrating-from-v0-to-v1.md
• [ ] migrating-from-v1-to-v2.md
• [ ] multi-core-builds.md
• [ ] naming-a-plugin.md
• [ ] node-creation.md
• [ ] node-interface.md
• [ ] node-tracking.md
• [ ] optimizing-site-performance-with-guessjs.md
• [ ] overview.md // stub
• [ ] page-creation.md
• [ ] page-node-dependencies.md
• [ ] page-query.md
• [ ] partnering-with-gatsby.md
• [ ] path-prefix.md
• [ ] performance-tracing.md
• [ ] performance.md
• [ ] pixabay-source-plugin-tutorial.md
• [ ] plugins.md
• [ ] porting-from-create-react-app-to-gatsby.md
• [ ] porting-to-gatsby.md // stub
• [x] post-css.md (@spaceinvadev) 🎉
• [ ] preoptimizing-images.md
• [ ] preparing-for-deployment.md
• [ ] preparing-for-site-launch.md
• [ ] preparing-your-environment.md
• [ ] production-app.md
• [ ] programmatically-create-pages-from-data.md
• [ ] progressive-web-app.md
• [ ] prpl-pattern.md
• [ ] query-behind-the-scenes.md
• [ ] query-execution.md
• [ ] query-extraction.md
• [ ] quick-start.md (@jclopezdev) 🏃
• [ ] reach-router-and-gatsby.md // stub
• [ ] recipes.md
• [ ] releases-and-migration.md
• [ ] remark-plugin-tutorial.md
• [ ] rendering-sidebar-navigation-dynamically.md // stub
• [ ] resource-handling-and-service-workers.md
• [x] routing.md (@YeisonTapia) 🎉
• [ ] running-queries-with-graphiql.md
• [ ] sanitize-your-stack.md
• [x] sass.md (@spaceinvadev) 🎉
• [ ] scaling-issues.md
• [ ] schema-connections.md
• [ ] schema-customization.md (@devrchancay) 🏃
• [ ] schema-generation.md
• [ ] schema-gql-type.md
• [ ] schema-input-gql.md
• [ ] schema-sift.md
• [ ] security-in-gatsby.md // stub
• [ ] seo.md (@enBonnet) 🏃
• [ ] setting-up-gatsby-without-gatsby-new.md
• [ ] sharing-components-across-websites.md
• [ ] sourcing-content-from-json-or-yaml.md
• [ ] sourcing-from-agilitycms.md
• [ ] sourcing-from-buttercms.md
• [ ] sourcing-from-contentful.md (@zeecnla) 🏃
• [ ] sourcing-from-contentstack.md
• [ ] sourcing-from-databases.md
• [ ] sourcing-from-drupal.md
• [ ] sourcing-from-ghost.md
• [ ] sourcing-from-graphcms.md
• [ ] sourcing-from-hosted-services.md
• [ ] sourcing-from-kentico-cloud.md
• [ ] sourcing-from-netlify-cms.md
• [ ] sourcing-from-prismic.md (@JuanJavier1979) 🏃
• [ ] sourcing-from-private-apis.md
• [ ] sourcing-from-prose.md // stub
• [x] sourcing-from-sanity.md (@JuanJavier1979) 🎉
• [x] sourcing-from-the-filesystem.md (@JuanJavier1979) 🎉
• [x] sourcing-from-wordpress.md (@JuanJavier1979) 🎉
• [ ] starters.md
• [ ] static-folder.md
• [ ] static-query.md
• [ ] static-vs-normal-queries.md
• [x] styled-components.md (@zombispormedio) 🎉
• [x] styling.md (@horaleon1) 🎉
• [x] tailwind-css.md (@spaceinvadev) 🎉
• [ ] telemetry.md
• [ ] testing-components-with-graphql.md
• [ ] testing-css-in-js.md
• [x] testing-react-components.md (@jotagarciaz) 🎉
• [x] testing.md (@jotagarciaz) 🎉
• [ ] theme-api.md (@jclopezdev) 🏃
• [x] theme-ui.md (@zombispormedio) 🎉
• [x] themes.md
• [ ] thinking-in-gatsby.md // stub
• [ ] third-party-graphql.md
• [ ] typography-js.md (@spaceinvadev) 🏃
• [ ] unit-testing.md (@agarcia-caicedo) 🏃
• [ ] upgrade-gatsby-and-dependencies.md (@urielhdz) 👀
• [x] upgrading-node-js.md (@gusma) 🎉
• [ ] use-static-query.md (@alotama) 🏃
• [ ] using-a-plugin-in-your-site.md
• [ ] using-client-side-only-packages.md
• [x] using-fragments.md (@jclopezdev) 🎉
• [ ] using-gatsby-image.md
• [ ] using-gatsby-professionally.md
• [ ] using-gatsby-without-graphql.md
• [ ] using-graphql-playground.md
• [x] v1-release-notes.md (@YeisonTapia ) 🎉
• [x] v2-release-notes.md (@YeisonTapia ) 🎉
• [ ] visual-testing-with-storybook.md
• [ ] webpack-and-ssr.md
• [x] what-is-a-plugin.md (@dantehemerson) 🎉
• [x] what-you-dont-need-plugins-for.md (@KiranAkadas ) 🎉
• [ ] why-gatsby-uses-graphql.md
• [x] winning-over-clients.md (@dantehemerson) 🎉
• [ ] winning-over-developers.md
• [ ] winning-over-engineering-leaders.md
• [ ] winning-over-executives.md
• [ ] winning-over-marketers.md
• [ ] winning-over-stakeholders.md
• [x] working-with-gifs.md
• [ ] working-with-images-in-markdown.md (@jotagarciaz )🏃
• [x] working-with-images.md (@jotagarciaz ) 🎉
• [ ] working-with-video.md
• [x] write-pages.md (@jotagarciaz) 🎉

[xmartinezpujol]

We are opening the next section of documents, Docs!

Feel free to ask for files to translate. Thanks! 💪

And as always, before you start translating:

• MAKE SURE WE ASSIGN THE DOC TO YOU
• we do add a reaction to your comment when that's official (🚀 👍 or something positive)
• CREATE ONE SINGLE PR PER FILE: this helps us to keep each file isolated and selfcontained.

If you have doubts on how to contribute to open-source projects check this awesome guide by Kent C. Dodds:

How to Contribute to an Open Source Project on GitHub

[jorgeepc]

Hi! May I take add-seo-component.md? @horacioh @Darking360

[anblave]

Can I take "adding-forms.md"?

[xmartinezpujol]

@jorgeepc @anblave go for it! 🔥

[AlejandroRV]

Hi! Can I take html-generation.md?

[zombispormedio]

Can I take styled-components?

[jotagarciaz]

May I take adding-markdown-pages.md ?

[jatempa]

May I take building-a-portfolio.md?

[JuanJavier1979]

Can I take sourcing-from-wordpress.md? @horacioh @xmartinezpujol

[Darking360]

Ok, people, @AlejandroRV @zombispormedio @jotagarciaz @jatempa @JuanJavier1979 you got them! I'm assigning them but feel free to start with them 🚀 Thank you ❤️

[SerotoninaAbad]

May I take adding-a-list-of-markdown-blog-posts.md? @Darking360 @horacioh

[JuanJavier1979]

I am done with sourcing-from-wordpress.md Can I take now this one sourcing-from-the-filesystem.md?

[anblave]

Can I take "adding-page-transitions-with-plugin-transition-link.md"?

[alvaromontoro]

May I take adding-page-transitions.md?

Completed and created PR #132

[kararade]

Can I take the page adding-pagination.md? 😉 @horacioh @Darking360

[jorgeepc]

Translation of docs/docs/add-seo-component.md completed. #122 May I take adding-tags-and-categories-to-blog-posts.md?

[jose4125]

Can I take adding-website-functionality.md?

[xmartinezpujol]

@SerotoninaAbad @JuanJavier1979 @anblave @alvaromontoro @kararade @jorgeepc @jose4125 you got them! 👏

[JuanJavier1979]

As I am done with sourcing-from-the-filesystem.md Can I take now sourcing-from-sanity.md?

[kararade]

hey @horacioh @Darking360 I've finished with the adding-pagination.md page in the PR https://github.com/gatsbyjs/gatsby-es/pull/124 I would like to start with the answering-it-security.md page if is possible 👍

[SerotoninaAbad]

Hey @horacioh @Darking360. adding-a-list-of-markdown-blog-posts.md it's ready for review in PR #126. May I take adding-search-with-algolia?

[devrchancay]

I will take schema-customization.md @horacioh @Darking360

[anblave]

Can I take "adding-search-with-js-search.md"?

[xmartinezpujol]

@JuanJavier1979 @kararade @SerotoninaAbad @devrchancay @anblave ready to rock and roll! 🔥 🎸🤘

[luucamay]

Hi I would like to work on "building-a-blog.md" can I take it? .... Sorry for taking that one, it seems that the file is a not finished yet in english, beacuse this file is described as "This is a stub. Help our community expand it." @xmartinezpujol can I leave the file building-a-blog.md and better work in other file awesome-gatsby.md?

[jotagarciaz]

I have already pulled adding-markdown-pages.md may I take write-pages.md meanwhile the other one is checked, edited, and passed?

Also I have a question regarding my pull request how is frontmatter translated into spanish?

[anblave]

Can I take "api-proxy.md"?

[kararade]

hey @horacioh @Darking360 @xmartinezpujol I've finished with the answering-it-security.md page in the PR https://github.com/gatsbyjs/gatsby-es/pull/130 Can I start with browser-support.md? 😁 thanks!

[jclopezdev]

@horacioh @Darking360 @xmartinezpujol Could I take quick-start.md? I've finished with the using-fragments.md page in the PR #123

[jorgeepc]

Translation of adding-tags-and-categories-to-blog-posts.md completed #131 May I take audit-with-lighthouse.md?

[dantehemerson]

Can I take " best-practices-for-orgs.md"?

[alvaromontoro]

After completing docs/adding-page-transitions with the PR #132 (it was a super-short one :/), may I take api-specification.md?

EDIT: Completed api-specification.md as part of PR #153

[JuanJavier1979]

As I am done with sourcing-from-sanity.md on PR https://github.com/gatsbyjs/gatsby-es/pull/133 Can I take now headless-cms.md?

[xmartinezpujol]

@luucamay @jotagarciaz @anblave @kararade @jclopezdev @jorgeepc @dantehemerson @alvaromontoro @JuanJavier1979 all ready! 🚀

@jotagarciaz, leave frontmatter in cursive (frontmatter) if it's not a clear translation. Front matter in books, articles and so on is normally the part that comes before the actual content (contenido preliminar), showing data like title, authors, edition, etc.

[JuanJavier1979]

I am done with headless-cms.md on https://github.com/gatsbyjs/gatsby-es/pull/134 It was a pretty short/quick one.

Can I take this one now building-with-components.md? It's a longer one :-)

[SerotoninaAbad]

Hey @horacioh @Darking360! adding-search-with-algolia it's ready for review in PR #135

[jotagarciaz]

I am done with adding-markdown-pages.md #128 . Starting with write-pages.md

[SerotoninaAbad]

May I take building-a-contact-form.md?

[kinduff]

Can I take gatsby-on-linux.md?

[algoritmau]

Hi. I would like to contribute by translating css-modules.md.

[xmartinezpujol]

@JuanJavier1979 @SerotoninaAbad @kinduff @spaceinvadev everything ready! 🔥

Thanks everyone, you are awesome! 💯

[kinduff]

@xmartinezpujol Done!

Can I take api-reference.md (very small one) and asset-prefix.md?

[pastenes]

First time contributing, ever, so I'll start small. Can I take cheat-sheet.md?

[jotagarciaz]

I´m finished with #143 @nucliweb @xmartinezpujol

[jotagarciaz]

May I take testing.md and testing-react-components ? they are so short, so they are perfect to be done during my weekend 😄

[kararade]

hey @horacioh @Darking360 @xmartinezpujol I've finished with the browser-support.md page in the PR https://github.com/gatsbyjs/gatsby-es/pull/144 Can I start with the creating-a-local-plugin.md, creating-global-styles.md and creating-plugins.md pages as they are smalls ones? 😁 I can have them done by this night 👍 thanks!

[jorgeepc]

Translation of docs/docs/audit-with-lighthouse.md completed #145

[xmartinezpujol]

Next assignations done, thank you! 👏 You rock! 🔥

[algoritmau]

Translation of docs/docs/css-modules.md completed #150. Can I work on sass.md, post-css.md, and building a blog.md?

[jclopezdev]

@horacioh @Darking360 @xmartinezpujol Could I take theme-api.md?