docs: refactor installation instructions

[andrii-bodnar]

Description

This pull request aims to reduce user confusion in the Getting Started section of the website and put all installation and basic setup instructions in one place. This also makes the Getting Started section more framework/toolkit-agnostic.

A quick overview of the changes:

• Added the new Installation and Setup page to the Getting Started section.
• The Setup with React (React Project) page has been removed in favor of Installation and Setup.
• The Setup with Vite (Vite Project) page has been removed in favor of Installation and Setup.
• The installation instructions from other places (JavaScript guide, Macros) have also been moved to the Installation and Setup page (except the instructions for individual packages like CLI, SWC Plugin, etc.).
• Other minor changes.

From the reader's perspective, the React Project and Vite Project were confusing since it's not clear why it was differentiated into React and Vite and it could lead to wrong assumptions or questioning all of this even more.

In general, it should reduce code duplication and make reading easier for the developer.

🖼️ Deployment Preview

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)
• [x] Documentation update
• [ ] Examples update

Checklist

• [x] 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[bot]]

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

Name	Status	Preview	Updated (UTC)
js-lingui	✅ Ready (Inspect)	Visit Preview	Oct 23, 2024 7:40am

[github-actions[bot]]

size-limit report 📦

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

[timofei-iatsenko]

I'm reviewing thru reading docs on the deployment preview, will write down here a notes:

• Lets remove "npm install --save-dev @babel/core" from installation for babel. I don't know why it needed.
• Let's use the swc / babel tabs switch for Vite @vitejs/plugin-react / @vitejs/plugin-react-swc

• Let's not advertise

  .linguirc file in JSON format. lingui section in package.json.

  instead, advertise only js or ts formats, for consistency.

I'm continuing reviewing

[andrii-bodnar]

@timofei-iatsenko thanks for the quick review. Just pushed the updated version.

[andrii-bodnar]

I also think it would be nice to add Rspack and Webpack to the Build Tools section in the new article.

[andrii-bodnar]

@vonovak thanks for the review! I have updated everything according to your suggestions.