Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Docusaurus 2 blog post #11092

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,7 @@ The best way to get your bug fixed is to provide a reduced test case. Please pro

### Docs translation

We get translations from crowdin, see https://crowdin.com/project/jest. Any and all help is very much appreciated!
We get translations from Crowdin, see https://crowdin.com/project/jest-v2. Any and all help is very much appreciated!

### Security Bugs

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ As with every major release, we are making a number of breaking changes to make
## Other Improvements

- **Documentation:** Documentation is critical to share best practices and teach everyone how to write effective tests which will lead to better software. Over the last few weeks we have also expanded Jest's documentation to include a Snapshot Testing FAQ, a guide with information about how to use Jest with common JavaScript libraries as well as we documented the new features mentioned above.
- **Translations:** We are now asking for your help to [translate the Jest documentation](https://crowdin.com/project/jest) to make it easier for people to learn how to use Jest.
- **Translations:** We are now asking for your help to [translate the Jest documentation](https://crowdin.com/project/jest-v2) to make it easier for people to learn how to use Jest.
- **Custom Reporters:** Jest now supports custom test reporters through the `reporters` configuration option. You can finally customize the output of Jest as well as integrate it with other tools by generating reports in formats such as XML. [See documentation](/docs/configuration#reporters-array-modulename-modulename-options).
- **Codebase Health:** It was only possible iterate so quickly in Jest because we spent a significant amount of time on the health of the codebase. We were one of the early adopters of [prettier](https://github.com/prettier/prettier), we notably increased flow coverage, forked Jasmine to improve our test runner library and we rewrote and refactored significant portions of Jest itself to set up Jest for success in the future.
- **Bugfixes:** As always, we made plenty of bugfixes in Jest. The full changelog can be found in the [Jest repository](https://github.com/facebook/jest/blob/master/CHANGELOG.md#jest-2000).
Expand Down
49 changes: 49 additions & 0 deletions website/blog/2021-03-09-jest-website-upgrade.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: 'Jest Website Upgrade'
author: Sébastien Lorber
authorTitle: Docusaurus maintainer
authorURL: https://sebastienlorber.com
authorImageURL: https://github.com/slorber.png
---

We are excited to present the **new Jest website**!

The Jest site was upgraded from **[Docusaurus 1](https://v1.docusaurus.io/)** to **[Docusaurus 2](https://v2.docusaurus.io/)**, and is an early adopter of the [newly released Docusaurus 2 i18n support](https://v2.docusaurus.io/blog/2021/03/09/releasing-docusaurus-i18n).

So, what's new exactly?

<!--truncate-->

## What's new?

Here's a good overview of the most visible improvements:

- **Dark Mode**: change the color scheme through the navbar switch.

- **Modern navigation**: we improved the navigation experience with **client-side routing** and **prefetching**.

- **Versions dropdown**: it is now simpler to switch from one Jest version to another.

- **Progressive-Web-App**: you can install the Jest website and browse it offline.

- **Search**: try the new Algolia **DocSearch v3** user-experience. It is now possible to **search in blog posts**.

- **I18n**: Jest is the first website using the **[new i18n feature of Docusaurus 2](https://v2.docusaurus.io/docs/next/i18n/introduction)**. It is now possible to **translate blog posts**.

- **MDX**: embedding React components in Markdown will allow maintainers to make the **documentation more interactive**.

## For site translators

If you want to help to translate the new Jest website, please use the new Crowdin project [jest-v2](https://crowdin.com/project/jest-v2) instead of the previous one.

:::note

In localized pages, the edit button now links directly to Crowdin.

:::

## Thanks

Thanks to all the contributors that supported or reviewed this migration: [Simen](https://github.com/SimenB), [Orta](https://github.com/orta), [Joel](https://github.com/JoelMarcey), [Kristoffer](https://github.com/merceyz)...

Please report any problem on the [migration issue](https://github.com/facebook/jest/pull/11021).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a merged pull request. Do we have an issue, or should we ask people to open up a new issue?