Migrate Jest website to Docusaurus v2

[slorber]

Summary

Migrate Jest to Docusaurus v2, including i18n support

More infos about this migration here:
jest-website-migration#2

Urls and Redirects

Older URLs should work fine for the default en and alternate ja locales:

https://jestjs.netlify.app/en/
https://jestjs.netlify.app/ja/
https://jestjs.netlify.app/en/help
https://jestjs.netlify.app/ja/help
https://jestjs.netlify.app/docs/en/getting-started
https://jestjs.netlify.app/docs/ja/getting-started
https://jestjs.netlify.app/docs/en/api
https://jestjs.netlify.app/docs/ja/api
https://jestjs.netlify.app/blog
https://jestjs.netlify.app/blog/2020/05/05/jest-26

Note: .html extension is redirected to non-html extension too

i18n

The i18n translations should be done on a new Crowdin project: https://crowdin.com/project/jest-v2

Older Crowdin project can be archived/ignored: https://crowdin.com/project/jest

Note: unlike v1, the blog posts can now be translated

PWA

Installed PWA support for those who want a Jest app:

Test plan

Deploy preview: https://jestjs.netlify.app/

The preview is triggered from the fork as I need to access a sensitive Crowdin environment variable to deploy the translated sites, and as an external Jest contributor that env variable would be stripped by CI.

[slorber]

@RDIL @SimenB we don't force anyone to create versioned docs, if you feel versioning only major versions is simpler to manage, then just do that 👍

See for example react-navigation: https://reactnavigation.org/

Is Jest 26.6 significantly different from Jest 26.5 and it needs a docs version? I can't answer that question for you :)

[SimenB]

Is Jest 26.6 significantly different from Jest 26.5 and it needs a docs version? I can't answer that question for you :)

There are APIs in .6 that doesn't exist in .5. With docusaurus v1, that means a single file (https://github.com/facebook/jest/tree/ca479ff2ac03bb9a47d5000bfe8c3b747d850c30/website/versioned_docs/version-26.6) as the only diff is a new config option. The "need a doc version" is not really a problem as it's a single file and an update to a json file (both of which is done automatically via docusaurus-version 26.6 or whatever), so it's essentially free from a source code perspective.

Docusaurus v2 approach makes that less feasible though as we need to check in every file. I guess we can start adding "Added in 26.6" here and there in the docs rather then rolling new doc versions. We did that before introducing versioning.

That said, I'd prefer this PR to land with consolidated 26.x versions rather than keeping all the minors we currently have. We consolidate on every new major anyways, and I think it's easier to just consolidate now rather than having a bunch of minors around for a short time that are hard to manage

[RDIL]

That's actually a really good idea for a plugin, single file versioned docs.

[codecov-io]

Codecov Report

Merging #11021 (fd34cd0) into jest-website-v2 (ca479ff) will decrease coverage by 0.01%.
The diff coverage is n/a.

@@                 Coverage Diff                 @@
##           jest-website-v2   #11021      +/-   ##
===================================================
- Coverage            64.23%   64.22%   -0.02%     
===================================================
  Files                  305      305              
  Lines                13255    13254       -1     
  Branches              3235     3234       -1     
===================================================
- Hits                  8515     8512       -3     
- Misses                4049     4050       +1     
- Partials               691      692       +1     

Impacted Files	Coverage Δ
packages/expect/src/utils.ts	94.83% <0.00%> (-1.30%)	⬇️
packages/expect/src/jasmineUtils.ts	92.10% <0.00%> (-0.07%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ca479ff...fd34cd0. Read the comment docs.

[slorber]

As we agreed on, I created the consolidated 26.x version

[SimenB]

website/README.md is failing lint, beyond that I think we're good to go with landing this 👍

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
Please note this issue tracker is not a help forum. We recommend using StackOverflow or our discord channel for questions.