chore(i18n,docs): update translations (#43306)
This commit is contained in:
camperbot
GitHub
@ -8,7 +8,7 @@ Yes - You can contribute to any of the 30+ languages we have enabled on our tran
|
||||
|
||||
We have the user contributed translations live in Chinese (中文) and Spanish (Español). We intend to localize freeCodeCamp into several major world languages. You can read all about this in our [announcement here](https://www.freecodecamp.org/news/world-language-translation-effort).
|
||||
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](/how-to-translate-files) first.
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](how-to-translate-files.md) first.
|
||||
|
||||
### How can I report a new bug?
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
## General JavaScript
|
||||
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally?id=follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally.md#follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
|
||||
It is encouraged to use functional components over class-based components.
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
A pull request (PR) enables you to send changes from your fork on GitHub to freeCodeCamp.org's main repository. Once you are done making changes to the code, you can follow these guidelines to open a PR.
|
||||
|
||||
> [!NOTE] Your PR should be in English. See [here](https://contribute.freecodecamp.org/#/index?id=translations) for how to contribute translations.
|
||||
> [!NOTE] Your PR should be in English. See [here](index.md#translations) for how to contribute translations.
|
||||
|
||||
## Prepare a good PR title
|
||||
|
||||
@ -68,7 +68,7 @@ Some examples of good PRs titles would be:
|
||||
|
||||
- This is very important when making changes that are not just edits to text content like documentation or a challenge description. Examples of changes that need local testing include JavaScript, CSS, or HTML which could change the functionality or layout of a page.
|
||||
|
||||
- If your PR affects the behaviour of a page it should be accompanied by corresponding [Cypress integration tests](/how-to-add-cypress-tests).
|
||||
- If your PR affects the behaviour of a page it should be accompanied by corresponding [Cypress integration tests](how-to-add-cypress-tests.md).
|
||||
|
||||
## Feedback on pull requests
|
||||
|
||||
@ -78,7 +78,7 @@ Our moderators will now take a look and leave you feedback. Please be patient wi
|
||||
|
||||
And as always, feel free to ask questions on the ['Contributors' category on our forum](https://forum.freecodecamp.org/c/contributors) or [the contributors chat room](https://chat.freecodecamp.org/channel/contributors).
|
||||
|
||||
> [!TIP] If you are to be contributing more pull requests, we recommend you read the [making changes and syncing](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally?id=making-changes-locally) guidelines to avoid having to delete your fork.
|
||||
> [!TIP] If you are to be contributing more pull requests, we recommend you read the [making changes and syncing](how-to-setup-freecodecamp-locally.md#making-changes-locally) guidelines to avoid having to delete your fork.
|
||||
|
||||
## Conflicts on a pull request
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ You should see the list of projects you have been granted access to. Select the
|
||||
|
||||
You should now see the list of available files. Choose your file by selecting the `Proofread` button on the right of that file, then choosing `Proofreading` from the drop-down menu that appears.
|
||||
|
||||
> [!NOTE] 如果你在工作区视图（workspace view）中，但想要[翻译文件](./how-to-translate-files.md)，而不是校对文件，那么你可以从下拉菜单中选择 `Crowdsourcing`。
|
||||
> [!NOTE] If you are in this workspace view, but want to work on [translating a file](how-to-translate-files.md) instead of proofreading, you may select `Crowdsourcing` from the dropdown menu instead.
|
||||
|
||||
## 校对译文
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Start by installing the prerequisite software for your operating system.
|
||||
|
||||
We primarily support development on Linux and Unix-based systems. Our staff and community contributors regularly work with the codebase using tools installed on Ubuntu and macOS.
|
||||
|
||||
We also support Windows 10 via WSL2, which you can prepare by [reading this guide](/how-to-setup-wsl).
|
||||
We also support Windows 10 via WSL2, which you can prepare by [reading this guide](how-to-setup-wsl.md).
|
||||
|
||||
Some community members also develop on Windows 10 natively with Git for Windows (Git Bash), and other tools installed on Windows. We do not have official support for such a setup at this time, we recommend using WSL2 instead.
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
>
|
||||
> **Docker Desktop for Windows**: See respective requirements for [Windows 10 Pro](https://docs.docker.com/docker-for-windows/install/#system-requirements) and [Windows 10 Home](https://docs.docker.com/docker-for-windows/install-windows-home/#system-requirements)
|
||||
|
||||
This guide covers some common steps with the setup of WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
This guide covers some common steps with the setup of WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](how-to-setup-freecodecamp-locally.md) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
|
||||
## Enable WSL
|
||||
|
||||
@ -119,7 +119,7 @@ npm install -g npm@latest
|
||||
|
||||
## Set up freeCodeCamp locally
|
||||
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](how-to-setup-freecodecamp-locally.md) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
|
||||
@ -476,7 +476,7 @@ You are also able to test one challenge individually by performing the following
|
||||
```
|
||||
npm run test -- -g challenge-title-goes-here ```
|
||||
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/docs/how-to-open-a-pull-request.md).
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md).
|
||||
|
||||
> [!TIP] You can set the environment variable `LOCALE` in the `.env` to the language of the challenge(s) you need to test.
|
||||
>
|
||||
|
||||
@ -2,13 +2,13 @@
|
||||
|
||||
The react based client web app that powers our learning platform is built using Gatsby. It is translated into various world languages using [react-i18next](https://react.i18next.com/) and [i18next](https://www.i18next.com/).
|
||||
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](/how-to-setup-freecodecamp-locally). By default the application is available only in English.
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](how-to-setup-freecodecamp-locally.md). By default the application is available only in English.
|
||||
|
||||
Once you have setup the project locally you should be able to follow this documentation to run the client in the language of your choice from the list of available languages.
|
||||
|
||||
This could be helpful when you are working on a feature that specifically targets something that involves localization, and requires you to validate for instance a button's label in a different language.
|
||||
|
||||
> [!TIP] You do not need to follow this document for translating freeCodeCamp's curriculum or contributing documentation. Read [this guide here](./how-to-translate-files.md) instead.
|
||||
> [!TIP] You do not need to follow this document for translating freeCodeCamp's curriculum or contributing documentation. Read [this guide here](how-to-translate-files.md) instead.
|
||||
|
||||
Let's understand how the i18n frameworks and tooling work.
|
||||
|
||||
@ -67,7 +67,7 @@ Some of these files are translated on our translation platform (Crowdin), some a
|
||||
|
||||
- The `intro.json` file contains the key-value pairs for the introduction text on the certification pages.
|
||||
|
||||
If you want to add/update translations for the keys please [read this guide here](/how-to-translate-files.md).
|
||||
If you want to add/update translations for the keys please [read this guide here](how-to-translate-files.md).
|
||||
|
||||
**Files NOT translated on our translations platform:**
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ If you want to create new steps, the following tools simplify that process.
|
||||
|
||||
A one-off script that will automatically add the next step based on the last step numbered as `part-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
@ -27,7 +27,7 @@ npm run create-next-step
|
||||
|
||||
A one-off script that automatically adds a specified number of steps at a specific starting step number. The challenge seed code for all steps created will be empty.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
@ -42,7 +42,7 @@ npm run create-empty-steps start=X num=Y # where X is the starting step number a
|
||||
|
||||
A one-off script that automatically adds a new step between two existing consecutive steps. The challenge seed code will use the existing starting step's challenge seed code with the editable region markers (ERMs) removed.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
|
||||
@ -10,7 +10,7 @@
|
||||
- 帮助我们修复 freeCodeCamp.org 的[学习平台](#learning-platform)中的 bug 。
|
||||
- [帮助我们翻译](#translations) freeCodeCamp.org 的内容为各种语言。
|
||||
|
||||
我们在这里回答了贡献者最常见的一些问题：[有关贡献者的 FAQ](/FAQ.md).
|
||||
We answer the most common questions about contributing [in our contributor FAQ](FAQ.md).
|
||||
|
||||
## 课程
|
||||
|
||||
|
||||
@ -18,7 +18,7 @@ freeCodeCamp is an inclusive community, and we need to keep it that way.
|
||||
|
||||
We have a single code of conduct that governs our entire community. The fewer the rules, the easier they are to remember. You can read those rules and commit them to memory [here](https://code-of-conduct.freecodecamp.org).
|
||||
|
||||
> [!NOTE] As a moderator we would add you to one or more teams on GitHub, our community forum(s) & chat servers. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](/FAQ?id=additional-assistance).
|
||||
> [!NOTE] As a moderator we would add you to one or more teams on GitHub, our community forum(s) & chat servers. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](FAQ.md#additional-assistance).
|
||||
|
||||
## Moderating GitHub
|
||||
|
||||
@ -39,7 +39,7 @@ You can help us organize and triage the issue reports by applying labels from [t
|
||||
|
||||
Please pay special attention to the labels `"help wanted"` and `"first timers only"`. These are to be added to threads that you think can be opened up to potential contributors for making a pull request.
|
||||
|
||||
A `"first timer only"` label should be applied to a trivial issue (ex. a typo fix) and should include additional information. You can use this [reply template](/moderator-handbook?id=first-timer-only-issues) for triage.
|
||||
A `"first timer only"` label should be applied to a trivial issue (ex. a typo fix) and should include additional information. You can use this [reply template](moderator-handbook.md#first-timer-only-issues) for triage.
|
||||
|
||||
#### Closing Stale, Outdated, Inactive Issues and Pull Requests
|
||||
|
||||
@ -49,7 +49,7 @@ A `"first timer only"` label should be applied to a trivial issue (ex. a typo fi
|
||||
|
||||
- If the contributor asks for additional assistance or even time, the above can be relaxed and revisited after a response is given. In any case, the mods should use their best judgment to resolve the outstanding PR's status.
|
||||
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=reply-templates) while triaging issues.
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](moderator-handbook.md#reply-templates) while triaging issues.
|
||||
|
||||
### Moderating Pull Requests
|
||||
|
||||
@ -63,7 +63,7 @@ Pull Requests (PRs) are how contributors submit changes to freeCodeCamp's reposi
|
||||
|
||||
You can also review these right on GitHub and decide whether to merge them. We need to be a bit more careful about these because millions of people will encounter this text as they work through the freeCodeCamp curriculum. Does the pull request make the text more clear without making it much longer? Are the edits relevant and not overly pedantic? Remember that our goal is for challenges to be as clear and as short as possible. They aren't the place for obscure details. Contributors may try to add links to resources to the challenges.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
If the change looks good, please ensure to leave an approval with a "LGTM" comment. Once a pull request gets at least two approvals (including yours) from the moderators or the dev-team, you can go ahead and merge it.
|
||||
|
||||
@ -75,7 +75,7 @@ Pull Requests (PRs) are how contributors submit changes to freeCodeCamp's reposi
|
||||
|
||||
Some contributors may try to add additional tests to cover pedantic corner-cases. We need to be careful to not make the challenge too complicated. These challenges and their tests should be as simple and intuitive as possible. Aside from the algorithm challenges and interview prep section, learners should be able to solve each challenge within about 2 minutes.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
If the change looks good, please ensure to leave an approval with a "LGTM" comment. Once a pull request gets at least two approvals (including yours) from the moderators or the dev-team, you can go ahead and merge it.
|
||||
|
||||
@ -142,7 +142,7 @@ Often, a pull request will be low effort. You can usually tell this immediately
|
||||
|
||||
There are also situations where the contributor is trying to add a link to their website, include a library they created, or have a frivolous edit that doesn't help anyone but themselves.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
#### Other guidelines for Moderators on GitHub
|
||||
|
||||
@ -387,7 +387,7 @@ Once you resolve these issues, we will be able to review your PR and merge it.
|
||||
|
||||
---
|
||||
|
||||
Feel free to reference the [contributing guidelines](https://contribute.freecodecamp.org/#/how-to-work-on-coding-challenges?id=testing-challenges) for instructions on running the CI build locally. ✅
|
||||
Feel free to reference the [contributing guidelines](how-to-work-on-coding-challenges.md#testing-challenges) for instructions on running the CI build locally. ✅
|
||||
```
|
||||
|
||||
### Syncing Fork
|
||||
|
||||
@ -8,7 +8,7 @@ Yes - You can contribute to any of the 30+ languages we have enabled on our tran
|
||||
|
||||
We have the user contributed translations live in Chinese (中文) and Spanish (Español). We intend to localize freeCodeCamp into several major world languages. You can read all about this in our [announcement here](https://www.freecodecamp.org/news/world-language-translation-effort).
|
||||
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](/how-to-translate-files) first.
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](how-to-translate-files.md) first.
|
||||
|
||||
### ¿Cómo puedo reportar un nuevo error?
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
## General JavaScript
|
||||
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally?id=follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally.md#follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
|
||||
It is encouraged to use functional components over class-based components.
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Una pull request (PR) le permite enviar cambios desde su bifurcación en GitHub al repositorio principal de freeCodeCamp.org. Una vez que haya hecho cambios en el código, puede seguir estas pautas para abrir un PR.
|
||||
|
||||
> [!NOTE] Tu PR debe ser en inglés. See [here](https://contribute.freecodecamp.org/#/index?id=translations) for how to contribute translations.
|
||||
> [!NOTE] Tu PR debe ser en inglés. See [here](index.md#translations) for how to contribute translations.
|
||||
|
||||
## Prepara un buen título para tu PR
|
||||
|
||||
@ -68,7 +68,7 @@ Algunos ejemplos de buenos títulos para PRs serían:
|
||||
|
||||
- Esto es muy importante cuando se hagan cambios que no sean solo ediciones del contenido de texto como documentación o una descripción de un desafío. Ejemplos de los cambios que necesitan pruebas en el entorno local incluyen JavaScript, CSS o HTML que podrían cambiar la funcionalidad o el diseño de una página.
|
||||
|
||||
- Si tu PR afecta el comportamiento de una página, debe ir acompañada de la correspondiente [pruebas de integración de Cypress](/how-to-add-cypress-tests).
|
||||
- If your PR affects the behaviour of a page it should be accompanied by corresponding [Cypress integration tests](how-to-add-cypress-tests.md).
|
||||
|
||||
## Comentarios sobre pull requests
|
||||
|
||||
@ -78,7 +78,7 @@ Nuestros moderadores ahora echarán un vistazo y te dejarán tus comentarios. Po
|
||||
|
||||
Y como siempre, siéntete libre de preguntar en la [categoría de 'Contribuidores' de nuestro foro](https://forum.freecodecamp.org/c/contributors) o [en la sala de chat de contribuidores](https://chat.freecodecamp.org/channel/contributors).
|
||||
|
||||
> [!TIP] Si quieres contribuir con más PRs, te recomendamos que leas las directrices ["haciendo cambios y sincronizando"](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally?id=making-changes-locally) para evitar la necesidad de borrar tu bifurcación.
|
||||
> [!TIP] If you are to be contributing more pull requests, we recommend you read the [making changes and syncing](how-to-setup-freecodecamp-locally.md#making-changes-locally) guidelines to avoid having to delete your fork.
|
||||
|
||||
## Conflicto en un pull request
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ You should see the list of projects you have been granted access to. Select the
|
||||
|
||||
You should now see the list of available files. Choose your file by selecting the `Proofread` button on the right of that file, then choosing `Proofreading` from the drop-down menu that appears.
|
||||
|
||||
> [!NOTE] Si estás en la vista "workspace" pero quieres trabajar en [traducir un archivo](./how-to-translate-files.md) en lugar de corregirlo, puedes seleccionar la opción `Crowdsourcing` del menú desplegable.
|
||||
> [!NOTE] If you are in this workspace view, but want to work on [translating a file](how-to-translate-files.md) instead of proofreading, you may select `Crowdsourcing` from the dropdown menu instead.
|
||||
|
||||
## Revisar traducciones
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Comience instalando el software de requisitos previos para su sistema operativo.
|
||||
|
||||
Apoyamos principalmente el desarrollo en sistemas basados en Linux y Unix. Nuestro personal y los colaboradores de la comunidad trabajan regularmente con el código base utilizando herramientas instaladas en Ubuntu y macOS.
|
||||
|
||||
También soportamos Windows 10 a través de WSL2, que puedes preparar [leyendo esta guía](/how-to-setup-wsl).
|
||||
We also support Windows 10 via WSL2, which you can prepare by [reading this guide](how-to-setup-wsl.md).
|
||||
|
||||
Algunos miembros de la comunidad también desarrollan en Windows 10 nativamente con Git for Windows (Git Bash), y otras herramientas instaladas en Windows. No tenemos soporte oficial para dicha configuración en este momento, así que recomendamos usar WSL2 en su lugar.
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
>
|
||||
> **Docker Desktop para Windows**: Vea los requisitos correspondientes para [Windows 10 Pro](https://docs.docker.com/docker-for-windows/install/#system-requirements) y [Windows 10 Home](https://docs.docker.com/docker-for-windows/install-windows-home/#system-requirements)
|
||||
|
||||
Esta guía cubre algunos pasos comunes con la configuración de WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
Esta guía cubre algunos pasos comunes con la configuración de WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](how-to-setup-freecodecamp-locally.md) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
|
||||
## Habilitar WSL
|
||||
|
||||
@ -119,7 +119,7 @@ npm install -g npm@latest
|
||||
|
||||
## Configurar freeCodeCamp localmente
|
||||
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](how-to-setup-freecodecamp-locally.md) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
|
||||
@ -476,7 +476,7 @@ You are also able to test one challenge individually by performing the following
|
||||
```
|
||||
npm run test -- -g challenge-title-goes-here ```
|
||||
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/docs/how-to-open-a-pull-request.md).
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md).
|
||||
|
||||
> [!TIP] You can set the environment variable `LOCALE` in the `.env` to the language of the challenge(s) you need to test.
|
||||
>
|
||||
|
||||
@ -2,13 +2,13 @@
|
||||
|
||||
The react based client web app that powers our learning platform is built using Gatsby. It is translated into various world languages using [react-i18next](https://react.i18next.com/) and [i18next](https://www.i18next.com/).
|
||||
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](/how-to-setup-freecodecamp-locally). By default the application is available only in English.
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](how-to-setup-freecodecamp-locally.md). By default the application is available only in English.
|
||||
|
||||
Once you have setup the project locally you should be able to follow this documentation to run the client in the language of your choice from the list of available languages.
|
||||
|
||||
This could be helpful when you are working on a feature that specifically targets something that involves localization, and requires you to validate for instance a button's label in a different language.
|
||||
|
||||
> [!TIP] You do not need to follow this document for translating freeCodeCamp's curriculum or contributing documentation. Read [this guide here](./how-to-translate-files.md) instead.
|
||||
> [!TIP] You do not need to follow this document for translating freeCodeCamp's curriculum or contributing documentation. Read [this guide here](how-to-translate-files.md) instead.
|
||||
|
||||
Let's understand how the i18n frameworks and tooling work.
|
||||
|
||||
@ -67,7 +67,7 @@ Some of these files are translated on our translation platform (Crowdin), some a
|
||||
|
||||
- The `intro.json` file contains the key-value pairs for the introduction text on the certification pages.
|
||||
|
||||
If you want to add/update translations for the keys please [read this guide here](/how-to-translate-files.md).
|
||||
If you want to add/update translations for the keys please [read this guide here](how-to-translate-files.md).
|
||||
|
||||
**Files NOT translated on our translations platform:**
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ If you want to create new steps, the following tools simplify that process.
|
||||
|
||||
A one-off script that will automatically add the next step based on the last step numbered as `part-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
@ -27,7 +27,7 @@ npm run create-next-step
|
||||
|
||||
A one-off script that automatically adds a specified number of steps at a specific starting step number. The challenge seed code for all steps created will be empty.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
@ -42,7 +42,7 @@ npm run create-empty-steps start=X num=Y # where X is the starting step number a
|
||||
|
||||
A one-off script that automatically adds a new step between two existing consecutive steps. The challenge seed code will use the existing starting step's challenge seed code with the editable region markers (ERMs) removed.
|
||||
|
||||
**Note:** This script also runs [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### How to run script:
|
||||
|
||||
|
||||
@ -10,7 +10,7 @@ Eres bienvenido a:
|
||||
- Ayúdanos a corregir errores en la [plataforma de aprendizaje](#learning-platform) de freeCodeCamp.org.
|
||||
- [Ayúdanos a traducir](#translations) freeCodeCamp.org a idiomas del mundo.
|
||||
|
||||
Respondemos a las preguntas más comunes sobre cómo contribuir [en nuestras preguntas frecuentes del contribuidor](/FAQ.md).
|
||||
We answer the most common questions about contributing [in our contributor FAQ](FAQ.md).
|
||||
|
||||
## Plan de estudios
|
||||
|
||||
|
||||
@ -18,7 +18,7 @@ freeCodeCamp is an inclusive community, and we need to keep it that way.
|
||||
|
||||
We have a single code of conduct that governs our entire community. The fewer the rules, the easier they are to remember. You can read those rules and commit them to memory [here](https://code-of-conduct.freecodecamp.org).
|
||||
|
||||
> [!NOTE] As a moderator we would add you to one or more teams on GitHub, our community forum(s) & chat servers. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](/FAQ?id=additional-assistance).
|
||||
> [!NOTE] As a moderator we would add you to one or more teams on GitHub, our community forum(s) & chat servers. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](FAQ.md#additional-assistance).
|
||||
|
||||
## Moderando GitHub
|
||||
|
||||
@ -39,7 +39,7 @@ You can help us organize and triage the issue reports by applying labels from [t
|
||||
|
||||
Please pay special attention to the labels `"help wanted"` and `"first timers only"`. These are to be added to threads that you think can be opened up to potential contributors for making a pull request.
|
||||
|
||||
A `"first timer only"` label should be applied to a trivial issue (ex. a typo fix) and should include additional information. You can use this [reply template](/moderator-handbook?id=first-timer-only-issues) for triage.
|
||||
A `"first timer only"` label should be applied to a trivial issue (ex. a typo fix) and should include additional information. You can use this [reply template](moderator-handbook.md#first-timer-only-issues) for triage.
|
||||
|
||||
#### Closing Stale, Outdated, Inactive Issues and Pull Requests
|
||||
|
||||
@ -49,7 +49,7 @@ A `"first timer only"` label should be applied to a trivial issue (ex. a typo fi
|
||||
|
||||
- If the contributor asks for additional assistance or even time, the above can be relaxed and revisited after a response is given. In any case, the mods should use their best judgment to resolve the outstanding PR's status.
|
||||
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=reply-templates) while triaging issues.
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](moderator-handbook.md#reply-templates) while triaging issues.
|
||||
|
||||
### Moderating Pull Requests
|
||||
|
||||
@ -63,7 +63,7 @@ Pull Requests (PRs) are how contributors submit changes to freeCodeCamp's reposi
|
||||
|
||||
You can also review these right on GitHub and decide whether to merge them. We need to be a bit more careful about these because millions of people will encounter this text as they work through the freeCodeCamp curriculum. Does the pull request make the text more clear without making it much longer? Are the edits relevant and not overly pedantic? Remember that our goal is for challenges to be as clear and as short as possible. They aren't the place for obscure details. Contributors may try to add links to resources to the challenges.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
If the change looks good, please ensure to leave an approval with a "LGTM" comment. Once a pull request gets at least two approvals (including yours) from the moderators or the dev-team, you can go ahead and merge it.
|
||||
|
||||
@ -75,7 +75,7 @@ Pull Requests (PRs) are how contributors submit changes to freeCodeCamp's reposi
|
||||
|
||||
Some contributors may try to add additional tests to cover pedantic corner-cases. We need to be careful to not make the challenge too complicated. These challenges and their tests should be as simple and intuitive as possible. Aside from the algorithm challenges and interview prep section, learners should be able to solve each challenge within about 2 minutes.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
If the change looks good, please ensure to leave an approval with a "LGTM" comment. Once a pull request gets at least two approvals (including yours) from the moderators or the dev-team, you can go ahead and merge it.
|
||||
|
||||
@ -142,7 +142,7 @@ Often, a pull request will be low effort. You can usually tell this immediately
|
||||
|
||||
There are also situations where the contributor is trying to add a link to their website, include a library they created, or have a frivolous edit that doesn't help anyone but themselves.
|
||||
|
||||
You can close invalid pull requests and reply to them with these [reply templates](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
#### Otras pautas para moderadores en GitHub
|
||||
|
||||
@ -387,7 +387,7 @@ Once you resolve these issues, we will be able to review your PR and merge it.
|
||||
|
||||
---
|
||||
|
||||
Feel free to reference the [contributing guidelines](https://contribute.freecodecamp.org/#/how-to-work-on-coding-challenges?id=testing-challenges) for instructions on running the CI build locally. ✅
|
||||
Feel free to reference the [contributing guidelines](how-to-work-on-coding-challenges.md#testing-challenges) for instructions on running the CI build locally. ✅
|
||||
```
|
||||
|
||||
### Syncing Fork
|
||||
|
||||
@ -8,7 +8,7 @@ Sì, puoi contribuire a ognuna delle oltre 30 lingue abilitate sulla nostra piat
|
||||
|
||||
Abbiamo già live le traduzioni fatte dagli utenti per cinese (中文), spagnolo (Español) e italiano. Abbiamo intenzione di localizzare freeCodeCamp nelle lingue più usate nel mondo. Puoi leggere tutto su questo argomento nel nostro [annuncio](https://www.freecodecamp.org/news/world-language-translation-effort).
|
||||
|
||||
Se sei interessato a contribuire alla traduzione per favore assicurati di <a href="/i18n/italian/how-to-translate-files>leggere questa guida</a> come prima cosa.
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](how-to-translate-files.md) first.
|
||||
|
||||
### Come posso segnalare un nuovo bug?
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
## JavaScript generale
|
||||
|
||||
Nella maggior parte dei casi, il nostro [linter](how-to-setup-freecodecamp-locally?id=segui-questi-passaggi-per-preparare-il-tuo-ambiente-di-sviluppo) darà un avvertimento nel caso di un format che va contro le preferenze del nostro codebase.
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally.md#follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
|
||||
Si incoraggia l'utilizzo di componenti funzionali invece di componenti basati su classi.
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Una pull request (PR) consente di inviare modifiche dal tuo fork su GitHub al repository principale di freeCodeCamp.org. Una volta che hai fatto delle modifiche al codice, puoi seguire queste linee guida per aprire una PR.
|
||||
|
||||
> [!NOTE] La tua PR dovrebbe essere in inglese. Vedi [qui](https://contribute.freecodecamp.org/#/index?id=translations) per come contribuire alla traduzione.
|
||||
> [!NOTE] La tua PR dovrebbe essere in inglese. See [here](index.md#translations) for how to contribute translations.
|
||||
|
||||
## Preparare un buon titolo PR
|
||||
|
||||
@ -68,7 +68,7 @@ Alcuni esempi di buoni titoli PR sarebbero:
|
||||
|
||||
- Questo è molto importante quando si fanno cambiamenti che non sono solo modifiche a contenuto testuale come documentazione o descrizioni di sfide. Esempi di modifiche che hanno bisogno di essere testate localmente includono JavaScript, CSS o HTML che potrebbero cambiare funzionalità o layout di una pagina.
|
||||
|
||||
- Se la tua PR ha effetto sul comportamento di una pagina dovrebbe essere accompagnato da corrispondenti [test di integrazione di Cypress](how-to-add-cypress-tests.md).
|
||||
- If your PR affects the behaviour of a page it should be accompanied by corresponding [Cypress integration tests](how-to-add-cypress-tests.md).
|
||||
|
||||
## Feedback sulle pull request
|
||||
|
||||
@ -78,7 +78,7 @@ I nostri moderatori ora daranno un'occhiata e ti lasceranno un feedback. Ti preg
|
||||
|
||||
E come sempre, poni liberamente le tue domande nella [categoria 'Contributors' del nostro forum](https://forum.freecodecamp.org/c/contributors) o [nella chat room per i contributori](https://chat.freecodecamp.org/channel/contributors).
|
||||
|
||||
> [!TIP] Se vuoi contribuire a più di una PR, ti raccomandiamo di leggere la [guida su fare modifiche e sincronizzare](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally?id=making-changes-locally) per evitare di dover cancellare il tuo fork.
|
||||
> [!TIP] If you are to be contributing more pull requests, we recommend you read the [making changes and syncing](how-to-setup-freecodecamp-locally.md#making-changes-locally) guidelines to avoid having to delete your fork.
|
||||
|
||||
## Conflitti su una pull request
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Dovresti vedere la lista di progetti a cui ti è stato dato accesso. Seleziona i
|
||||
|
||||
Ora dovresti vedere la lista dei file disponibili. Scegli il file selezionando il pulsante `Proofread` a destra del file, e scegliendo quindi `Proofreading` dal menu che compare.
|
||||
|
||||
> [!NOTE] Se sei in workspace view, ma vuoi larorare sulla [traduzione di un file](./how-to-translate-files.md) invece di revisionare, puoi selezionare `Crowdsourcing` dal menu.
|
||||
> [!NOTE] If you are in this workspace view, but want to work on [translating a file](how-to-translate-files.md) instead of proofreading, you may select `Crowdsourcing` from the dropdown menu instead.
|
||||
|
||||
## Revisionare le traduzioni
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Inizia installando i prerequisiti software per il tuo sistema operativo.
|
||||
|
||||
Sosteniamo principalmente lo sviluppo su sistemi Linux e basati su Unix. Il nostro staff e i collaboratori della community lavorano regolarmente con il codebase utilizzando strumenti installati su Ubuntu e macOS.
|
||||
|
||||
Supportiamo anche Windows 10 via WSL2, che puoi preparare [leggendo questa guida](/how-to-setup-wsl).
|
||||
We also support Windows 10 via WSL2, which you can prepare by [reading this guide](how-to-setup-wsl.md).
|
||||
|
||||
Alcuni membri della comunità sviluppano anche su Windows 10 nativamente con Git per Windows (Git Bash) e altri strumenti installati su Windows. Al momento non disponiamo di un supporto ufficiale per una tale configurazione, consigliamo invece di utilizzare WSL2.
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
>
|
||||
> **Docker Desktop per Windows**: Vedi i rispettivi requisiti per [Windows 10 Pro](https://docs.docker.com/docker-for-windows/install/#system-requirements) e [Windows 10 Home](https://docs.docker.com/docker-for-windows/install-windows-home/#system-requirements)
|
||||
|
||||
Questa guida copre alcuni passi comuni con la configurazione di WSL2. Una volta che i problemi più comuni con WSL2 sono stati considerati, dovresti essere in grado di seguire [questa guida per settare freeCodeCamp in locale](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) per lavorare su Windows usando una distribuzione WSL come Ubuntu.
|
||||
Questa guida copre alcuni passi comuni con la configurazione di WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](how-to-setup-freecodecamp-locally.md) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
|
||||
## Abilita WSL
|
||||
|
||||
@ -119,7 +119,7 @@ npm install -g npm@latest
|
||||
|
||||
## Imposta freeCodeCamp localmente
|
||||
|
||||
Ora che hai installato i pre-requisiti, segui [la nostra guida per settare freeCodeCamp localmente](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) per clonare, installare e settare freeCodeCamp sul tuo computer.
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](how-to-setup-freecodecamp-locally.md) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
|
||||
@ -476,7 +476,7 @@ Puoi anche testare una sfida singola con i seguenti step:
|
||||
```
|
||||
npm run test -- -g challenge-title-goes-here ```
|
||||
|
||||
Una volta che avrai verificato che ogni sfida su cui hai lavorato passi i test, [per favore crea una pull request](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/docs/how-to-open-a-pull-request.md).
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md).
|
||||
|
||||
> [!TIP] Puoi impostare la variabile d'ambiente `LOCALE` nel file `.env` alla lingua usata nelle sfide che devi testare.
|
||||
>
|
||||
|
||||
@ -2,13 +2,13 @@
|
||||
|
||||
La app client basata su react che alimenta la nostra piattaforma è costruita usando Gatsby. È tradotta in varie lingue internazionali usando [react-i18next](https://react.i18next.com/) e [i18next](https://www.i18next.com/).
|
||||
|
||||
Puoi scoprire di più su come configurare l'applicazione client localmente per lo sviluppo seguendo [la nostra guida alla configurazione in locale](/how-to-setup-freecodecamp-locally). Di default, l'applicazione è disponibile solo in inglese.
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](how-to-setup-freecodecamp-locally.md). Di default, l'applicazione è disponibile solo in inglese.
|
||||
|
||||
Una volta che avrai configurato il progetto localmente dovresti essere in grado di seguire questa documentazione per eseguire il client nella lingua di tua scelta dall'elenco delle lingue disponibili.
|
||||
|
||||
Questo può essere utile quando stai lavorando su una caratteristica che riguarda specificatamente qualcosa che coinvolge la localizzazione e ti richiede ad esempio l'etichetta di un bottone in una lingua diversa.
|
||||
|
||||
> [!TIP] Non hai bisogno di seguire questo documento per tradurre il curriculum di freeCodeCamp o per contribuire alla documentazione. Invece, leggi [questa guida](./how-to-translate-files.md).
|
||||
> [!TIP] Non hai bisogno di seguire questo documento per tradurre il curriculum di freeCodeCamp o per contribuire alla documentazione. Read [this guide here](how-to-translate-files.md) instead.
|
||||
|
||||
Andiamo a vedere come funzionano il framework e gli strumenti.
|
||||
|
||||
@ -67,7 +67,7 @@ Alcuni di questi file sono tradotti sulla nostra piattaforma di traduzione (Crow
|
||||
|
||||
- Il file `intro.json` contiene le coppie chiave-valore relative al testo introduttivo sulle pagine delle certificazioni.
|
||||
|
||||
Se vuoi aggiungere/aggiornare le traduzioni per le chiavi, per favore [leggi questa guida](/how-to-translate-files.md).
|
||||
If you want to add/update translations for the keys please [read this guide here](how-to-translate-files.md).
|
||||
|
||||
**File NON tradotti con la nostra piattaforma di traduzione:**
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ Se vuoi creare nuovi passi, i seguenti strumenti semplificano quel processo.
|
||||
|
||||
Uno script eseguito una sola volta che aggiungerà automaticamente il prossimo passo basandosi sull'ultimo numerato come `part-xxx.md`, dove `xxx` rappresenta il numero a 3 cifre dell'ultimo passo. Il codice seed della sfida userà il codice seed di quella precedente, rimuovendo i marcatori delle regioni editabili (MRE).
|
||||
|
||||
**Nota:** Questo script esegue anche [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Come eseguire lo script:
|
||||
|
||||
@ -27,7 +27,7 @@ npm run create-next-step
|
||||
|
||||
Uno script eseguito una sola volta che aggiunge automaticamente un determinato numero di passi a partire da un passo specifico. Il codice seed della sfida per tutti i passi creati sarà vuoto.
|
||||
|
||||
**Nota:** Questo script esegue anche [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Come eseguire lo script:
|
||||
|
||||
@ -42,7 +42,7 @@ npm run create-empty-steps start=X num=Y # dove X è il numero del passo da cui
|
||||
|
||||
Uno script eseguito una sola volta che aggiunge automaticamente un passo in mezzo a due passi consecutivi già esistenti. Il codice seed della sfida userà il codice seed della sfida al passo di partenza già esistente, rimuovendo i marcatori delle regioni editabili (MRE).
|
||||
|
||||
**Nota:** Questo script esegue anche [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Come eseguire lo script:
|
||||
|
||||
|
||||
@ -10,7 +10,7 @@ Sei invitato a:
|
||||
- Aiutarci a correggere i bug nella [piattaforma di apprendimento](#piattaforma-di-apprendimento) di freeCodeCamp.org.
|
||||
- [Aiutarci a tradurre](#traduzioni) freeCodeCamp.org in tutte le lingue del mondo.
|
||||
|
||||
Rispondiamo alle domande più comuni su come contribuire [nelle nostre FAQ per i contributori](/FAQ.md).
|
||||
We answer the most common questions about contributing [in our contributor FAQ](FAQ.md).
|
||||
|
||||
## Curriculum
|
||||
|
||||
|
||||
@ -18,7 +18,7 @@ freeCodeCamp è una comunità inclusiva ed è necessario lasciarla così.
|
||||
|
||||
Abbiamo un unico codice di comportamento che governa la nostra intera comunità. Meno sono le regole, più facile sarà ricordarle. Puoi leggere queste regole e impegnarti a ricordarle [qui](https://code-of-conduct.freecodecamp.org).
|
||||
|
||||
> [!NOTE] Come moderatore, ti aggiungeremo a uno o più team su GitHub, ai forum della community & ai server delle chat. Se ti manca l'accesso a una piattaforma che vorresti moderare, per favore [contatta un membro dello staff](/FAQ?id=additional-assistance).
|
||||
> [!NOTE] Come moderatore, ti aggiungeremo a uno o più team su GitHub, ai forum della community & ai server delle chat. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](FAQ.md#additional-assistance).
|
||||
|
||||
## Moderare GitHub
|
||||
|
||||
@ -39,7 +39,7 @@ Puoi aiutarci ad organizzare e fare lo smistamento delle issue riportate applica
|
||||
|
||||
Per favore, fai particolare attenzione alle etichette `"help wanted"` e `"first timers only"`. Queste devono essere aggiunte ai thread che pensi possano essere aperti a potenziali contributori per creare una pull request.
|
||||
|
||||
Un'etichetta `"first timer only"` dovrebbe essere applicata per problemi banali (es. un refuso) e dovrebbe includere informazioni addizionali. Puoi usare questo [modello di risposta](/moderator-handbook?id=first-timer-only-issues) per lo smistamento.
|
||||
Un'etichetta `"first timer only"` dovrebbe essere applicata per problemi banali (es. un refuso) e dovrebbe includere informazioni addizionali. You can use this [reply template](moderator-handbook.md#first-timer-only-issues) for triage.
|
||||
|
||||
#### Chiudere issues e pull request stantii, obsoleti e inattivi
|
||||
|
||||
@ -49,7 +49,7 @@ Un'etichetta `"first timer only"` dovrebbe essere applicata per problemi banali
|
||||
|
||||
- Se il contributore chiede ulteriore assistenza o anche del tempo, quanto sopra può essere rilassato e rivisitato dopo che è stata data una risposta. In ogni caso, i moderatori dovrebbero usare il loro buon senso per prendere una decisione sullo status in sospeso della PR.
|
||||
|
||||
> [!TIP] Ti consigliamo di usare questa lista di [modelli di risposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=reply-templates) mentre smisti le issue.
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](moderator-handbook.md#reply-templates) while triaging issues.
|
||||
|
||||
### Moderare le pull request
|
||||
|
||||
@ -63,7 +63,7 @@ Le pull request (PR) sono il modo in cui i contributori sottopongono cambiamenti
|
||||
|
||||
Puoi anche farne la revisione direttamente su GitHub e decidere se fare il merge. Dobbiamo fare un po' attenzione su questo perché milioni di persone incontreranno questo testo lavorando sul curriculum di freeCodeCamp. La pull request rende il testo più chiaro senza allungarlo troppo? Le modifiche sono rilevanti e non troppo pedanti? Ricorda che il nostro obbiettivo è che le sfide siano più chiare e più corte possibile. Non sono il luogo per dettagli incomprensibili. I contributori possono provare ad aggiungere link e risorse alle sfide.
|
||||
|
||||
Puoi chiudere le pull request non valide e rispondervi con questi [modelli di risposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
Se la modifica va bene, assicurati di lasciare un'approvazione con un commento "LGTM". Una volta che una pull request riceve almeno due approvazioni (inclusa la tua) dai moderatori o dal dev-team, puoi procedere e farne il merge.
|
||||
|
||||
@ -75,7 +75,7 @@ Le pull request (PR) sono il modo in cui i contributori sottopongono cambiamenti
|
||||
|
||||
Alcuni contributori potrebbero provare ad aggiungere test addizionali per coprire casi limite pedanti. Dobbiamo fare attenzione a non rendere le sfide troppo complicate. Queste sfide e i loro test dovrebbero essere più semplici e intuitivi possibile. Ad eccezione delle sfide sugli algoritmi e della sezione di preparazione al colloquio di lavoro, gli studenti dovrebbero essere in grado di risolvere ogni sfida entro due minuti.
|
||||
|
||||
Puoi chiudere le pull request non valide e rispondervi con questi [modelli di risposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
Se la modifica va bene, assicurati di lasciare un'approvazione con un commento "LGTM". Una volta che una pull request ha ricevuto almeno due approvazioni (inclusa la tua) dai moderatori o dal dev-team, puoi procedere e farne il merge.
|
||||
|
||||
@ -142,7 +142,7 @@ Spesso una pull request avrà richiesto uno sforzo minimo. Puoi capirlo immediat
|
||||
|
||||
Ci sono anche situazioni in cui il contributore sta cercando di aggiungere un collegamento al proprio sito Web, includere una libreria che ha creato o apportare una modifica frivola che non aiuta nessuno tranne se stesso.
|
||||
|
||||
Puoi chiudere le pull request non valide e rispondere con questi [modelli di risposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
#### Altre linee guida per i Moderatori su GitHub
|
||||
|
||||
@ -388,7 +388,7 @@ Once you resolve these issues, we will be able to review your PR and merge it.
|
||||
|
||||
---
|
||||
|
||||
Feel free to reference the [contributing guidelines](https://contribute.freecodecamp.org/#/how-to-work-on-coding-challenges?id=testing-challenges) for instructions on running the CI build locally. ✅
|
||||
Feel free to reference the [contributing guidelines](how-to-work-on-coding-challenges.md#testing-challenges) for instructions on running the CI build locally. ✅
|
||||
```
|
||||
|
||||
### Sincronizzare le fork
|
||||
|
||||
@ -8,7 +8,7 @@ Sim. Você pode contribuir com qualquer um dos mais de 30 idiomas disponíveis e
|
||||
|
||||
Temos as traduções de chinês (中文) e espanhol (Español) no ar. Pretendemos traduzir o freeCodeCamp para vários idiomas. Você pode ler mais sobre isso em nosso [anúncio aqui](https://www.freecodecamp.org/news/world-language-translation-effort).
|
||||
|
||||
Se você está interessado em contribuir com as traduções, certifique-se de [ler este guia](/how-to-translate-files) primeiro.
|
||||
If you are interested in contributing to translations please makes sure you [read this guide](how-to-translate-files.md) first.
|
||||
|
||||
### Como posso relatar um novo erro?
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
## JavaScript em geral
|
||||
|
||||
Na maioria dos casos, nosso [linter](how-to-setup-freecodecamp-locally?id=follow-these-steps-to-get-your-development-environment-ready) avisará sobre qualquer formatação que contradiga as práticas recomendadas desta base de código.
|
||||
In most cases, our [linter](how-to-setup-freecodecamp-locally.md#follow-these-steps-to-get-your-development-environment-ready) will warn of any formatting which goes against this codebase's preferred practice.
|
||||
|
||||
Recomendamos o uso de componentes funcionais em vez de componentes baseados em classes.
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ Para aprender como escrever testes Cypress ou 'specs', por favor confira a [docu
|
||||
|
||||
## Como executar testes
|
||||
|
||||
> [!NOTE] If using GitPod, please see [Cypress-GitPod Setup](/how-to-add-cypress-tests#cypress-gitpod-setup)
|
||||
> [!NOTE] Se estiver usando o GitPod, consulte a [configuração do Cypress-GitPod](/how-to-add-cypress-tests#cypress-gitpod-setup)
|
||||
|
||||
### 1. Veja se as aplicações de cliente e MongoDB estão executando
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Um pull request (PR) permite que você envie alterações do seu fork do GitHub para o repositório principal do freeCodeCamp.org. Depois de terminar de fazer alterações no código, você pode seguir essas diretrizes para abrir um PR.
|
||||
|
||||
> [!NOTE] Seu PR deve estar em inglês. Veja [aqui](https://contribute.freecodecamp.org/#/index?id=translations) como contribuir com traduções.
|
||||
> [!NOTE] Seu PR deve estar em inglês. See [here](index.md#translations) for how to contribute translations.
|
||||
|
||||
## Prepare um bom título para o PR
|
||||
|
||||
@ -68,7 +68,7 @@ Alguns exemplos de bons títulos de PRs seriam:
|
||||
|
||||
- Isso é muito importante quando se está fazendo mudanças que não são apenas edições no conteúdo do texto como a documentação ou descrição de um desafio. Exemplos de mudanças que precisam ser testadas localmente incluem JavaScript, CSS ou HTML que podem mudar a funcionalidade ou aparência de uma página.
|
||||
|
||||
- Se seu PR afeta o comportamento de uma página ele deve estar acompanhado pelo correspondente [teste de integração Cypress](/how-to-add-cypress-tests).
|
||||
- If your PR affects the behaviour of a page it should be accompanied by corresponding [Cypress integration tests](how-to-add-cypress-tests.md).
|
||||
|
||||
## Comentários nos pull requests
|
||||
|
||||
@ -78,7 +78,7 @@ Nossos moderadores vão dar uma olhada e deixar um comentário para você. Seja
|
||||
|
||||
E como sempre, fique à vontade em perguntar na [categoria 'Contribuidores' do fórum](https://forum.freecodecamp.org/c/contributors) ou [no chat dos contribuidores](https://chat.freecodecamp.org/channel/contributors).
|
||||
|
||||
> [!TIP] Se você vai contribuir com mais pull requests, recomendamos ler as diretrizes sobre [fazer mudanças e sincronizá-las](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally?id=making-changes-locally) para evitar o apagamento de seu fork.
|
||||
> [!TIP] If you are to be contributing more pull requests, we recommend you read the [making changes and syncing](how-to-setup-freecodecamp-locally.md#making-changes-locally) guidelines to avoid having to delete your fork.
|
||||
|
||||
## Conflitos em um pull request
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Você deve ver a lista de projetos aos quais foi concedido acesso. Selecione o p
|
||||
|
||||
Agora você deve ver a lista de arquivos disponíveis. Escolha seu arquivo selecionando o botão `Proofread` à direita do arquivo, depois escolha `Proofreading` no menu que aparece.
|
||||
|
||||
> [!NOTE] Se você estiver nesta visão de espaço de trabalho, mas quiser [traduzir um arquivo](./how-to-translate-files.md) em vez de revisar, você pode selecionar `Crowdsourcing` no menu suspenso.
|
||||
> [!NOTE] If you are in this workspace view, but want to work on [translating a file](how-to-translate-files.md) instead of proofreading, you may select `Crowdsourcing` from the dropdown menu instead.
|
||||
|
||||
## Traduções revisadas
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ Comece instalando o software pré-requisito para seu sistema operacional.
|
||||
|
||||
Apoiamos principalmente o desenvolvimento em sistemas Linux e Unix. Nossa equipe e colaboradores da comunidade trabalham regularmente com a base de código usando ferramentas instaladas no Ubuntu e no macOS.
|
||||
|
||||
Também suportamos o Windows 10 via WSL2, que você pode preparar [lendo este guia](/how-to-setup-wsl).
|
||||
We also support Windows 10 via WSL2, which you can prepare by [reading this guide](how-to-setup-wsl.md).
|
||||
|
||||
Alguns membros da comunidade também desenvolvem no Windows 10 nativamente com Git para Windows (Git Bash), e outras ferramentas instaladas no Windows. Neste momento, não dispomos de apoio oficial para esse tipo de instalações, recomendamos que se utilize WSL2.
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
>
|
||||
> **Docker Desktop para Windows**: Veja os respectivos requisitos para [Windows 10 Pro](https://docs.docker.com/docker-for-windows/install/#system-requirements) e [Windows 10 Home](https://docs.docker.com/docker-for-windows/install-windows-home/#system-requirements)
|
||||
|
||||
Este guia abrange algumas etapas comuns sobre a instalação do WSL2. Uma vez resolvidos alguns dos problemas comuns com o WSL2, você deve seguir o nosso [guia de instalação local](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) para trabalhar com o freeCodeCamp no Windows executando uma distro WSL como o Ubuntu.
|
||||
Este guia abrange algumas etapas comuns sobre a instalação do WSL2. Once some of the common issues with WSL2 are addressed, you should be able to follow [this local setup guide](how-to-setup-freecodecamp-locally.md) to work with freeCodeCamp on Windows running a WSL distro like Ubuntu.
|
||||
|
||||
## Ative o WSL
|
||||
|
||||
@ -119,7 +119,7 @@ npm install -g npm@latest
|
||||
|
||||
## Configure localmente o freeCodeCamp
|
||||
|
||||
Agora que você instalou os pré-requisitos, siga [nosso guia de instalação local](https://contribute.freecodecamp.org/#/how-to-setup-freecodecamp-locally) para clonar, instalar e configurar o freeCodeCamp em sua máquina.
|
||||
Now that you have installed the pre-requisites, follow [our local setup guide](how-to-setup-freecodecamp-locally.md) to clone, install and setup freeCodeCamp locally on your machine.
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
|
||||
@ -479,7 +479,7 @@ Você também é capaz de testar um desafio individualmente seguindo as seguinte
|
||||
```
|
||||
npm run test -- -g challenge-title-goes-here ```
|
||||
|
||||
Quando você verificar que cada desafio modificado passou nos testes, [crie um pull request](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/docs/how-to-open-a-pull-request.md).
|
||||
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md).
|
||||
|
||||
> [!TIP] Você pode definir a variável de ambiente `LOCALE` no `.env` no idioma do(s) desafio(s) que precisa testar.
|
||||
>
|
||||
|
||||
@ -2,13 +2,13 @@
|
||||
|
||||
O nosso cliente web app com base em React que alimenta nossa plataforma de aprendizado foi criado usando o Gatsby. Ele é traduzido em vários idiomas do mundo todo usando [react-i18next](https://react.i18next.com/) e [i18next](https://www.i18next.com/).
|
||||
|
||||
Você pode aprender mais sobre configurar o cliente localmente para desenvolvimento seguindo [nosso guia de configuração aqui](/how-to-setup-freecodecamp-locally). Por padrão, a aplicação está disponível somente em inglês.
|
||||
You can learn more about setting up the client application locally for development by following [our local setup guide here](how-to-setup-freecodecamp-locally.md). Por padrão, a aplicação está disponível somente em inglês.
|
||||
|
||||
Assim que você tiver o projeto configurado localmente, você poderá seguir essa documentação para rodar o cliente no idioma de sua escolha a partir de uma lista de idiomas disponíveis.
|
||||
|
||||
Isso pode ser de grande ajuda quando você estiver trabalhando em uma nova feature que envolva tradução, em especial, e que necessite que você valide, por exemplo, uma label de botão em um idioma diferente.
|
||||
|
||||
> [!TIP] Você não precisa seguir esse documento para traduzir o currículo do freeCodeCamp ou contribuir com a documentação. Em vez disso, leia [esse guia aqui](./how-to-translate-files.md).
|
||||
> [!TIP] Você não precisa seguir esse documento para traduzir o currículo do freeCodeCamp ou contribuir com a documentação. Read [this guide here](how-to-translate-files.md) instead.
|
||||
|
||||
Vamos entender como o framework i18n e suas ferramentas funcionam.
|
||||
|
||||
@ -67,7 +67,7 @@ Alguns desses arquivos estão traduzidos na nossa plataforma de tradução (Crow
|
||||
|
||||
- O arquivo `intro.json` contém os pares chave-valor para o texto de introdução nas páginas de certificação.
|
||||
|
||||
Se você deseja adicionar/atualizar traduções para as chaves, [leia este guia aqui](/how-to-translate-files.md).
|
||||
If you want to add/update translations for the keys please [read this guide here](how-to-translate-files.md).
|
||||
|
||||
**Arquivos NÃO traduzidos na nossa plataforma de tradução:**
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ Se você quer criar novos passos, as ferramentas a seguir vão simplificar o pro
|
||||
|
||||
Um script único que automaticamente adiciona um novo passo baseado no último passo numerado como `part-xxx.md` onde `xxx` representa o número de 3 dígitos do último passo. O código inicial de desafio usará o código inicial de desafio da etapa anterior com os marcadores de região editáveis (ERMs) removidos.
|
||||
|
||||
**Observação:** Esse script também executa [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Como executar esse script:
|
||||
|
||||
@ -27,7 +27,7 @@ npm run create-next-step
|
||||
|
||||
Um script único que adiciona automaticamente um número especificado de passos começando a partir de um número específico. O código seed de todos os passos criados estarão vazios.
|
||||
|
||||
**Observação:** Esse script também executa [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Como executar esse script:
|
||||
|
||||
@ -42,7 +42,7 @@ npm run create-empty-steps start=X num=Y # onde X é o número do passo onde dev
|
||||
|
||||
Um único script que automaticamente adiciona passos entre dois passos consecutivos. O código inicial do desafio usará o código inicial do desafio da etapa inicial existente com os marcadores de região editáveis (ERMs) removidos.
|
||||
|
||||
**Observação:** Esse script também executa [reorder-steps](how-to-work-on-practice-projects#reorder-steps).
|
||||
**Note:** This script also runs [reorder-steps](#reorder-steps).
|
||||
|
||||
### Como executar esse script:
|
||||
|
||||
|
||||
@ -10,7 +10,7 @@ Fique à vontade para:
|
||||
- Nos ajudar a corrigir bugs na [plataforma de aprendizado](#plataforma-de-aprendizado) do freeCodeCamp.org.
|
||||
- [Nos ajudar a traduzir](#tradu%c3%a7%c3%b5es) freeCodeCamp.org para vários idiomas.
|
||||
|
||||
Respondemos às perguntas mais comuns sobre como contribuir [no nosso FAQ do colaborador](/FAQ.md).
|
||||
We answer the most common questions about contributing [in our contributor FAQ](FAQ.md).
|
||||
|
||||
## Currículo
|
||||
|
||||
|
||||
@ -18,7 +18,7 @@ O freeCodeCamp é uma comunidade inclusiva e temos de mantê-la assim.
|
||||
|
||||
Temos um código de conduta único que rege toda a nossa comunidade. Quanto menos regras, mais fáceis elas são de lembrar. Você pode ler essas regras e guardá-las na memória [aqui](https://code-of-conduct.freecodecamp.org).
|
||||
|
||||
> [!NOTE] Como moderador, nós adicionaríamos você a um ou mais times no GitHub, nos nossos fóruns comunitários e nos servidores de chat. Caso você não tenha acesso a uma plataforma que queira moderar, [entre em contato com um membro da equipe](/FAQ?id=additional-assistance).
|
||||
> [!NOTE] Como moderador, nós adicionaríamos você a um ou mais times no GitHub, nos nossos fóruns comunitários e nos servidores de chat. If you are missing access on a platform that you would like to moderate please [reach out to a staff member](FAQ.md#additional-assistance).
|
||||
|
||||
## Moderando no GitHub
|
||||
|
||||
@ -39,7 +39,7 @@ Você pode nos ajudar a organizar e moderar issues usando etiquetas [dessa lista
|
||||
|
||||
Preste atenção especial às etiquetas `"help wanted"` e `"first timers only"`. Elas devem ser adicionadas aos tópicos que você considere que possam ser abertos aos potenciais contribuidores para realizar um "pull request".
|
||||
|
||||
Uma etiqueta `"first timer only"` deve ser aplicada a uma issue trivial (ex.: consertar um erro de digitação) e deve incluir informações adicionais. Você pode usar esse [modelo de resposta](/moderator-handbook?id=first-timer-only-issues).
|
||||
Uma etiqueta `"first timer only"` deve ser aplicada a uma issue trivial (ex.: consertar um erro de digitação) e deve incluir informações adicionais. You can use this [reply template](moderator-handbook.md#first-timer-only-issues) for triage.
|
||||
|
||||
#### Fechando issues e pull requests parados, desatualizados ou inativos
|
||||
|
||||
@ -49,7 +49,7 @@ Uma etiqueta `"first timer only"` deve ser aplicada a uma issue trivial (ex.: co
|
||||
|
||||
- Se o criador do PR pedir assistência adicional ou mais tempo, as regras acima podem ser revistas após uma resposta. Em todo caso, os moderadores devem usar o melhor julgamento para resolverem o estado do PR.
|
||||
|
||||
> [!TIP] Recomendamos usar essa lista de [modelos de resposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=reply-templates) padrão enquanto estiver monitorando issues.
|
||||
> [!TIP] We recommend you use this list of standard [reply templates](moderator-handbook.md#reply-templates) while triaging issues.
|
||||
|
||||
### Moderando pull requests
|
||||
|
||||
@ -63,7 +63,7 @@ Pull Requests (PRs) são como os colaboradores enviam alterações para o reposi
|
||||
|
||||
Você também pode revisar isso diretamente no GitHub e decidir fazer merge ou não. Precisamos ter um pouco mais de cuidado com relação a isso, pois milhões de pessoas encontrarão este texto enquanto usam o currículo do freeCodeCamp. O pull request deixa o texto mais claro sem deixá-lo muito mais longo? As edições são relevantes e não são excessivamente pedantes? Lembre-se que nosso objetivo é que os desafios sejam mais claros e curtos dentro do possível. Não são o lugar para detalhes obscuros. Os contribuidores talvez tentem adicionar links para recursos dos desafios.
|
||||
|
||||
Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
Se as mudanças parecem boas, por favor aprove-as comentando "LGTM". Uma vez que um pull request tiver pelo menos duas aprovações (incluindo a sua) dos moderadores ou equipe de desenvolvedores, você pode fazer o merge.
|
||||
|
||||
@ -75,7 +75,7 @@ Pull Requests (PRs) são como os colaboradores enviam alterações para o reposi
|
||||
|
||||
Alguns contribuidores podem tentar adicionar mais testes para cobrir casos confusos pedantes. Precisamos ter cuidado para não deixarmos o desafio muito complicado. Esses desafios e seus testes devem ser simples e intuitivos na medida do possível. Além dos desafios de algoritmo e a seção de preparação para entrevistas, os estudantes devem ser capazes de resolver cada desafio em aproximadamente 2 minutos.
|
||||
|
||||
Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
Se as mudanças parecem boas, por favor aprove-as comentando "LGTM". Uma vez que um pull request tiver pelo menos duas aprovações (incluindo a sua) dos moderadores ou equipe de desenvolvedores, você pode fazer o merge.
|
||||
|
||||
@ -142,7 +142,7 @@ Muitas vezes, um pull request será obviamente de baixo esforço. Muitas vezes,
|
||||
|
||||
Há também situações em que o colaborador está tentando adicionar um link para o seu próprio site, incluir uma biblioteca que criou, ou tem uma edição frívola que não serve para ajudar ninguém, exceto a si mesmo.
|
||||
|
||||
Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](https://contribute.freecodecamp.org/#/moderator-handbook?id=closing-invalid-pull-requests).
|
||||
You can close invalid pull requests and reply to them with these [reply templates](moderator-handbook.md#closing-invalid-pull-requests).
|
||||
|
||||
#### Outras diretrizes para moderadores no GitHub
|
||||
|
||||
@ -387,8 +387,7 @@ Assim que você resolver essas issues, nós poderemos rever seu PR e fazer o mer
|
||||
|
||||
---
|
||||
|
||||
Fique à vontade para recorrer às [diretrizes de contribuição]
|
||||
(https://contribute.freecodecamp.org/#/how-to-work-on-coding-challenges?id=testing-challenges) para ver instruções sobre como executar o build de CI localmente. ✅
|
||||
Feel free to reference the [contributing guidelines](how-to-work-on-coding-challenges.md#testing-challenges) for instructions on running the CI build locally. ✅
|
||||
```
|
||||
|
||||
### Sincronização dos forks
|
||||
|
||||
Reference in New Issue
Block a user