chore(i18n,docs): update translations (#43825)
This commit is contained in:
camperbot
GitHub
@ -51,80 +51,80 @@ Siga essas instruções para fazer um PR, tendo em conta que as instruções ger
|
||||
|
||||
### Testando as mudanças no branch `main`
|
||||
|
||||
If you want to test your changes to `main` after using the above instructions, follow these instructions:
|
||||
Se você quer testar suas alterações na `main` depois de usar as instruções acima, siga essas:
|
||||
|
||||
- Follow the instructions on the [rdb-alpha repo](https://github.com/freeCodeCamp/rdb-alpha) to run a container
|
||||
- Start the tutorial using the `tutorial.json` file on the new branch
|
||||
- Siga as instruções no [repositório rdb-alpha](https://github.com/freeCodeCamp/rdb-alpha) para rodar um contêiner
|
||||
- Comece o tutorial usando o arquivo `tutorial.json` no novo branch
|
||||
|
||||
### Reviewing PR's to `main`
|
||||
### Revisando PRs para `main`
|
||||
|
||||
If reviewing a PR that only changes `main` with instructional or grammar issues as described above, the changes in `TUTORIAL.md` should match the changes in `tutorial.json`.
|
||||
Se estiver revisando um PR que tem apenas mudanças no `main` relacionadas à problemas de instrução ou gramaticais como descrito acima, as mudanças em `TUTORIAL.md` devem corresponder às mudanças em `tutorial.json`.
|
||||
|
||||
The `tutorial.json` file should not have changes to commit hashes, or step/level ids. Startup or level commands or file watchers likely should not be changed either. There are exceptions if there's an issue with a step, but they should be treated with more caution.
|
||||
O arquivo `tutorial.json` não deverá conter alterações para fazer o commit de hashes ou ids de passos/níveis. Comandos de inicialização ou de nível, ou prováveis observadores de arquivo não devem ser alterados. Há exceções caso exista algum problema com um passo, mas eles devem ser tratados com mais atenção.
|
||||
|
||||
Also, keep in mind that instructions usually use the lessons around them for context, so make sure they make sense.
|
||||
Também tenha em mente que instruções geralmente usam as lições ao seu redor para contextualizar, então garanta que elas façam sentido.
|
||||
|
||||
### Working on version branch
|
||||
### Trabalhando no branch de versão
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
> Reminder: Never make or push changes to a version branch that is on one of the freeCodeCamp repos. Always create a new one
|
||||
> Lembrete: Nunca faça ou envie mudanças para um branch de versão que esteja em um dos repositórios do freeCodeCamp. Sempre crie um novo
|
||||
|
||||
There's no easy way to see exactly what changed between version branches since the Git history will be rewritten. Accepting new version branches to use will need to be done with careful consideration and testing.
|
||||
Não existe um jeito fácil de ver exatamente o que mudou entre branches de versão, pois o histórico do Git será reescrito. Aceitar novos branches de versão para usar precisará ser feito com uma consideração cautelosa e testando.
|
||||
|
||||
These instructions are for changing anything on a "version" branch, such as tests, test text, reset files, adding and deleting steps, among other things.
|
||||
Essas instruções são para mudar qualquer coisa em um branch de versão, como testes, texto de teste, resetar arquivos, adicionar a remover passos, etc.
|
||||
|
||||
Follow these instructions to create a new version:
|
||||
Siga as próximas instruções para criar uma nova versão:
|
||||
|
||||
- Checkout the **latest** version branch with `git checkout -b vX.X.X upstream/vX.X.X`
|
||||
- Create a new branch off of that, incrementing the version, with `git checkout -b vX.X.Y`
|
||||
- Make your changes to the version branch. See more info in the [CodeRoad Documentation](https://coderoad.github.io/docs/edit-tutorial) for how to work with tutorials
|
||||
- Push the new branch to your fork with `git push -u origin vX.X.Y`
|
||||
- Checkout the `main` branch
|
||||
- Create a new branch off `main`. e.g. `feat/version-X.X.Y`
|
||||
- Change the `uri` in `coderoad.yaml` to your fork of the repo. This is so you and reviewers can test it before pushing it to the freeCodeCamp repo. Change the version to the new branch in the two spots of that file. Add your changes for the new version to `CHANGELOG.md`. Make any other changes you need.
|
||||
- Commit your changes with the message `feat: release version X.X.Y - <optional description>`
|
||||
- Run `coderoad build` to create a new `tutorial.json` file
|
||||
- Add and commit the file
|
||||
- Push the changes to your fork
|
||||
- Test your changes following the [testing instructions below](#testing-changes-to-a-version-branch). Make any additional changes and commit them as you just did, or, if you are satisfied, follow the rest of the instructions
|
||||
- Make a PR to `main` using your new `feat/version-X.X.Y` branch. Give it a title of `version X.X.Y ready for review`. This will not be merged, it is just to let reviewers know that there is a new version ready
|
||||
- Leave it here for reviewers
|
||||
- Vá para o **último** branch de versão com `git checkout -b vX.X.X upstream/vX.X.X`
|
||||
- Crie um novo branch fora daquele, aumentando a versão, com `git checkout -b vX.X.Y`
|
||||
- Efetue suas alterações para o branch de versão. Confira mais informações na [Documentação CodeRoad](https://coderoad.github.io/docs/edit-tutorial) para saber como trabralhar com tutoriais
|
||||
- Envie o novo branch para seu fork com `git push -u origin vX.X.Y`
|
||||
- Vá para o branch `main`
|
||||
- Crie um novo branch fora do `main`. por exemplo, `feat/version-X.X.Y`
|
||||
- Mude a `uri` em `coderoad.yaml` para o seu fork do repositório. Assim, você e revisadores podem testá-lo antes de enviá-lo para o repositório do freeCodeCamp. Mude a versão para o novo branch em dois lugares naquele arquivo. Adicione suas mudanças para a nova versão no arquivo `CHANGELOG.md`. Faça qualquer outras alterações que você precise.
|
||||
- Commit suas alterações com a mensagem `feat: release version X.X.Y - <descrição opcional>`
|
||||
- Rode `coderoad build` para criar um novo arquivo `tutorial.json`
|
||||
- Adicione e faça o commit do arquivo
|
||||
- Envie as mudanças para o seu fork
|
||||
- Teste suas alterações as [instruções para teste abaixo](#testing-changes-to-a-version-branch). Faça qualquer mudança adicional e faça commit delas como você fez anteriormente, ou, se você estiver satisfeito(a), siga o resto das instruções
|
||||
- Faça um PR para a `main` usando seu novo branch `feat/version-X.X.Y`. Dê o título de `version X.X.Y ready for review`. Não acontecerá o merge disso, é apenas para quem for revisar saiba que existe uma nova versão pronta
|
||||
- Após isso, suas mudanças serão revisadas
|
||||
|
||||
### Testing changes to a version branch
|
||||
### Testando alterações em um branch de versão
|
||||
|
||||
- Follow the instructions on the [rdb-alpha repo](https://github.com/freeCodeCamp/rdb-alpha) to run a container
|
||||
- Start the tutorial using the `tutorial.json` file on whatever fork the changes are on. Make sure to use the file on the `feat: version-X.X.Y` branch and not the `main` branch
|
||||
- Siga as instruções no [repositório rdb-alpha](https://github.com/freeCodeCamp/rdb-alpha) para rodar um contêiner
|
||||
- Comece o tutorial usando o arquivo `tutorial.json` em qualquer fork onde as alterações estejam presentes. Tenha certeza de usar o arquivo no `feat: version-X.X.Y` branch e não no `main` branch
|
||||
|
||||
### Pushing a new version
|
||||
### Enviando uma nova versão
|
||||
|
||||
Before pushing a new version, view the new `feat/version-vX.X.Y` (will be merged to `main`) branch on the user's fork. Make sure there are additions to the `CHANGELOG.md` file that include the new changes, and the version in the two spots of `coderoad.yaml` matches the new version branch.
|
||||
Antes de enviar uma nova versão, veja o novo branch `feat/version-vX.X.Y` (acontecerá o merge para a `main`) no fork do usuário. Tenha certeza que há adições no arquivo `CHANGELOG.md` que incluem as novas alterações, e a versão em dois lugares do arquivo `coderoad.yaml` correspondem com o novo branch de versão.
|
||||
|
||||
If you have write access to the freeCodeCamp repo, have verified the `CHANGELOG` and `coderoad.yaml` files, have tested the changes using the instructions above, and want to push a new version of a tutorial:
|
||||
Se você tiver acesso de escrita no repositório do freeCodeCamp, verificou os arquivos `CHANGELOG` e `coderoad.yaml`, testou as mudanças usando as instruções acima, e quer enviar uma nova versão de um tutorial:
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
> Reminder: Never make or push changes to a version branch that is on one of the freeCodeCamp repos. Always create a new one
|
||||
> Lembrete: Nunca faça ou envie mudanças para um branch de versão que estiver em um dos repositórios do freeCodeCamp. Sempre crie um novo
|
||||
|
||||
- If you don't have a remote to where the new changes exist, create a remote to the user's fork with `git remote add <users_fork>`
|
||||
- Delete any **local** branches that share a name with the new branches. Likely named either `vX.X.Y` or `feat/version-X.X.Y`
|
||||
- Checkout the new version branch with `git checkout -b vX.X.Y <remote>/vX.X.Y`
|
||||
- Push the new version branch to the freeCodeCamp repo with `git push -u upstream/vX.X.Y`. You need to push the new branch before you update `main` with the new `tutorial.json` file
|
||||
- Checkout the users branch that will be merged into `main` with `git checkout -b feat/version-X.X.Y <remote>/feat/version-X.X.Y`
|
||||
- Change the `uri` in `coderoad.yaml` back to the freeCodeCamp repo
|
||||
- Add and commit the changes
|
||||
- Run `coderoad build` to create the new `tutorial.json` file
|
||||
- Add and commit the file
|
||||
- Push the changes to your fork with `git push -u origin/feat/version-X.X.Y`
|
||||
- Make a PR to `main` on the freeCodeCamp repo
|
||||
- If you are satisfied, merge it or leave it and ask for a review from someone
|
||||
- After the PR is merged, open the tutorial by following the instructions on the [rdb-alpha repo](https://github.com/freeCodeCamp/rdb-alpha) to make sure it's loading properly, and that you can get through a few steps
|
||||
- Finally, if any PRs for this version exists, close them
|
||||
- Se você não tiver um branch remoto onde existem novas alterações, crie um para o fork do usuário com `git remote add <users_fork>`
|
||||
- Exclua qualquer branches **locais** que tenham o mesmo nome do novo branch. Parecidos com nomes como `vX.X.Y` ou `feat/version-X.X.Y`
|
||||
- Vá para o novo branch de versão com `git checkout -b vX.X.Y <remote>/vX.X.Y`
|
||||
- Envie o novo branch de versão para o repositório do freeCodeCamp com `git push -u upstream/vX.X.Y`. Você precisa enviar o novo branch antes de atualizar a `main` com o novo arquivo `tutorial.json`
|
||||
- Vá para os branches dos usuários em que ocorrerá o merge na `main` com `git checkout -b feat/version-X.X.Y <remote>/feat/version-X.X.Y`
|
||||
- Mude a `uri` em `coderoad.yaml` para o seu fork do repositório
|
||||
- Adicione e faça o commit do arquivo com as mudanças
|
||||
- Rode `coderoad build` para criar um novo arquivo `tutorial.json`
|
||||
- Adicione e faça o commit do arquivo
|
||||
- Envie o novo branch para seu fork com `git push -u origin vX.X.Y`
|
||||
- Faça um PR para o `main` no repositório do freeCodeCamp
|
||||
- Se você estiver satisfeito(a), faça o merge ou deixe-o e peça que alguém revise
|
||||
- Depois que for dado o merge do PR, abra o tutorial seguindo as instruções no [repositório rdb-alpha](https://github.com/freeCodeCamp/rdb-alpha) para ter certeza que está carregando corretamente e que você pode passar por alguns passos
|
||||
- Por fim, se existem PRs para esta versão, feche-os
|
||||
|
||||
### How to revert to a previous version
|
||||
### Como reverter para a versão anterior
|
||||
|
||||
- Create a new branch off the latest `main` with `git checkout -b revert/to-version-X.X.X`
|
||||
- Revert all commits on this branch up to and including the commit of the version after the one you want to revert to. For example, you may have commits that look like this:
|
||||
- Crie um novo branch fora do último `main` com `git checkout -b revert/to-version-X.X.X`
|
||||
- Reverta todos os commits desse branch a partir do commit da versão depois da que você quer reverter. Por exemplo, você deve ter commits que parecem com isso:
|
||||
|
||||
```
|
||||
fix: typo
|
||||
@ -133,6 +133,6 @@ fix: typo
|
||||
release: version 1.0.0
|
||||
```
|
||||
|
||||
If you want to revert to v1.0.0, revert all the commits from `release: version 1.0.1` and after
|
||||
Se você quiser reverter para a v1.0.0, reverta todos os commits a partir de `release: version 1.0.1`
|
||||
|
||||
- Create a PR. Give it a title of `revert: to version X.X.X`
|
||||
- Crie um PR. Dê o título de `revert: to version X.X.X`
|
||||
|
||||
Reference in New Issue
Block a user