https://github.com/reactjs/it.react.dev

(Work in progress) React documentation website in Italian
https://github.com/reactjs/it.react.dev

Last synced: about 1 month ago
JSON representation

(Work in progress) React documentation website in Italian

• Host: GitHub
• URL: https://github.com/reactjs/it.react.dev
• Owner: reactjs
• License: cc-by-4.0
• Created: 2019-02-13T19:32:00.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-09-23T04:29:55.000Z (about 2 months ago)
• Last Synced: 2024-09-27T19:22:17.007Z (about 2 months ago)
• Language: TypeScript
• Homepage: https://it.react.dev
• Size: 148 MB
• Stars: 32
• Watchers: 9
• Forks: 82
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE-DOCS.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# it.reactjs.org 🇮🇹

This repo contains the source code and documentation powering [it.reactjs.org](https://it.reactjs.org/).

## Before we start, some useful links:

- [Glossary](GLOSSARY.md)

- [Style Guide](STYLE_GUIDE.md)

## Getting started

### Prerequisites

1. Git

1. Node: any 12.x version starting with v12.0.0 or greater

1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/)

1. A fork of the repo (for any contributions)

1. A clone of the [it.react.dev repo](https://github.com/reactjs/it.react.dev) on your local machine

### Installation

1. `cd it.react.dev` to go into the project root

3. `yarn` to install the website's npm dependencies

### Running locally

1. `yarn dev` to start the development server (powered by [Next.js](https://nextjs.org/))

1. `open http://localhost:3000` to open the site in your favorite browser

## Contributing

### Guidelines

The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the [contributing guidelines](https://github.com/reactjs/react.dev/blob/main/CONTRIBUTING.md#guidelines-for-text) for the appropriate sections.

### Create a branch

1. `git checkout main` from any folder in your local `react.dev` repository

1. `git pull origin main` to ensure you have the latest main code

1. `git checkout -b the-name-of-my-branch` (replacing `the-name-of-my-branch` with a suitable name) to create a branch

### Make the change

1. Follow the ["Running locally"](#running-locally) instructions

1. Save the files and check in the browser

  1. Changes to React components in `src` will hot-reload

  1. Changes to markdown files in `content` will hot-reload

  1. If working with plugins, you may need to remove the `.cache` directory and restart the server

### Test the change

1. If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.

2. Run `yarn check-all`. (This will run Prettier, ESLint and validate types.)

### Push it

1. `git add -A && git commit -m "My message"` (replacing `My message` with a commit message, such as `Fix header logo on Android`) to stage and commit your changes

1. `git push my-fork-name the-name-of-my-branch`

1. Go to the [it.react.dev repo](https://github.com/reactjs/it.react.dev) and you should see recently pushed branches.

1. Follow GitHub's instructions.

1. If possible, include screenshots of visual changes. A preview build is triggered after your changes are pushed to GitHub.

## Translation

If you are interested in translating `react.dev`, please see the current translation efforts [here](https://github.com/reactjs/react.dev/issues/4135).

## License

Content submitted to [react.dev](https://react.dev/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/reactjs/react.dev/blob/main/LICENSE-DOCS.md) file.