docs: various changes

[andrii-bodnar]

Description

• Remove the Create React App article since it was almost duplicating the React project article.
• Prettify the React project article a bit.
• Hide the TypeScript article from the sidebar (Cannot find type definition file for './node_modules/@lingui/macro/global'. #1869). It probably will be completely removed in the future.
• Move the Vue extractor article to the API Reference section.
• Move the ICU MessageFormat article to the Guides section.
• Added the Babel<>SWC tabs switcher to the installation instructions.
• Sidebar reorder.

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Examples update

Checklist

• I have read the CONTRIBUTING and CODE_OF_CONDUCT docs
• I have added tests that prove my fix is effective or that my feature works
• I have added the necessary documentation (if appropriate)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
js-lingui	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 5, 2024 2:32pm

[github-actions]

size-limit report 📦

Path	Size
./packages/core/dist/index.mjs	2.86 KB (0%)
./packages/detect-locale/dist/index.mjs	723 B (0%)
./packages/react/dist/index.mjs	1.67 KB (0%)
./packages/remote-loader/dist/index.mjs	7.26 KB (0%)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 76.66%. Comparing base (dd43fb0) to head (e14cb2a).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1870   +/-   ##
=======================================
  Coverage   76.66%   76.66%           
=======================================
  Files          81       81           
  Lines        2083     2083           
  Branches      532      532           
=======================================
  Hits         1597     1597           
  Misses        375      375           
  Partials      111      111           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[vonovak]

Many projects, such as those using newer versions of NextJS, do not use babel, and so I think we should have a "fork" all the way at the top that leads to separate installation instructions for SWC and for babel. Maybe using Tabs: https://docusaurus.io/docs/markdown-features/tabs)

I have been trying to set up a nextJS app with the pages router and RSC and I'd love to write docs for that at some point if it works :D. I'm not sure if that's going to be a separate guide (probably yes). Either way, I think we should warn people as soon as possible that installing babel macros doesn't make sense if you're using SWC. And we should probably also say clearly that we don't yet have a clear supported path for RSC.

[andrii-bodnar]

@vonovak thank you for pointing, a separate Next.js article would be the best!

[andrii-bodnar]

I was thinking about RSC support and probably we can document the current PoC with the @lingui/react/server approach until we have a clearer approach.

[andrii-bodnar]

@vonovak added the MDX tabs as you suggested

[timofei-iatsenko]

Would be really nice, to have that article. I also would like to warn people in that article that using global t macro would be harmful in the hybrid applications such as NextJs. And thanks to new useLingui macro-hook now we have a much better alternative. I also think if we don't need a global instance of i18n configured, we could simplify a lot initialization in nextjs to something like that: #1339 (comment)