diff --git a/docs/i18n/portuguese/FAQ.md b/docs/i18n/portuguese/FAQ.md index 241ad55267e..f3798b87137 100644 --- a/docs/i18n/portuguese/FAQ.md +++ b/docs/i18n/portuguese/FAQ.md @@ -1,68 +1,68 @@ -# Frequently Asked Questions +# Perguntas frequentes -Answers to common questions. +Respostas para perguntas frequentes. -## I am new to GitHub and Open Source. Where should I start? +## Eu sou novo no GitHub e em código aberto. Por onde devo começar? -Read our ["How to Contribute to Open Source Guide"](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). It's a comprehensive reference for first-timer-friendly projects. And it includes a lot of open-source contribution tips. +Leia nosso ["Guia de como contribuir com código aberto"](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). É uma referência ampla para quem contribui com projetos pela primeira vez. E inclui muitas dicas de como contribuir para código aberto. -## What do I need to know to contribute to the codebase? +## O que eu preciso saber para contribuir com a base de código? -freeCodeCamp runs on a modern JavaScript stack. If you're interested in contributing to our codebase, you will need some familiarity with JavaScript and some of the technologies we use like Node.js, MongoDB, OAuth 2.0, React, Gatsby, and Webpack. +O freeCodeCamp é executado em uma stack de JavaScript moderna. Se estiver interessado em contribuir com a nossa base de código, você precisará ter alguma familiaridade com JavaScript e com algumas das tecnologias que usamos como o Node.js, MongoDB, OAuth 2.0, React, Gatsby e Webpack. -## Can I translate freeCodeCamp's resources? +## Posso traduzir os recursos do freeCodeCamp? -Yes - You can contribute to any of the 30+ languages we have enabled on our translation platform. +Sim. Você pode contribuir com qualquer um dos mais de 30 idiomas disponíveis em nossa plataforma de tradução. -We have user-contributed translations live in some languages. 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/help-translate-freecodecamp-language/). +Temos traduções enviadas por usuários ao vivo em alguns idiomas. Pretendemos traduzir o freeCodeCamp para vários idiomas. Você pode ler mais sobre isso em nosso [anúncio aqui](https://www.freecodecamp.org/portuguese/news/como-ajudar-a-traduzir-o-freecodecamp-para-seu-idioma/). -If you are interested in contributing to translations please make sure you [read this guide](how-to-translate-files.md) first. +Se você está interessado em contribuir com as traduções, certifique-se de [ler este guia](how-to-translate-files.md) primeiro. -## Can I contribute articles to freeCodeCamp News or videos to freeCodeCamp's YouTube channel? +## Posso contribuir com artigos para o editorial do freeCodeCamp ou com vídeos para o canal do YouTube do CodeCamp? -Yes - you can contribute to our publication blog and YouTube channel. +Sim - você pode contribuir com o nosso blog de publicação e com o canal do YouTube. -If you're interested in writing articles for freeCodeCamp News, please visit this [publication guide](https://www.freecodecamp.org/news/how-to-write-for-freecodecamp/). In addition, please read our [style guide](https://www.freecodecamp.org/news/developer-news-style-guide/) as this will help you write stronger and more effective articles. +Se estiver interessado em escrever artigos para o editorial do freeCodeCamp, visite este [guia de publicação](https://www.freecodecamp.org/news/how-to-write-for-freecodecamp/). Além disso, leia nosso [guia de estilo](https://www.freecodecamp.org/news/developer-news-style-guide/) pois ele ajudará você a escrever artigos mais sólidos e eficazes. -To help us make educational videos for our YouTube channel, you can follow the [YouTube channel guide here](https://www.freecodecamp.org/news/how-to-contribute-to-the-freecodecamp-community-youtube-channel-b86bce4c865/). +Para nos ajudar a fazer vídeos educacionais para nosso canal do YouTube, você pode seguir o [guia do canal do YouTube aqui](https://www.freecodecamp.org/news/how-to-contribute-to-the-freecodecamp-community-youtube-channel-b86bce4c865/). -## How can I report a new bug? +## Como posso relatar um novo erro? -If you think you've found a bug, first read the ["How to Report a Bug"](https://www.freecodecamp.org/news/how-to-report-a-bug-to-freecodecamp/) article and follow its instructions. +Se você acha que encontrou um erro, primeiro leia o artigo ["Como relatar um erro"](https://www.freecodecamp.org/news/how-to-report-a-bug-to-freecodecamp/) e siga suas instruções. -If you're confident it's a new bug, go ahead and create a new GitHub issue. Be sure to include as much information as possible so that we can reproduce the bug. We have a pre-defined issue template to help you through this. +Se você está confiante de que é um novo erro, vá em frente e crie uma nova issue no GitHub. Certifique-se de incluir o máximo de informações possível para que possamos reproduzir o erro. Temos um modelo predefinido de issue para ajudar você. -Please note that these GitHub issues are for codebase-related issues and discussions – not for getting help with learning to code. Whenever in doubt, you should [seek assistance on the forum](https://forum.freecodecamp.org) before creating a GitHub issue. +Observe que essas issues do GitHub são para discussões e questões relacionadas ao código – não para obter ajuda sobre como aprender a programar. Sempre que houver dúvidas, você deve [procurar por assistência no fórum](https://forum.freecodecamp.org) antes de criar uma issue no GitHub. -## How can I report a security issue? +## Como posso relatar um problema de segurança? -Please don't create GitHub issues for security issues. Instead, please [follow our security policy](https://contribute.freecodecamp.org/#/security). +Não crie issues no GitHub para problemas de segurança. Em vez disso, [siga nossa política de segurança](https://contribute.freecodecamp.org/#/security). -## I am a student. Can I work on a feature for academic credits? +## Eu sou estudante. Posso trabalhar em um recurso para créditos acadêmicos? -Yes. Please note we are unable to commit to any timelines or paperwork that may be a requirement by your college or university. We receive many pull-requests and code contributions from volunteer developers, and we respect their time and efforts. Out of respect for all of our other contributors, we will not give any PR special priority just because it happens to be school-related. +Sim. Note, porém, que não podemos nos comprometer com nenhum cronograma ou documentação que possa ser um requisito da sua faculdade ou universidade. Recebemos muitos pull-requests e contribuições em código de desenvolvedores voluntários e respeitamos o tempo e esforço deles. Em respeito a todos os outros contribuidores, não daremos nenhuma prioridade especial a nenhum PR só por ser relacionado à escola. -We request you to plan ahead and work on code contributions with this in mind. +Pedimos que você planeje com antecedência e que trabalhe em suas contribuições de código tendo isso em mente. -## What do these different labels that are tagged on issues mean? +## O que significam estas etiquetas diferentes marcadas nas issues? -The code maintainers [triage](https://en.wikipedia.org/wiki/Software_bug#Bug_management) issues and pull requests based on their priority, severity, and other factors. You can [find a complete glossary of their meanings here](https://github.com/freecodecamp/freecodecamp/labels). +Os responsáveis pelo código fazem a [triagem](https://en.wikipedia.org/wiki/Software_bug#Bug_management) das issues e pull requests tendo como base a prioridade, importância e outros fatores. Você pode [encontrar um glossário completo dos significados aqui](https://github.com/freecodecamp/freecodecamp/labels). -## Where do I start if I want to work on an issue? +## Por onde começar se quero ajudar em uma issue? -You should go through [**`help wanted`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) or [**`first timers only`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) issues for a quick overview of what is available for you to work on. +Você deve consultar issues [**`help wanted`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) ou [**`first timers only`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) para saber o que está disponível para ajuda. > [!TIP] Você não precisa pedir permissão para ajudar com issues marcadas como **`help wanted`**. No entanto, issues com a etiqueta **`first timers only`** são issues especiais projetadas para pessoas que não contribuíram antes para a base de código freeCodeCamp. -## I found a typo. Should I report an issue before I can make a pull request? +## Encontrei um erro de digitação. Devo relatar uma issue antes de poder fazer um pull request? -For typos and other wording changes, you can directly open pull requests without creating an issue first. Please be sure to mention details in the pull request description to help us understand and review your contribution – even if it's just a minor change. +Para erros de digitação e outras mudanças em palavras, você pode diretamente abrir pull requests sem criar uma issue antes. Certifique-se de mencionar detalhes na descrição do pull request para nos ajudar a entender e revisar sua contribuição – mesmo se for uma mudança pequena. -Please do create an issue if you want to discuss bigger aspects of the codebase or curriculum. +Crie uma issue se quiser discutir grandes aspectos da base do código ou currículo. -## How can I get an issue assigned to me? +## Como posso receber uma issue atribuída a mim? -We typically do not assign issues to anyone other than long-time contributors. Instead, we follow the below policy to be fair to everyone: +Tipicamente, não atribuímos issues para ninguém além de contribuidores de longo prazo. Ao invés disso, seguimos a política abaixo para sermos justos com todos: 1. É muito provável que façamos o merge do primeiro pull request que resolve a issue. 2. No caso de vários colaboradores abrindo um pull request para a mesma issue, ao mesmo tempo, daremos prioridade ao pull request que melhor resolve a issue. Algumas coisas que consideramos: @@ -73,37 +73,37 @@ We typically do not assign issues to anyone other than long-time contributors. I - Você seguiu a checklist do pull request? - Você deu um título significativo ao seu pull request? -## I am interested in being a moderator at freeCodeCamp. Where should I start? +## Tenho interesse em ser um moderador no freeCodeCamp. Por onde devo começar? -Our community moderators are our heroes. Their voluntary contributions make freeCodeCamp a safe and welcoming community. +Os moderadores da nossa comunidade são nossos heróis. Suas contribuições voluntárias fazem do freeCodeCamp uma comunidade segura e receptiva. -First and foremost, we would need you to be an active participant in the community, and live by our [code of conduct](https://www.freecodecamp.org/news/code-of-conduct/) (not just enforce it). +Primeiro e mais importante, precisamos que você seja um participante ativo da comunidade e que siga à risca o nosso [código de conduta](https://www.freecodecamp.org/news/code-of-conduct/) (não se limite apenas a aplicá-lo). -Here are some recommended paths for some of our platforms: +Aqui estão alguns caminhos recomendados para algumas de nossas plataformas: - Para ser um moderador do **Discord/Chat**, tenha uma presença ativa em nosso chat e compromissos positivos com os outros, ao mesmo tempo em que aprende e pratica como lidar com conflitos em potencial que possam surgir. - Para ser um moderador do **fórum**, similar a um moderador de chat, tenha uma presença ativa e interaja com as outras pessoas que publicam no fórum, apoie-os em sua jornada de aprendizado e dê feedback quando perguntarem. Dê uma olhada no [Manual do líder do subfórum](https://forum.freecodecamp.org/t/the-subforum-leader-handbook/326326) para obter mais informações. - Para ser um moderador do **GitHub**, ajude a processar as issues levantadas no GitHub para ver se elas são válidas e (idealmente) tente propor soluções para essas issues a serem resolvidas por outras pessoas (ou por você mesmo). -Altogether, be respectful to others. We are humans from all around the world. With that in mind, please also consider using encouraging or supportive language and be mindful of cross-cultural communication. +No conjunto, seja respeitoso com os outros. Somos seres humanos de todo o mundo. Tendo isso em mente, considere também usar uma linguagem de incentivo ou de apoio e esteja atento à comunicação intercultural. -If you practice the above **consistently for a while** and our fellow moderator members recommend you, a staff member will reach out and onboard you to the moderators' team. Open source work is voluntary work and our time is limited. We acknowledge that this is probably true in your case as well. So we emphasize being **consistent** rather than engaging in the community 24/7. +Se você praticar o que foi dito acima **consistentemente por algum tempo** e se nossos companheiros moderadores recomendarem você, um membro da equipe entrará em contato e fará sua inclusão na equipe de moderadores. O trabalho em código aberto é trabalho voluntário e nosso tempo é limitado. Reconhecemos que isso é provavelmente também é verdade no seu caso. Por isso, enfatizamos a importância de ser **consistente** em vez de se envolver na comunidade em tempo integral. -Take a look at our [Moderator Handbook](moderator-handbook.md) for a more exhaustive list of other responsibilities and expectations we have of our moderators. +Dê uma olhada no nosso [Manual do Moderador](moderator-handbook.md) para obter uma lista mais completa de outras responsabilidades e expectativas que temos nossos moderadores. -## I am stuck on something that is not included in this documentation. +## Estou com dificuldade em algo que não está incluído na documentação. -**Feel free to ask for help in:** +**Fique à vontade para pedir ajuda em:** - A categoria `Contributors` do [fórum da nossa comunidade](https://forum.freecodecamp.org/c/contributors). - O canal `#Contributors` em nosso [servidor](https://discord.gg/PRyKn3Vbay). -We are excited to help you contribute to any of the topics that you would like to work on. If you ask us questions on the related issue threads, we will be glad to clarify. Be sure to search for your question before posting a new one. +Estamos animados em ajudar você a contribuir com qualquer tópico que desejar. Se você nos perguntar algo relacionado às issues, vamos ficar felizes em esclarecer. Certifique-se de pesquisar sua pergunta antes de postar uma nova. -Thanks in advance for being polite and patient. Remember – this community is run mainly by volunteers. +Agradecemos antecipadamente por ser educado(a) e paciente. Lembre-se – esta comunidade é feita principalmente de voluntários. -## Additional Assistance +## Assistência adicional -If you have queries about the stack, architecture of the codebase, translations, or anything else, feel free to reach out to our staff team [on the forum](https://forum.freecodecamp.org/g/team). +Se você tiver dúvidas sobre a stack, a arquitetura do código, as traduções ou qualquer outra coisa, pode entrar em contato com nossa equipe [no fórum](https://forum.freecodecamp.org/g/team). -**You can email our developer staff at: `dev[at]freecodecamp.org`** +**Você pode enviar um e-mail para nossa equipe de desenvolvimento: `dev[at]freecodecamp.org`** diff --git a/docs/i18n/portuguese/_sidebar.md b/docs/i18n/portuguese/_sidebar.md index 41fd3c44599..2cb3a4b2c01 100644 --- a/docs/i18n/portuguese/_sidebar.md +++ b/docs/i18n/portuguese/_sidebar.md @@ -8,35 +8,35 @@ - **Contribuição de código** - [Configurar o freeCodeCamp](how-to-setup-freecodecamp-locally.md) - [Seguir as melhores práticas](codebase-best-practices.md) - - [Work on Codebase](how-to-contribute-to-the-codebase.md) - - [Work on Coding Challenges](how-to-work-on-coding-challenges.md) - - [Work on Component Library](how-to-work-on-the-component-library.md) - - [Work on Practice Projects](how-to-work-on-practice-projects.md) - - [Work on Mobile app](how-to-setup-freecodecamp-mobile-app-locally.md) - - [Work on tutorials with CodeRoad](how-to-work-on-tutorials-that-use-coderoad.md) - - [Work on Localized Web App](how-to-work-on-localized-client-webapp.md) - - [Work on Cypress tests](how-to-add-cypress-tests.md) - - [Work on Video Challenges](how-to-help-with-video-challenges.md) - - [Work on Documentation](how-to-work-on-the-docs-theme.md) - - [Open a pull request](how-to-open-a-pull-request.md) + - [Trabalhar na base de código](how-to-contribute-to-the-codebase.md) + - [Trabalhar em desafios de programação](how-to-work-on-coding-challenges.md) + - [Trabalhar na biblioteca de componentes](how-to-work-on-the-component-library.md) + - [Trabalhar em projetos práticos](how-to-work-on-practice-projects.md) + - [Trabalhar na aplicação para dispositivos móveis](how-to-setup-freecodecamp-mobile-app-locally.md) + - [Trabalhar nos tutoriais com o CodeRoad](how-to-work-on-tutorials-that-use-coderoad.md) + - [Trabalhar na aplicação para a web localizada](how-to-work-on-localized-client-webapp.md) + - [Trabalhar em testes do Cypress](how-to-add-cypress-tests.md) + - [Trabalhar nos desafios em vídeo](how-to-help-with-video-challenges.md) + - [Trabalhar com a documentação](how-to-work-on-the-docs-theme.md) + - [Abrir um pull request](how-to-open-a-pull-request.md) - **Guias adicionais** - [Compreender a estrutura do arquivo do currículo](curriculum-file-structure.md) - [Depurar e-mails enviados localmente](how-to-catch-outgoing-emails-locally.md) - [Configurar freeCodeCamp no Windows (WSL)](how-to-setup-wsl.md) - - [Use Docker on Windows Home](how-to-use-docker-on-windows-home.md) - - [User Token Workflow](user-token-workflow.md) - - [Troubleshooting Development Issues](troubleshooting-development-issues.md) - - [Authors Analytics Manual](authors-analytics-manual.md) + - [Usar o Docker no Windows Home](how-to-use-docker-on-windows-home.md) + - [Fluxo de trabalho do token de usuário](user-token-workflow.md) + - [Solucionar problemas de desenvolvimento](troubleshooting-development-issues.md) + - [Manual de análise dos autores](authors-analytics-manual.md) --- - **Manuais de Voo** (para Equipe & Moderadores) - [Manual do Moderador](moderator-handbook.md) - - [Reply Templates](reply-templates.md) - - [Language Lead Handbook](language-lead-handbook.md) - - [DevOps Handbook](devops.md) - - [Courses VSCode Extension](courses-vscode-extension.md) - - [Enable New Language](how-to-enable-new-languages.md) + - [Modelos de resposta](reply-templates.md) + - [Manual do líder do idioma](language-lead-handbook.md) + - [Manual do DevOps](devops.md) + - [Extensão do VSCode Courses](courses-vscode-extension.md) + - [Habilitar um novo um idioma ](how-to-enable-new-languages.md) --- diff --git a/docs/i18n/portuguese/devops.md b/docs/i18n/portuguese/devops.md index 898c87fb146..15870dcee70 100644 --- a/docs/i18n/portuguese/devops.md +++ b/docs/i18n/portuguese/devops.md @@ -203,19 +203,19 @@ Você pode identificar a versão exata implantada visitando os registros de comp Existem algumas limitações e desvantagens conhecidas ao usar a versão beta da plataforma. -- **All data / personal progress on these beta platforms will NOT be saved or carried over to production** +- **Todos os dados/progresso pessoal nessas plataformas beta NÃO serão salvos ou transferidos para a produção** **Os usuários na versão beta terão uma conta separada da produção.** A versão beta usa um banco de dados fisicamente separado da produção. Isso nos dá a capacidade de evitar qualquer perda acidental de dados ou modificações. A equipe de desenvolvimento pode limpar o banco de dados nesta versão beta conforme necessário. -- **The beta platforms do not provide any assurances regarding uptime and reliability** +- **As plataformas beta não oferecem nenhuma garantia com relação a tempo de atividade e confiabilidade** Espera-se que a implantação seja frequente e em iterações rápidas, às vezes várias vezes ao dia. Como resultado, haverá tempos de inatividade inesperados ou funcionalidades quebradas na versão beta. -- **To ensure the effectiveness of the fix, it is advised not to direct regular users to this site for verification purposes.** +- **Para garantir a eficácia da correção, é aconselhável não direcionar usuários regulares para este site para fins de verificação.** O site beta é e sempre foi para melhorar o desenvolvimento e os testes locais, nada mais. Não é uma promessa do que está por vir, mas um vislumbre do que está sendo trabalhado. -- **Sign in page may look different than production** +- **O login na página pode parecer diferente da produção** Nós utilizamos um locatário de teste para o freeCodeCamp.dev no Auth 0 e, portanto, não temos a capacidade de definir um domínio personalizado. Isso faz com que todas as callbacks de redirecionamento e a página de login apareçam em um domínio padrão como: `https://freecodecamp-dev.auth0.com/`. Isso não afeta a funcionalidade e é o mais próximo da produção que conseguimos. diff --git a/docs/i18n/portuguese/how-to-enable-new-languages.md b/docs/i18n/portuguese/how-to-enable-new-languages.md index b40ab720107..e8d7d06c805 100644 --- a/docs/i18n/portuguese/how-to-enable-new-languages.md +++ b/docs/i18n/portuguese/how-to-enable-new-languages.md @@ -216,7 +216,7 @@ const algoliaIndices = { }; ``` -### Enabling Localized Videos +### Ativar os vídeos localizados Para os desafios em vídeo, você precisa fazer algumas alterações. Primeiro, adicione o novo idioma (locale) à consulta do GraphQL no arquivo `client/src/templates/Challenges/video/Show.tsx`. Por exemplo, para adicionar Dothraki à consulta: @@ -270,7 +270,7 @@ videoLocaleIds: Joi.when('challengeType', { }), ``` -## Client UI +## Interface do client Você precisará dar um passo adicional para lidar com as traduções da interface do client. @@ -283,7 +283,7 @@ Você vai querer copiar os seguintes arquivos de `/client/i18n/locales/english` - `motivation.json` - `trending.json` -## Testing Translations Locally +## Testar traduções localmente Se quiser testar as traduções localmente, antes de adicioná-las ao nosso repositório principal - pule as alterações de fluxo de trabalho do Crowdin. Siga as etapas para habilitar um idioma e, em seguida, baixe as traduções do Crowdin e as carregue em seu código local. @@ -303,11 +303,11 @@ Quando estes arquivos estiverem no local certo, você deve poder usar `pnpm run Para implantar novos idiomas em News, você precisa criar dois PRs. Um PR será para o [repositório do CDN](https://github.com/freeCodeCamp/cdn), enquanto o outro será para o [repositório News](https://github.com/freeCodeCamp/news). -## Prep the CDN Repo for the New Language +## Preparar o repositório do CDN para o novo idioma News busca os links de tendências e títulos de artigos do nosso CDN durante a build e adiciona-os ao rodapé. News também busca os arquivos Day.js do CDN durante a build para fazer a localização das datas e horários para cada idioma. -### Add a YAML File for Trending Articles +### Adicionar um arquivo YAML para os artigos populares Faça a clonagem do repositório [CDN](https://github.com/freeCodeCamp/cdn) e crie um branch. @@ -329,7 +329,7 @@ article3link: ... ... ``` -### Add a Day.js Locale File for the New Language +### Adicionar um arquivo de localização Day.js para o novo idioma Por padrão, Day.js só inclui inglês como local. Para habilitá-lo para funcionar com outros idiomas, você precisa adicionar um novo arquivo de locale Day.js ao CDN. @@ -367,13 +367,13 @@ Copie o código de local de Day.js da nova aba para o novo arquivo que você cri Em seguida, abra um PR para o repositório do CDN para adicionar os arquivos YAML e Day.js para revisão. -## Prep the News Repo for the New Language +## Preparar o repositório do editorial para o novo idioma O [repositório de News](https://github.com/freeCodeCamp/news) puxa dados de uma instância do Ghost, os arquivos que você adicionou ao CDN, faz a build de News e o implementa. > [!WARN] Pull requests para o repositório News _precisam_ vir do mesmo repositório. Você não deve trabalhar a partir de um fork nesse passo. -### Modify the Main Config File +### Modificar o arquivo de configuração principal Clonar o repositório News e criar uma branch. @@ -407,7 +407,7 @@ const algoliaIndices = { }; ``` -### Add the i18next JSON Files for the New Language +### Adicionar os arquivos em JSON do i18next para o novo idioma Em seguida, vá para o diretório `config/i18n/locales`, crie uma pasta e informe o nome do novo idioma que você está adicionando. Por exemplo, se você estiver lançando News em dothraki, crie uma pasta chamada `dothraki`. diff --git a/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md b/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md index b2b3e304b28..eb85f32f43d 100644 --- a/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md @@ -15,7 +15,7 @@ Aqui estão alguns prós e contras que devem ajudá-lo a decidir qual opção é | Precisa de uma conexão com a internet para funcionar | Conexão com a internet mínima necessária (uma vez configurada) | | Algumas tarefas, como a compilação e testes, podem demorar mais para serem concluídas | Completa as tarefas mais rapidamente (dependendo das capacidades da sua máquina) | -> [!ATTENTION] **Observação:** se você estiver usando o Windows 10 ou 11, precisará usar o WSL2. Você pode seguir [este guia](how-to-setup-wsl.md) para configurar o WSL2. Você não pode usar o prompt de comando, o Git Bash ou o PowerShell para executar freeCodeCamp nativamente dentro de janelas. +> [!ATTENTION] **Observação:** se você estiver usando o Windows 10 ou 11, precisará usar o WSL2. Você pode seguir [este guia](how-to-setup-wsl.md) para configurar o WSL2. Você não pode usar o prompt de comando, o Git Bash ou o PowerShell para executar freeCodeCamp nativamente no Windows. ### Como preparar um espaço de trabalho no GitPod diff --git a/docs/i18n/portuguese/how-to-setup-freecodecamp-mobile-app-locally.md b/docs/i18n/portuguese/how-to-setup-freecodecamp-mobile-app-locally.md index 885d387643a..7fe215950b1 100644 --- a/docs/i18n/portuguese/how-to-setup-freecodecamp-mobile-app-locally.md +++ b/docs/i18n/portuguese/how-to-setup-freecodecamp-mobile-app-locally.md @@ -2,11 +2,11 @@ Siga este guia para configurar a aplicação para dispositivos móveis do freeCo Alguns dos fluxos de trabalho de contribuição — como a correção de erros na base de código — necessitam que você execute a aplicação do freeCodeCamp localmente. -## How to Prepare your Local Machine +## Como preparar sua máquina local Comece instalando o software pré-requisito para seu sistema operacional. -### Prerequisites +### Pré-requisitos | Pré-requisito | Versão | Observações | | ------------------------------- | ------ | -------------------------------------------- | @@ -26,7 +26,7 @@ dart --version Depois de ter os pré-requisitos instalados, você precisa preparar seu ambiente de desenvolvimento. Isto é comum para muitos fluxos de trabalho de desenvolvimento, e você só precisará fazer isso uma vez. -#### Follow these steps to get your development environment ready: +#### Siga estas etapas para deixar seu ambiente de desenvolvimento pronto: 1. Instale o [Git](https://git-scm.com/) ou seu cliente Git favorito, se você ainda não fez isso. Atualize para a versão mais recente. A versão que veio com seu SO pode estar desatualizada. @@ -40,7 +40,7 @@ Depois de ter os pré-requisitos instalados, você precisa preparar seu ambiente Nós recomendamos muito usar o [Visual Studio Code](https://code.visualstudio.com/) ou o Android Studio. Também recomendamos instalar as [extensões](https://docs.flutter.dev/get-started/editor?tab=vscode) oficiais. -## Fork the Repository on GitHub +## Como fazer o fork do repositório no GitHub [Forking](https://help.github.com/articles/about-forks/) é uma etapa onde você obtém sua própria cópia do repositório (vulgo _repo_) no GitHub. @@ -58,7 +58,7 @@ Isso é essencial, pois permite que você trabalhe em sua própria cópia da apl 3. Depois que o repositório recebeu um fork, você será redirecionado para a cópia do repositório em `https://github.com/YOUR_USER_NAME/mobile` (`YOUR_USER_NAME` será substituído pelo seu nome de usuário do GitHub). -## Clone your Fork from GitHub +## Como clonar o seu fork no GitHub [Clonar](https://help.github.com/articles/cloning-a-repository/) é onde ** você faz o download de uma cópia** de um repositório de um local `remoto` que pertence a você ou a outra pessoa. No seu caso, este local remoto é o seu `fork` do repositório freeCodeCamp que deve estar disponível em `https://github.com/YOUR_USER_NAME/mobile`. (`YOUR_USER_NAME` será substituído pelo seu nome de usuário do GitHub.) @@ -78,7 +78,7 @@ Isto vai baixar todo o repositório da aplicação do freeCodeCamp para disposit Nota: `--depth=1` cria um clone raso do seu fork, com apenas o histórico mais recente. -## Set up Syncing from Parent +## Como configurar a sincronização a partir do repositório pai Agora que você baixou uma cópia do seu fork, será necessário configurar um remote `upstream` para o repositório pai. @@ -113,7 +113,7 @@ Agora que você baixou uma cópia do seu fork, será necessário configurar um r upstream https://github.com/freeCodeCamp/mobile.git (push) ``` -## Running freeCodeCamp Mobile App Locally +## Como executar a aplicação do freeCodeCamp para dispositivos móveis localmente Agora que você tem uma cópia local da aplicação do freeCodeCamp para dispositivos móveis, você pode seguir estas instruções para executá-la localmente. @@ -172,7 +172,7 @@ flutter run > [!TIP] Se estiver usando o VSCode ou o Android Studio, poderá iniciar a aplicação facilmente sem ter de executar os comandos no terminal. Mais informações [aqui](https://docs.flutter.dev/get-started/test-drive). -## Making Changes Locally +## Como fazer alterações localmente Agora você pode fazer alterações nos arquivos e fazer commit das suas alterações no clone local do seu fork. @@ -361,7 +361,7 @@ Siga estes passos: git push origin branch/nome-aqui ``` -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). @@ -374,7 +374,7 @@ A quick reference to the commands that you will need when working locally. | `npm ci` | Installs / re-install all dependencies and bootstraps the different services. | | `npm run seed` | Parses all the challenge markdown files and inserts them into MongoDB. | --> -## Troubleshooting +## Solução de problemas ### Problemas com a instalação dos pré-requisitos recomendados @@ -398,7 +398,7 @@ Se você receber erros durante a instalação das dependências, certifique-se d Seja paciente, pois a primeira configuração pode demorar um pouco, dependendo da largura de banda da sua rede. -## Getting Help +## Obtendo ajuda Se você está com dificuldades e precisa de ajuda, fique à vontade em perguntar na categoria ['Contributors' (colaboradores) em nosso fórum](https://forum.freecodecamp.org/c/contributors) ou [na sala de bate-papo dos colaboradores](https://discord.gg/PRyKn3Vbay). diff --git a/docs/i18n/portuguese/how-to-work-on-coding-challenges.md b/docs/i18n/portuguese/how-to-work-on-coding-challenges.md index 760bb262a2a..406bbe9de73 100644 --- a/docs/i18n/portuguese/how-to-work-on-coding-challenges.md +++ b/docs/i18n/portuguese/how-to-work-on-coding-challenges.md @@ -490,11 +490,11 @@ Você também é capaz de testar um desafio individualmente seguindo as seguinte > > Os valores atualmente aceitos são `english` e `chinese`, com `english` sendo o padrão. -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) -After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). +Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). -## Useful Links +## Links úteis Criação e edição de desafios: diff --git a/docs/i18n/portuguese/how-to-work-on-localized-client-webapp.md b/docs/i18n/portuguese/how-to-work-on-localized-client-webapp.md index 7ae9759c4fe..e6473a9cc64 100644 --- a/docs/i18n/portuguese/how-to-work-on-localized-client-webapp.md +++ b/docs/i18n/portuguese/how-to-work-on-localized-client-webapp.md @@ -266,11 +266,11 @@ Seria bom manter as chaves na mesma ordem entre todos os arquivos também. Além > [!NOTE] O underscore (`_`) é um caractere reservado para chaves dos arquivos que ficam do lado do client. Veja [a documentação](https://www.i18next.com/translation-function/plurals) para saber como são usados. -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) -After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). +Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). -## Helpful Documentation +## Documentação útil - [documentação react-i18next](https://react.i18next.com/latest/usetranslation-hook) - [documentação i18next](https://www.i18next.com/translation-function/essentials) diff --git a/docs/i18n/portuguese/how-to-work-on-practice-projects.md b/docs/i18n/portuguese/how-to-work-on-practice-projects.md index ed98f66140f..d6cfaf3486d 100644 --- a/docs/i18n/portuguese/how-to-work-on-practice-projects.md +++ b/docs/i18n/portuguese/how-to-work-on-practice-projects.md @@ -135,6 +135,6 @@ Um script único que atualiza automaticamente a frontmatter nos arquivos markdow pnpm run update-step-titles ``` -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) -After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). +Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). diff --git a/docs/i18n/portuguese/how-to-work-on-the-component-library.md b/docs/i18n/portuguese/how-to-work-on-the-component-library.md index 1a5bb5c73a7..1a49cbcb921 100644 --- a/docs/i18n/portuguese/how-to-work-on-the-component-library.md +++ b/docs/i18n/portuguese/how-to-work-on-the-component-library.md @@ -91,20 +91,20 @@ Para executar testes contra a biblioteca de componentes, execute o seguinte coma pnpm run test-ui-components ``` -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) -After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). +Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). -## Adding Packages to the UI-Component Library +## Adicionando pacotes à biblioteca de componentes da UI -We restrict adding new packages to the UI Components to help with the project's maintainability. In the rare chance that you think a dependency is needed, please check with the maintainers first and then use the following command to add a package: +Restringimos a adição de novos pacotes aos componentes da UI para ajudar com a manutenção do projeto. Na hipótese de você achar que uma dependência é necessária, consulte os gestores primeiro e use o seguinte comando para adicionar um pacote: ```bash cd tools/ui-components pnpm add package_name ``` -## Useful Links +## Links úteis - [Testes de acessibilidade](https://testing-library.com/docs/dom-testing-library/api-accessibility) - [Ordem de prioridade das consultas da biblioteca de testes do React](https://testing-library.com/docs/queries/about/#priority) diff --git a/docs/i18n/portuguese/how-to-work-on-the-docs-theme.md b/docs/i18n/portuguese/how-to-work-on-the-docs-theme.md index 93b6fd32516..d3f152f65ba 100644 --- a/docs/i18n/portuguese/how-to-work-on-the-docs-theme.md +++ b/docs/i18n/portuguese/how-to-work-on-the-docs-theme.md @@ -53,6 +53,6 @@ pnpm run docs:serve > O site da documentação deve estar disponível em -## Proposing a Pull Request (PR) +## Propondo um Pull Request (PR) -After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). +Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). diff --git a/docs/i18n/portuguese/moderator-handbook.md b/docs/i18n/portuguese/moderator-handbook.md index ba45e4dd826..9682e547e97 100644 --- a/docs/i18n/portuguese/moderator-handbook.md +++ b/docs/i18n/portuguese/moderator-handbook.md @@ -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". -For triaging a trivial issue such as a typo fix, it is recommended to apply a "first timers only" label along with additional information. You can utilize the [reply template](reply-templates.md#first-timer-only-issues) provided for this purpose. +Para a triagem de uma issue trivial como uma correção de ortografia, é recomendado aplicar uma etiqueta "first timers only" juntamente com informações adicionais. Você pode usar o [modelo de resposta](reply-templates.md#first-timer-only-issues) fornecido para esta finalidade. #### Fechando issues e pull requests parados, desatualizados ou inativos @@ -49,7 +49,7 @@ For triaging a trivial issue such as a typo fix, it is recommended to apply a "f - 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] We recommend you use this list of standard [reply templates](reply-templates.md) while triaging issues. +> [!TIP] Recomendamos usar essa lista de [modelos de resposta](reply-templates.md) padrão enquanto estiver monitorando 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. - You can close invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). + Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](reply-templates.md#closing-invalid-pull-requests). Se as mudanças parecem boas, por favor aprove-as comentando "LGTM" (Looks Good To Me - me parece bom, em inglês). 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. - You can close invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). + Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](reply-templates.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. -You can close these invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). +Você pode fechar pull requests inválidos e respondê-los com esses [modelos de resposta](reply-templates.md#closing-invalid-pull-requests). #### Outras diretrizes para moderadores no GitHub diff --git a/docs/i18n/portuguese/reply-templates.md b/docs/i18n/portuguese/reply-templates.md index ff89332be54..c54a642e053 100644 --- a/docs/i18n/portuguese/reply-templates.md +++ b/docs/i18n/portuguese/reply-templates.md @@ -1,19 +1,19 @@ -# Reply Templates +# Modelos de resposta -These are some of the standard reply templates that you may use while reviewing pull requests and triaging issues/pull requests. +Esses são alguns dos modelos de resposta que você talvez use enquanto estiver revisando issues/pull requests. -> You can make your own saved replies with GitHub's built-in [saved replies](https://github.com/settings/replies/) feature or use the ones below. +> Você pode fazer seu próprio modelo com a funcionalidade embutida do GitHub chamada [saved replies](https://github.com/settings/replies/) ou usar as citadas abaixo. -## Thank You +## Obrigado ```markdown Thank you for your contribution to the page! 👍 We are happy to accept these changes and look forward to future contributions. 🎉 ``` -## Thank you and congrats +## Obrigado e parabéns -> For thanking and encouraging first-time contributors. +> Para agradecer e encorajar colaboradores de primeira viagem. ```markdown Hi @username. Congrats on your first pull request (PR)! 🎉 @@ -22,7 +22,7 @@ Thank you for your contribution to the page! 👍 We are happy to accept these changes and look forward to future contributions. 📝 ``` -## Build Error +## Erro de compilação ```markdown Hey @username @@ -36,9 +36,9 @@ Once you resolve these issues, we will be able to review your PR and merge it. 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 +## Sincronização de forks -> When PR is not up to date with the `main` branch. +> Quando um PR não está atualizado com a branch `main`. ````markdown Hey @username @@ -65,8 +65,8 @@ Once you sync your fork and pass the build, we will be able to review your PR an Feel free to reference the ["Syncing a fork"](https://help.github.com/articles/syncing-a-fork/) article on GitHub for more insight on how to keep your fork up-to-date with the upstream repository. 🔄 ```` -## Merge Conflicts -> When PR has merge conflicts that need to be resolved.¹ +## Conflitos ao fazer o merge +> Quando um PR tem conflitos de merge isso precisa ser resolvido.¹ ```markdown Hey @username @@ -82,11 +82,11 @@ If you're not familiar with the merge conflict process, feel free to look over G Also, it's good practice on GitHub to write a brief description of your changes when creating a PR. 📝 ``` -¹ If a first-time-contributor has a merge conflict, maintainers will resolve the conflict for them. +¹ Se é a primeira vez de um colaborador e se ele tem um conflito de merge, os mantenedores resolverão o conflito para ele. -## Duplicate +## Duplicado -> When PR is repetitive or a duplicate. +> Quando um PR é duplo ou repetitivo. ```markdown Hey @username @@ -102,9 +102,9 @@ Thanks again! 😊 If you have any questions, feel free to ask questions on the ["Contributors" category on our forum](https://forum.freecodecamp.org/c/contributors) or [the contributors chat room](https://discord.gg/PRyKn3Vbay). ``` -## Closing Invalid Pull Requests +## Fechando pull requests inválidos -> When PR is invalid. +> Quando um PR é inválido. ```markdown Hey @username @@ -116,7 +116,7 @@ This is a standard message notifying you that we've reviewed your pull request a Thank you and happy coding. ``` -> When PR adds links to external resources. +> Quando o PR adiciona links para recursos externos. ```markdown Thank you for your pull request. @@ -126,7 +126,7 @@ We are closing this pull request. Please suggest links and other details to add If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -## Adding Comment About Newbie Mistakes +## Adicionando comentário sobre erros de iniciante ```markdown Hi there, @@ -165,9 +165,9 @@ We are happy you are excited to contribute and appreciate you taking the time to Happy Contributing. ``` -## Closing Invalid Issues +## Fechando issues inválidas -> When an issue relates to the camper's code. +> Quando uma issue se refere ao código do usuário do freeCodeCamp. ```markdown Thank you for reporting this issue. @@ -179,7 +179,7 @@ If the forum members determine there is nothing wrong with your code, you can re Thank you and happy coding. ``` -> When an issue is duplicate of an earlier issue. +> Quando uma issue é a mesma que uma issue anterior. ```markdown Thank you for reporting this issue. @@ -189,7 +189,7 @@ This is a standard message notifying you that this issue appears to be very simi If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -> When an issue is fixed in staging. +> Quando uma issue foi resolvida na fase de preparo. ```markdown Thank you for reporting this issue. @@ -199,9 +199,9 @@ This is a standard message notifying you that the problem you mentioned here is If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -## `first timer only` Issues +## Issues de `first timer only` -> When an issue is deemed to be eligible for first-time code contributors. +> Quando uma issue é considerada eligível pela primeira vez como contribuição ao código. ```markdown Thanks for opening this issue. @@ -221,7 +221,7 @@ Sometimes we may get more than one pull request. We typically accept the most qu Happy contributing. ``` -## Requests for Assignment +## Solicitações de atribuição ```md We typically do not assign issues. Instead, we accept the first pull request that comprehensively solves the issue. diff --git a/docs/i18n/portuguese/security-hall-of-fame.md b/docs/i18n/portuguese/security-hall-of-fame.md index c0bc3c12153..ec5d113d225 100644 --- a/docs/i18n/portuguese/security-hall-of-fame.md +++ b/docs/i18n/portuguese/security-hall-of-fame.md @@ -8,4 +8,4 @@ Embora não possamos oferecer nenhuma recompensa ou troca no momento, agradecemo - Peter Samir https://www.linkedin.com/in/peter-samir/ - Laurence Tennant ([@hyperreality](https://github.com/hyperreality)) trabalhando com IncludeSecurity.com - [GHSA-cc3r-grh4-27gj](https://github.com/freeCodeCamp/freeCodeCamp/security/advisories/GHSA-cc3r-grh4-27gj) -> **Thank you for your contributions :pray:** +> **Agradecemos por suas contribuições :pray:** diff --git a/docs/i18n/ukrainian/_sidebar.md b/docs/i18n/ukrainian/_sidebar.md index 71826c88fa5..6a2a443771c 100644 --- a/docs/i18n/ukrainian/_sidebar.md +++ b/docs/i18n/ukrainian/_sidebar.md @@ -8,35 +8,35 @@ - **Внесок до коду** - [Налаштування freeCodeCamp](how-to-setup-freecodecamp-locally.md) - [Передові практики написання коду](codebase-best-practices.md) - - [Work on Codebase](how-to-contribute-to-the-codebase.md) - - [Work on Coding Challenges](how-to-work-on-coding-challenges.md) - - [Work on Component Library](how-to-work-on-the-component-library.md) - - [Work on Practice Projects](how-to-work-on-practice-projects.md) - - [Work on Mobile app](how-to-setup-freecodecamp-mobile-app-locally.md) - - [Work on tutorials with CodeRoad](how-to-work-on-tutorials-that-use-coderoad.md) - - [Work on Localized Web App](how-to-work-on-localized-client-webapp.md) - - [Work on Cypress tests](how-to-add-cypress-tests.md) - - [Work on Video Challenges](how-to-help-with-video-challenges.md) - - [Work on Documentation](how-to-work-on-the-docs-theme.md) - - [Open a pull request](how-to-open-a-pull-request.md) + - [Робота над кодовою базою](how-to-contribute-to-the-codebase.md) + - [Робота над завданнями з кодом](how-to-work-on-coding-challenges.md) + - [Робота над компонентною бібліотекою](how-to-work-on-the-component-library.md) + - [Робота над практичними проєктами](how-to-work-on-practice-projects.md) + - [Робота над мобільним застосунком](how-to-setup-freecodecamp-mobile-app-locally.md) + - [Робота над матеріалами з CodeRoad](how-to-work-on-tutorials-that-use-coderoad.md) + - [Робота над локалізованим вебзастосунком](how-to-work-on-localized-client-webapp.md) + - [Робота над тестами Cypress](how-to-add-cypress-tests.md) + - [Робота над відеозавданнями](how-to-help-with-video-challenges.md) + - [Робота над документацією](how-to-work-on-the-docs-theme.md) + - [Відкриття запиту на злиття](how-to-open-a-pull-request.md) - **Додаткові інструкції** - [Структура файлів навчальної програми](curriculum-file-structure.md) - [Налагодження вихідних е-листів локально](how-to-catch-outgoing-emails-locally.md) - - [Встановлення freeCodeCamp на Windows (WSL)](how-to-setup-wsl.md) - - [Use Docker on Windows Home](how-to-use-docker-on-windows-home.md) - - [User Token Workflow](user-token-workflow.md) - - [Troubleshooting Development Issues](troubleshooting-development-issues.md) - - [Authors Analytics Manual](authors-analytics-manual.md) + - [Налаштування freeCodeCamp на Windows (WSL)](how-to-setup-wsl.md) + - [Використання Docker на Windows Home](how-to-use-docker-on-windows-home.md) + - [Робочий процес токенів користувача](user-token-workflow.md) + - [Розв’язання проблем розробки](troubleshooting-development-issues.md) + - [Керівництво з аналітики](authors-analytics-manual.md) --- - **Посібники** (для персоналу & модераторів) - [Довідник модератора](moderator-handbook.md) - - [Reply Templates](reply-templates.md) - - [Language Lead Handbook](language-lead-handbook.md) - - [DevOps Handbook](devops.md) - - [Courses VSCode Extension](courses-vscode-extension.md) - - [Enable New Language](how-to-enable-new-languages.md) + - [Шаблони відповідей](reply-templates.md) + - [Довідник мовного керівника](language-lead-handbook.md) + - [Довідник DevOps](devops.md) + - [Розширення VSCode Courses](courses-vscode-extension.md) + - [Додавання нової мови](how-to-enable-new-languages.md) --- diff --git a/docs/i18n/ukrainian/devops.md b/docs/i18n/ukrainian/devops.md index a1f0d06e88a..3ef56c581e2 100644 --- a/docs/i18n/ukrainian/devops.md +++ b/docs/i18n/ukrainian/devops.md @@ -1,18 +1,18 @@ # Довідник DevOps -This guide will help you understand our infrastructure stack and how we maintain our platforms. While this guide does not have exhaustive details for all operations, it could be used as a reference for your understanding of the systems. +Цей посібник допоможе вам зрозуміти наш стек інфраструктури і те, як ми підтримуємо наші платформи. Хоча цей посібник не має вичерпних подробиць всіх операцій, його можна використовувати як довідник для розуміння систем. -Let us know if you have feedback or queries and we will be happy to clarify. +Зв’яжіться з нами, якщо у вас виникнуть запитання, і ми з радістю роз’яснимо всі деталі. -## Flight Manual - Code Deployments +## Керівництво з розгортання коду -This repository is continuously built, tested, and deployed to **separate sets of infrastructure (Servers, Databases, CDNs, etc.)**. +Цей репозиторій постійно будується, тестується та розробляється на **окремих наборах інфраструктури (серверах, базах даних, CDN тощо)**. -This involves three steps to be followed in sequence: +Це передбачає три кроки, які потрібно виконувати послідовно: -1. New changes (both fixes and features) are merged into our primary development branch (`main`) via pull requests. -2. These changes are run through a series of automated tests. -3. Once the tests pass we release the changes (or update them if needed) to deployments on our infrastructure. +1. Нові зміни (виправлення та функціональності) об’єднуються до нашої основної гілки (`main`) через запити на злиття. +2. Ці зміни проходять через ряд автоматизованих тестів. +3. Після проходження тестів ми випускаємо зміни (або оновлюємо їх, якщо потрібно) для розгортання у нашій інфраструктурі. ### Building the codebase - Mapping Git Branches to Deployments @@ -26,25 +26,25 @@ Once the developer team [`@freeCodeCamp/dev-team`](https://github.com/orgs/freeC This is the final release that moves changes to our production platforms on freeCodeCamp.org. -### Testing changes - Integration and User Acceptance Testing +### Тестування змін: інтеграція та приймальне користувацьке тестування -We employ various levels of integration and acceptance testing to check on the quality of the code. All our tests are done through software like [GitHub Actions CI](https://github.com/freeCodeCamp/freeCodeCamp/actions) and [Azure Pipelines](https://dev.azure.com/freeCodeCamp-org/freeCodeCamp). +Ми використовуємо різні рівні інтеграції та приймального тестування, щоб перевірити якість коду. Всі наші тести виконуються за допомогою такого програмного забезпечення, як [GitHub Actions CI](https://github.com/freeCodeCamp/freeCodeCamp/actions) та [Azure Pipelines](https://dev.azure.com/freeCodeCamp-org/freeCodeCamp). -We have unit tests for testing our challenge solutions, Server APIs, and Client User interfaces. These help us test the integration between different components. +Ми маємо модульні тести для тестування розв’язків завдань, API серверів та інтерфейсів користувача. Це допомагає протестувати інтеграцію різних компонентів. -> [!NOTE] We are also in the process of writing end user tests which will help in replicating real-world scenarios like updating an email or making a call to the API or third-party services. +> [!NOTE] Ми також в процесі написання тестів кінцевого користувача, що допоможе відтворити реальні сценарії, як-от оновлення електронної пошти або дзвінок до API чи сторонніх служб. -Together these tests help in preventing issues from repeating themselves and ensure we do not introduce a bug while working on another bug or a feature. +Ці тести допомагають запобігти повторенню проблем і гарантують, що ми не вводимо нову помилку під час роботи над іншою помилкою або функцією. ### Deploying Changes - Pushing changes to servers -We have configured continuous delivery software to push changes to our development and production servers. +Ми налаштували безперервне програмне забезпечення доставки для надсилання змін до наших серверів розробки та виробництва. Once the changes are pushed to the protected release branches, a build pipeline is automatically triggered for the branch. The build pipelines are responsible for building artifacts and keeping them in a cold storage for later use. The build pipeline goes on to trigger a corresponding release pipeline if it completes a successful run. The release pipelines are responsible for collecting the build artifacts, moving them to the servers, and going live. -The statuses of builds and releases are [available here](#build-test-and-deployment-status). +Статуси збірок та випуски [доступні тут](#build-test-and-deployment-status). ## Trigger a Build, Test, and Deploy @@ -199,38 +199,38 @@ Once one of the staff members approves a release, the pipeline will push the cha Ви можете ідентифікувати точну розгорнуту версію, відвідавши збірку та журнали розгортання, доступні в розділі статусу. Або ж ви можете написати нам у [чаті](https://discord.gg/PRyKn3Vbay) для підтвердження. -### Known Limitations +### Відомі обмеження -There are some known limitations and tradeoffs when using the beta version of the platform. +Існують деякі відомі обмеження і компроміси при використанні бета-версії платформи. -- **All data / personal progress on these beta platforms will NOT be saved or carried over to production** +- **Всі дані та особистий прогрес на бета-платформі НЕ будуть збережені чи перенесені до робочої версії** - **Users on the beta version will have a separate account from the production.** The beta version uses a physically separate database from production. This gives us the ability to prevent any accidental loss of data or modifications. The dev-team may purge the database on this beta version as needed. + **Користувачі бета-версії матимуть окремий обліковий запис.** Бета-версія використовує іншу фізичну базу даних. Це дає можливість запобігти випадковій втраті даних чи змін. В разі потреби команда розробників може очистити базу даних цієї бета-версії. -- **The beta platforms do not provide any assurances regarding uptime and reliability** +- **Бета-платформи не надають жодних гарантій щодо працездатності та надійності** - Deployment is expected to be frequent and in rapid iterations, sometimes multiple times a day. As a result, there will be unexpected downtime at times or broken functionality on the beta version. + Очікується, що розгортання відбуватиметься часто та у швидких ітераціях, іноді декілька разів на день. В результаті іноді в бета-версії будуть неочікувані простої чи неробочі функціональності. -- **To ensure the effectiveness of the fix, it is advised not to direct regular users to this site for verification purposes.** +- **Щоб забезпечити ефективність виправлення, радимо не надсилати регулярних користувачів на цей вебсайт з метою перевірки.** - The beta site is and always has been to augment local development and testing, nothing else. It's not a promise of what’s coming, but a glimpse of what is being worked upon. + Метою бета-сайту завжди було вдосконалити локальну розробку та тестування, нічого іншого. Це не майбутня версія платформи, а звичайний перегляд того, над чим ми працюємо. -- **Sign in page may look different than production** +- **Сторінка входу може відрізнятись від робочої версії** - We use a test tenant for freeCodeCamp.dev on Auth0, and hence do not have the ability to set a custom domain. This makes it so that all the redirect callbacks and the login page appear at a default domain like: `https://freecodecamp-dev.auth0.com/`. This does not affect the functionality and is as close to production as we can get. + Ми використовуємо тестовий клієнт для freeCodeCamp.dev на Auth0, тому не можемо встановити власний домен. Це дозволяє зробити так, що всі зворотні виклики й сторінки авторизації з’являтимуться на домені за замовчуванням: `https://freecodecamp-dev.auth0.com/`. Це не впливає на функціональність та є максимально приближеним до робочої версії. -## Reporting issues and leaving feedback +## Повідомлення про проблеми та зворотний зв’язок -Please open fresh issues for discussions and reporting bugs. +Будь ласка, створюйте нові завдання для обговорення чи повідомлення про помилки. -You may send an email to `dev[at]freecodecamp.org` if you have any queries. As always all security vulnerabilities should be reported to `security[at]freecodecamp.org` instead of the public tracker and forum. +Ви можете надіслати електронний лист на `dev[at]freecodecamp.org` у разі виникнення будь-яких запитів. Про вразливість безпеки потрібно повідомляти на `security[at]freecodecamp.org`, а не публічному журналі чи форумі. -## Flight Manual - Server Maintenance +## Керівництво з обслуговування сервера > [!WARNING] > -> 1. The guide applies to the **freeCodeCamp Staff members only**. -> 2. These instructions should not be considered exhaustive, please use caution. +> 1. Це керівництво стосується **лише персоналу freeCodeCamp**. +> 2. У цих інструкціях вказано не всю інформацію, тому будьте обережними. As a member of the staff, you may have been given access to our cloud service providers like Azure, Digital Ocean, etc. @@ -242,21 +242,21 @@ Here are some handy commands that you can use to work on the Virtual Machines (V ### Azure -Install Azure CLI `az`: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli +Встановіть Azure CLI `az`: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli -> **(One-time) Install on macOS with [`homebrew`](https://brew.sh):** +> **(Одноразово) Встановіть на macOS за допомогою [`homebrew`](https://brew.sh):** ``` brew install azure-cli ``` -> **(One-time) Login:** +> **(Одноразовий) Вхід:** ``` az login ``` -> **Get the list of VM names and IP addresses:** +> **Отримайте список назв віртуальних машин та IP-адрес:** ``` az vm list-ip-addresses --output table @@ -264,15 +264,15 @@ az vm list-ip-addresses --output table ### Digital Ocean -Install Digital Ocean CLI `doctl`: https://github.com/digitalocean/doctl#installing-doctl +Встановіть Digital Ocean CLI `doctl`: https://github.com/digitalocean/doctl#installing-doctl -> **(One-time) Install on macOS with [`homebrew`](https://brew.sh):** +> **(Одноразово) Встановіть на macOS за допомогою [`homebrew`](https://brew.sh):** ``` brew install doctl ``` -> **(One-time) Login:** +> **(Одноразовий) Вхід:** Authentication and context switching: https://github.com/digitalocean/doctl#authenticating-with-digitalocean @@ -280,7 +280,7 @@ Authentication and context switching: https://github.com/digitalocean/doctl#auth doctl auth init ``` -> **Get the list of VM names and IP addresses:** +> **Отримайте список назв віртуальних машин та IP-адрес:** ``` doctl compute droplet list --format "ID,Name,PublicIPv4" @@ -319,9 +319,9 @@ Cleanup unused packages sudo apt autoremove -y ``` -## Work on Web Servers (Proxy) +## Працюйте над вебсерверами (проксі) -We are running load balanced (Azure Load Balancer) instances for our web servers. These servers are running NGINX which reverse proxy all of the traffic to freeCodeCamp.org from various applications running on their own infrastructures. +Ми запускаємо збалансовані екземпляри (Azure Load Balancer) для наших вебсерверів. These servers are running NGINX which reverse proxy all of the traffic to freeCodeCamp.org from various applications running on their own infrastructures. The NGINX config is available on [this repository](https://github.com/freeCodeCamp/nginx-config). @@ -370,7 +370,7 @@ Provisioning VMs with the Code Add/update the source/origin application IP addresses. -3. Set up networking and firewalls. +3. Налаштуйте мережу та брандмауери. Configure Azure firewalls and `ufw` as needed for ingress origin addresses. @@ -378,17 +378,17 @@ Provisioning VMs with the Code Configure and add rules to load balancer if needed. You may also need to add the VMs to load balancer backend pool if needed. -### Logging and Monitoring +### Журналювання та моніторинг -1. Check status for NGINX service using the below command: +1. Перевірте стан служби NGINX за допомогою наступної команди: ```console sudo systemctl status nginx ``` -2. Logging and monitoring for the servers are available at: +2. Журналювання та моніторинг служб доступні на: - NGINX Amplify: [https://amplify.nginx.com]('https://amplify.nginx.com'), our current basic monitoring dashboard. We are working on more granular metrics for better observability + NGINX Amplify: [https://amplify.nginx.com]('https://amplify.nginx.com') — наша поточна базова панель моніторингу. Ми працюємо над детальнішими показниками для кращого спостереження ### Updating Instances (Maintenance) @@ -427,15 +427,15 @@ sudo apt install build-essential Provisioning VMs with the Code -1. Install Node LTS. +1. Встановіть Node LTS. -2. Install pnpm globally. +2. Встановіть pnpm глобально. ```console npm install -g pnpm ``` -3. Clone freeCodeCamp, set up env, and keys. +3. Клонуйте freeCodeCamp, налаштуйте середовище та ключі. ```console git clone https://github.com/freeCodeCamp/freeCodeCamp.git @@ -445,7 +445,7 @@ git checkout prod-current # or any other branch to be deployed 4. Create the `.env` from the secure credentials storage. -5. Install dependencies +5. Встановіть залежності ```console pnpm install @@ -458,13 +458,13 @@ pnpm pm2 install pm2-logrotate pnpm pm2 startup ``` -7. Build the server +7. Побудуйте сервер ```console pnpm prebuild && pnpm build:curriculum && pnpm build:server ``` -8. Start Instances +8. Запустіть екземпляри ```console pnpm start:server @@ -488,25 +488,25 @@ Code changes need to be deployed to the API instances from time to time. It can #### 1. Manual Updates - Used for updating dependencies, env variables. -1. Stop all instances +1. Зупиніть всі екземпляри ```console pnpm pm2 stop all ``` -2. Install dependencies +2. Встановіть залежності ```console pnpm install ``` -3. Build the server +3. Побудуйте сервер ```console pnpm prebuild && pnpm build:curriculum && pnpm build:server ``` -4. Start Instances +4. Запустіть екземпляри ```console pnpm start:server && pnpm pm2 logs @@ -542,7 +542,7 @@ sudo apt install build-essential Provisioning VMs with the Code -1. Install Node LTS. +1. Встановіть Node LTS. 2. Update `npm` and install PM2 and setup `logrotate` and startup on boot @@ -594,15 +594,15 @@ Code changes need to be deployed to the API instances from time to time. It can #### 1. Manual Updates - Used for updating dependencies, env variables. -1. Stop all instances +1. Зупиніть всі екземпляри ```console pm2 stop all ``` -2. Install or update dependencies +2. Встановіть чи оновіть залежності -3. Start Instances +3. Запустіть екземпляри ```console pm2 start all --update-env && pm2 logs @@ -669,7 +669,7 @@ Provisioning VMs with the Code Add/update the source/origin application IP addresses. -3. Set up networking and firewalls. +3. Налаштуйте мережу та брандмауери. Configure Azure firewalls and `ufw` as needed for ingress origin addresses. @@ -874,11 +874,11 @@ pm2 save pm2 logs ``` -## Installing and Updating Azure Pipeline Agents +## Встановлення та оновлення агентів Azure Pipeline -See: https://docs.microsoft.com/en-us/azure/devops/pipelines/agents/v2-linux?view=azure-devops and follow the instructions to stop, remove, and reinstall agents. Broadly you can follow the steps listed here. +Див. https://docs.microsoft.com/en-us/azure/devops/pipelines/agents/v2-linux?view=azure-devops та дотримуйтесь інструкцій, щоб зупинити, видалити та перевстановити агентів. Загалом ви можете дотримуватись кроків, наведених нижче. -You would need a PAT, that you can grab from here: https://dev.azure.com/freeCodeCamp-org/_usersSettings/tokens +Вам знадобиться PAT, який можна взяти тут: https://dev.azure.com/freeCodeCamp-org/_usersSettings/tokens ### Installing Agents on Deployment targets @@ -955,19 +955,19 @@ We use [a CLI tool](https://github.com/freecodecamp/sendgrid-email-blast) to sen 7. When the email blast is complete, verify that no emails have failed before destroying the droplets. -## Flight Manual - Adding news instances for new languages +## Керівництво з додавання екземплярів новин нових мов -### Theme Changes +### Зміни теми -We use a custom [theme](https://github.com/freeCodeCamp/news-theme) for our news publication. Adding the following changes to the theme enables the addition of new languages. +Ми використовуємо власну [тему](https://github.com/freeCodeCamp/news-theme) для публікацій новин. Виконавши наступні зміни теми, можна додати нову мову. -1. Include an `else if` statement for the new [ISO language code](https://www.loc.gov/standards/iso639-2/php/code_list.php) in [`setup-locale.js`](https://github.com/freeCodeCamp/news-theme/blob/main/assets/config/setup-locale.js) -2. Create an initial config folder by duplicating the [`assets/config/en`](https://github.com/freeCodeCamp/news-theme/tree/main/assets/config/en) folder and changing its name to the new language code. (`en` —> `es` for Spanish) -3. Inside the new language folder, change the variable names in `main.js` and `footer.js` to the relevant language short code (`enMain` —> `esMain` for Spanish) -4. Duplicate the [`locales/en.json`](https://github.com/freeCodeCamp/news-theme/blob/main/locales/en.json) and rename it to the new language code. -5. In [`partials/i18n.hbs`](https://github.com/freeCodeCamp/news-theme/blob/main/partials/i18n.hbs), add scripts for the newly created config files. -6. Add the related language `day.js` script from [cdnjs](https://cdnjs.com/libraries/dayjs/1.10.4) to the [freeCodeCamp CDN](https://github.com/freeCodeCamp/cdn/tree/main/build/news-assets/dayjs/1.10.4/locale) +1. Врахуйте інструкцію `else if` до [коду ISO нової мови](https://www.loc.gov/standards/iso639-2/php/code_list.php) у [`setup-locale.js`](https://github.com/freeCodeCamp/news-theme/blob/main/assets/config/setup-locale.js) +2. Створіть початкову папку конфігурації, створивши копію папки [`assets/config/en`](https://github.com/freeCodeCamp/news-theme/tree/main/assets/config/en) та змінивши її назву на код нової мови. (`en` —> `es` для іспанської) +3. Всередині папки нової мови змініть назви змінних у `main.js` та `footer.js` на відповідні скорочені коди мови (`enMain` —> `esMain` для іспанської) +4. Створіть копію [`locales/en.json`](https://github.com/freeCodeCamp/news-theme/blob/main/locales/en.json) та змініть її назву на код нової мови. +5. Додайте сценарії для щойно створених файлів конфігурації до [`partials/i18n.hbs`](https://github.com/freeCodeCamp/news-theme/blob/main/partials/i18n.hbs). +6. Додайте сценарій відповідної мови `day.js` з [cdnjs](https://cdnjs.com/libraries/dayjs/1.10.4) до [freeCodeCamp CDN](https://github.com/freeCodeCamp/cdn/tree/main/build/news-assets/dayjs/1.10.4/locale) -### Ghost Dashboard Changes +### Зміни інформаційної панелі Ghost -Update the publication assets by going to the Ghost dashboard > settings > general and uploading the publications's [icon](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc-puck-500-favicon.png), [logo](https://github.com/freeCodeCamp/design-style-guide/blob/master/downloads/fcc_primary_large.png), and [cover](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc_ghost_publication_cover.png). +Оновіть активи публікацій, перейшовши на Ghost Dashboard > Settings > General та завантаживши [піктограму](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc-puck-500-favicon.png), [логотип](https://github.com/freeCodeCamp/design-style-guide/blob/master/downloads/fcc_primary_large.png) та [зображення](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc_ghost_publication_cover.png). diff --git a/docs/i18n/ukrainian/how-to-enable-new-languages.md b/docs/i18n/ukrainian/how-to-enable-new-languages.md index c8610b4e59a..a5d1c2bb50a 100644 --- a/docs/i18n/ukrainian/how-to-enable-new-languages.md +++ b/docs/i18n/ukrainian/how-to-enable-new-languages.md @@ -216,7 +216,7 @@ const algoliaIndices = { }; ``` -### Enabling Localized Videos +### Додавання локалізованих відео Вам потрібно дещо змінити стосовно відеозавдань. Спочатку додайте нову локаль до запиту GraphQL у файлі `client/src/templates/Challenges/video/Show.tsx`. Ось так додається дотракійська мова: @@ -270,7 +270,7 @@ videoLocaleIds: Joi.when('challengeType', { }), ``` -## Client UI +## Інтерфейс клієнта Вам потрібно здійснити додатковий крок для роботи з перекладами інтерфейсу клієнта. @@ -283,7 +283,7 @@ videoLocaleIds: Joi.when('challengeType', { - `motivation.json` - `trending.json` -## Testing Translations Locally +## Тестування перекладів локально Якщо ви хочете перевірити переклади локально, перш ніж додати їх до нашого основного репозиторію, то пропустіть зміни робочого процесу на Crowdin. Виконайте кроки для додавання мови, а потім завантажте переклади з Crowdin і додайте їх до свого локального коду. @@ -303,11 +303,11 @@ videoLocaleIds: Joi.when('challengeType', { Щоб започаткувати новини новою мовою, потрібно створити два PR. Один PR буде для [репозиторію CDN](https://github.com/freeCodeCamp/cdn), а інший — для [репозиторію News](https://github.com/freeCodeCamp/news). -## Prep the CDN Repo for the New Language +## Приготуйте репозиторій CDN для нової мови News отримує популярні посилання й назви статей із нашого CDN під час збірки та додає їх у нижній колонтитул. News також отримує файли Day.js із CDN під час збірки, щоб локалізувати дати та час кожної мови. -### Add a YAML File for Trending Articles +### Додайте файл YAML для популярних статей Клонуйте [репозиторій CDN](https://github.com/freeCodeCamp/cdn) та створіть нову гілку. @@ -329,7 +329,7 @@ article3link: ... ... ``` -### Add a Day.js Locale File for the New Language +### Додайте файл локалі Day.js для нової мови Day.js містить лише англійську локаль за замовчуванням. Щоб дозволити роботу з іншими мовами, потрібно додати новий файл локалі Day.js до CDN. @@ -367,13 +367,13 @@ Day.js містить лише англійську локаль за замов Потім відкрийте PR до репозиторію CDN, щоб додати файли YAML та Day.js для перегляду. -## Prep the News Repo for the New Language +## Приготуйте репозиторій News для нової мови [Репозиторій News](https://github.com/freeCodeCamp/news) отримує дані з екземпляра Ghost, файли, додані до CDN, будує News та розробляє їх. > [!WARN] PR для репозиторію News _повинні_ надходити з одного репозиторію. Не працюйте над цим кроком з розгалуження. -### Modify the Main Config File +### Змініть головний файл конфігурації Клонуйте репозиторій News та створіть нову гілку. @@ -407,7 +407,7 @@ const algoliaIndices = { }; ``` -### Add the i18next JSON Files for the New Language +### Додайте файли JSON i18next для нової мови Перейдіть до каталогу `config/i18n/locales`, створіть нову папку та надайте їй назву мови, яку додаєте. Наприклад, якщо ви додаєте новини дотракійською мовою, створіть папку під назвою `dothraki`. diff --git a/docs/i18n/ukrainian/moderator-handbook.md b/docs/i18n/ukrainian/moderator-handbook.md index 809c529e35a..66fd5abc132 100644 --- a/docs/i18n/ukrainian/moderator-handbook.md +++ b/docs/i18n/ukrainian/moderator-handbook.md @@ -39,7 +39,7 @@ Зверніть увагу на позначки `"help wanted"` та `"first timers only"`. Їх потрібно додавати до тредів, які підійдуть потенційним помічникам для створення запиту на злиття. -For triaging a trivial issue such as a typo fix, it is recommended to apply a "first timers only" label along with additional information. You can utilize the [reply template](reply-templates.md#first-timer-only-issues) provided for this purpose. +Для розв’язання незначної проблеми, як-от друкарської помилки, рекомендовано застосувати позначку «first timers only» разом із додатковою інформацією. Для цього ви можете використати [шаблони відповідей](reply-templates.md#first-timer-only-issues). #### Закриті, застарілі, неактивні завдання та запити на злиття @@ -49,7 +49,7 @@ For triaging a trivial issue such as a typo fix, it is recommended to apply a "f - Якщо помічнику потрібні допомога або час, ми повернемося до нього після отримання відповіді. У будь-якому випадку, модератори повинні розсудливо вирішувати спірні статуси запитів. -> [!TIP] We recommend you use this list of standard [reply templates](reply-templates.md) while triaging issues. +> [!TIP] Рекомендуємо використовувати список стандартних [шаблонів відповідей](reply-templates.md) під час сортування завдань. ### Модерація запитів на злиття @@ -63,7 +63,7 @@ For triaging a trivial issue such as a typo fix, it is recommended to apply a "f Це можна зробити одразу на GitHub та вирішити, чи потрібно їх об’єднувати. Нам потрібно подбати про мільйони людей, які працюють з цим текстом під час навчання на freeCodeCamp. Чи дійсно текст буде зрозумілішим, але не стане більшим? Чи доречні ці зміни? Пам’ятайте, що наша ціль — зробити завдання зрозумілими та короткими. Зайві деталі лише відволікають. Можна додати посилання на ресурс, який стосується теми завдання. - You can close invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). + Ви можете закрити недійсний PR та відповісти на нього за допомогою [шаблона](reply-templates.md#closing-invalid-pull-requests). Якщо зміни позитивні, залиште коментар «LGTM» (Looks Good To Me). Як тільки запит отримає принаймні два схвалення від модераторів чи розробників (включно з вашим), ви можете об’єднати його. @@ -75,7 +75,7 @@ For triaging a trivial issue such as a typo fix, it is recommended to apply a "f Деякі помічники можуть спробувати додати додаткові тести, щоб покрити всі можливі випадки. Важливо, аби завдання не виявилось занадто складним. Завдання та їх тести повинні бути максимально простими для розуміння. Окрім алгоритмічних завдань та розділу з інтерв’ю, учні повинні вирішити кожне завдання протягом двох хвилин. - You can close invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). + Ви можете закрити недійсний PR та відповісти на нього за допомогою [шаблона](reply-templates.md#closing-invalid-pull-requests). Якщо зміни позитивні, залиште коментар «LGTM». Як тільки запит отримає принаймні два схвалення від модераторів чи розробників (включно з вашим), ви можете об’єднати його. @@ -142,7 +142,7 @@ For triaging a trivial issue such as a typo fix, it is recommended to apply a "f Бувають і ситуації, коли помічник додає посилання на свій вебсайт, включно зі створеною ним бібліотекою, або вносить поверхневі зміни, які на користь лише йому. -You can close these invalid pull requests and reply to them with these [reply templates](reply-templates.md#closing-invalid-pull-requests). +Ви можете закрити недійсні PR та відповісти на них за допомогою [шаблона](reply-templates.md#closing-invalid-pull-requests). #### Інші вказівки для модераторів на GitHub diff --git a/docs/i18n/ukrainian/reply-templates.md b/docs/i18n/ukrainian/reply-templates.md index ff89332be54..721c36256dd 100644 --- a/docs/i18n/ukrainian/reply-templates.md +++ b/docs/i18n/ukrainian/reply-templates.md @@ -1,19 +1,19 @@ -# Reply Templates +# Шаблони відповідей -These are some of the standard reply templates that you may use while reviewing pull requests and triaging issues/pull requests. +Це шаблони відповідей, які можна використовувати під час розгляду PR/завдань та їх сортування. -> You can make your own saved replies with GitHub's built-in [saved replies](https://github.com/settings/replies/) feature or use the ones below. +> Ви можете створити власний список збережених відповідей за допомогою вбудованої функції [збережених відповідей](https://github.com/settings/replies/) на GitHub або використовувати подані нижче. -## Thank You +## Подяка ```markdown Thank you for your contribution to the page! 👍 We are happy to accept these changes and look forward to future contributions. 🎉 ``` -## Thank you and congrats +## Подяка та вітання -> For thanking and encouraging first-time contributors. +> Подяка та заохочення помічників-початківців. ```markdown Hi @username. Congrats on your first pull request (PR)! 🎉 @@ -22,7 +22,7 @@ Thank you for your contribution to the page! 👍 We are happy to accept these changes and look forward to future contributions. 📝 ``` -## Build Error +## Помилка збірки ```markdown Hey @username @@ -36,9 +36,9 @@ Once you resolve these issues, we will be able to review your PR and merge it. 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 +## Синхронізація розгалуження -> When PR is not up to date with the `main` branch. +> Якщо PR не відповідає даті гілки `main`. ````markdown Hey @username @@ -65,8 +65,8 @@ Once you sync your fork and pass the build, we will be able to review your PR an Feel free to reference the ["Syncing a fork"](https://help.github.com/articles/syncing-a-fork/) article on GitHub for more insight on how to keep your fork up-to-date with the upstream repository. 🔄 ```` -## Merge Conflicts -> When PR has merge conflicts that need to be resolved.¹ +## Конфлікти об’єднання +> Якщо запит має конфлікти об’єднання, які потрібно вирішити.¹ ```markdown Hey @username @@ -82,11 +82,11 @@ If you're not familiar with the merge conflict process, feel free to look over G Also, it's good practice on GitHub to write a brief description of your changes when creating a PR. 📝 ``` -¹ If a first-time-contributor has a merge conflict, maintainers will resolve the conflict for them. +¹ Якщо у новачка виникає конфлікт злиття, то спеціалісти розв’яжуть цю проблему замість нього. -## Duplicate +## Дублікат -> When PR is repetitive or a duplicate. +> Якщо PR повторюється або є дублікатом. ```markdown Hey @username @@ -102,9 +102,9 @@ Thanks again! 😊 If you have any questions, feel free to ask questions on the ["Contributors" category on our forum](https://forum.freecodecamp.org/c/contributors) or [the contributors chat room](https://discord.gg/PRyKn3Vbay). ``` -## Closing Invalid Pull Requests +## Закриття недійсних запитів на злиття -> When PR is invalid. +> Якщо PR недійсний. ```markdown Hey @username @@ -116,7 +116,7 @@ This is a standard message notifying you that we've reviewed your pull request a Thank you and happy coding. ``` -> When PR adds links to external resources. +> Якщо PR містить посилання на зовнішні джерела. ```markdown Thank you for your pull request. @@ -126,7 +126,7 @@ We are closing this pull request. Please suggest links and other details to add If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -## Adding Comment About Newbie Mistakes +## Додавання коментарів про помилки новачків ```markdown Hi there, @@ -146,7 +146,7 @@ Since you are new here, please slow down and read our [contributing guidelines]( 2. Use the correct way to link issues. - Add the issue number only in the description of the PR by updating the `XXXXXX`. Do not just add issue numbers everywhere and anywhere you feel like. + Add the issue number only in the description of the PR by updating the `XXXXXX`. Не додавайте номери завдань будь-де. 4. Keep mentions and review requests to a minimum. @@ -165,9 +165,9 @@ We are happy you are excited to contribute and appreciate you taking the time to Happy Contributing. ``` -## Closing Invalid Issues +## Закриття недійсних завдань -> When an issue relates to the camper's code. +> Якщо завдання стосується коду користувача. ```markdown Thank you for reporting this issue. @@ -179,7 +179,7 @@ If the forum members determine there is nothing wrong with your code, you can re Thank you and happy coding. ``` -> When an issue is duplicate of an earlier issue. +> Якщо завдання повторює вже наявне. ```markdown Thank you for reporting this issue. @@ -189,7 +189,7 @@ This is a standard message notifying you that this issue appears to be very simi If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -> When an issue is fixed in staging. +> Якщо завдання вирішено на проміжній версії. ```markdown Thank you for reporting this issue. @@ -199,9 +199,9 @@ This is a standard message notifying you that the problem you mentioned here is If you think we're wrong in closing this issue, please request for it to be reopened and add further clarification. Thank you and happy coding. ``` -## `first timer only` Issues +## Завдання `first timer only` -> When an issue is deemed to be eligible for first-time code contributors. +> Якщо завдання вважається прийнятним для тих, хто робить внесок до коду вперше. ```markdown Thanks for opening this issue. @@ -221,7 +221,7 @@ Sometimes we may get more than one pull request. We typically accept the most qu Happy contributing. ``` -## Requests for Assignment +## Запити на призначення ```md We typically do not assign issues. Instead, we accept the first pull request that comprehensively solves the issue.