docs(v2): i18n doc + polish

[slorber]

Motivation

Write the initial i18n doc

Entry point: https://deploy-preview-4014--docusaurus-2.netlify.app/classic/docs/next/i18n/introduction

[github-actions]

Size Change: 0 B

Total Size: 26.8 kB

ℹ️ View Unchanged

Filename	Size	Change
website/build/blog/2017/12/14/introducing-docusaurus/index.html	20.8 kB	0 B
website/build/docs/introduction/index.html	180 B	0 B
website/build/index.html	5.86 kB	0 B

_{compressed-size-action}

[netlify]

✔️ Deploy preview for docusaurus-2 ready!

🔨 Explore the source changes: 92c037c

🔍 Inspect the deploy logs: https://app.netlify.com/sites/docusaurus-2/deploys/6001d2b2505d9600076ac37b

😎 Browse the preview: https://deploy-preview-4014--docusaurus-2.netlify.app

[github-actions]

⚡️ Lighthouse report for the changes in this PR:

Category	Score
🟠 Performance	68
🟢 Accessibility	99
🟢 Best practices	100
🟢 SEO	100
🟢 PWA	95

Lighthouse ran on https://deploy-preview-4014--docusaurus-2.netlify.app/classic/

[clairefro]

Excellent write-up and tutorial, thank you! 🙏

Some suggestions:

1. In Introduction or Tutotrial, it would be very helpful to include an example project filetree structure for a basic FR/EN site à la this. Doc location is crucial in this framework.

2. In Use Crowdin or FAQ, regarding CI it may be helpful to share that Crowdin has integrations with Github and other version management sites. EDIT: Here are the docs on how to setup, https://support.crowdin.com/github-integration/

• To make it so only translated and approved content is PRed on sync, make sure that in Crowdin > Project > Settings > General the Export settings have checked Skip untranslated files and Export only approved translations
  

[clairefro]

P.S. - are there any SEO considerations to be aware of?

[slorber]

Thanks.

Will include a project tree example

For now I just put a simple note about the github integration here: https://deploy-preview-4014--docusaurus-2.netlify.app/classic/docs/next/i18n/crowdin#automate-with-ci

Unfortunately, and after talking with Crowdin support, it does not work if the crowdin.yml is not at the root of the repo (ie website/crowdin.yml does not work, as I use this in the tutorial). Don't really understand why but unfortunately that's the current state 😅 I may need to adapt the tutorial

About SEO, I don't think there's much to be said apart from that I'll add support for hreflang meta headers + an option to disable the headers. Let me know if you think about something else that could be useful.

[netlify]

✔️ [V1] Deploy preview success

🔨 Explore the source changes: 92c037c

🔍 Inspect the deploy logs: https://app.netlify.com/sites/docusaurus-1/deploys/6001d2b256cd06000875b509

😎 Browse the preview: https://deploy-preview-4014--docusaurus-1.netlify.app

[clairefro]

Unfortunately, and after talking with Crowdin support, it does not work if the crowdin.yml is not at the root of the repo

strange! if you'd like a working example, we have github crowdin integration working fine in this repo:
https://github.com/redwoodjs/learn.redwoodjs.com