Gatsby: Content migration - fill out "Gatsby i18n" stub article

Created on 2 Oct 2018  路  15Comments  路  Source: gatsbyjs/gatsby

Issue Context

This issue is part of the content migration project (#8103), which is meant to take existing content and repurpose it so it's easier to find in the docs.

Motivation

We are doing this because many people have written excellent content that we want to canonize and maintain so more people can find it and benefit from it.

Steps to resolve this issue

  1. Read the Style Guide and follow it in order for your PR to be accepted. Pay special attention to the templates.
  2. Style Guide: https://www.gatsbyjs.org/docs/gatsby-style-guide/
  3. Docs Templates: https://www.gatsbyjs.org/docs/templates/
  4. Example of a guide to imitate: https://www.gatsbyjs.org/docs/deploying-to-s3-cloudfront

  5. Create a guide titled "Gatsby i18n" and copy and paste this section of a blog into the doc: https://www.gatsbyjs.org/blog/2017-10-17-building-i18n-with-gatsby/#choosing-a-package

  6. Make sure you describe 3 options for doing i18n:
    gatsby-plugin-i18n: https://github.com/angeloocana/gatsby-plugin-i18n
    react-intl: https://github.com/yahoo/react-intl
    react-i18next: https://github.com/i18next/react-i18next/

  7. Include these references in the "Other Resources" section at the bottom:
    https://www.gatsbyjs.org/blog/2017-10-17-building-i18n-with-gatsby/
    https://www.gatsbyjs.org/blog/2018-04-27-building-eviction-free-nyc-with-gatsbyjs-and-contentful/
    https://www.gatsbyjs.org/packages/gatsby-plugin-i18n/?=i18
    https://www.gatsbyjs.org/blog/tags/i-18-n/

good first issue stale? documentation

Most helpful comment

I'd be happy to work on this. 馃憤

All 15 comments

I'd be happy to work on this. 馃憤

@audoralc great! Once you create the PR, just mention in the first comment that it "closes #8716" :)

Also, I think the title "Gatsby i18n" isn't necessarily the best title. Any ideas for how to improve that are welcome!

@shannonbux How about something like "International content support"?

Also which subheading would be most appropriate? "Adding website functionality"?

Ok, how about "Internationalization" as the title. This is common in other docs, like Drupal (just did a google search). And since i18n will be in the body of the guide, google searches for i18n will still find the doc.

And can you clarify your question about the subheading? Thanks!

Hi @audoralc! Are you still interested in working on this?

@amberleyromo Hi, yes, I'm currently working on it.

Awesome, thanks @audoralc! (And thanks for the username spelling correction, lol!)

Hey @audoralc! How's it going?

@amberleyromo Going well - should have a PR tomorrow.

@audoralc Hi 馃憢 Did you PR your document? 馃槉

@LekoArts I have a draft that is complete, but I'm not sure is detailed enough. Should I go ahead and PR it anyway?

@audoralc Sure, go ahead. We can work with the draft then and help you finish it.

Hi all, sorry this took so long - I've made a PR #10902

Hiya!

This issue has gone quiet. Spooky quiet. 馃懟

We get a lot of issues, so we currently close issues after 30 days of inactivity. It鈥檚 been at least 20 days since the last update here.

If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!

Thanks for being a part of the Gatsby community! 馃挭馃挏

Hey again!

It鈥檚 been 30 days since anything happened on this issue, so our friendly neighborhood robot (that鈥檚 me!) is going to close it.

Please keep in mind that I鈥檓 only a robot, so if I鈥檝e closed this issue in error, I鈥檓 HUMAN_EMOTION_SORRY. Please feel free to reopen this issue or create a new one if you need anything else.

Thanks again for being part of the Gatsby community!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

ghost picture ghost  路  3Comments

dustinhorton picture dustinhorton  路  3Comments

KyleAMathews picture KyleAMathews  路  3Comments

magicly picture magicly  路  3Comments

dustinhorton picture dustinhorton  路  3Comments