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?