Adding Portuguese version for Code Standards, Code, and Documentation. (#2343)

Author: fellyph

packages/docs/site/docs/main/contributing/documentation.md

@@ -21,7 +21,7 @@ If you are familiar with markdown, you can [fork](https://docs.github.com/en/pul
 The process of creating a branch to open new PRs with translated pages on the [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) repository is the same than contributing to other WordPress repositories such as gutenberg:
 https://developer.wordpress.org/block-editor/contributors/code/git-workflow/
 
-The documentation files (`.md` files) are stored in Playground's GitHub repository, [under `/packages/docs/site/docs`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/docs).
+The documentation files (`.md` files) are stored in Playground's GitHub repository, [under `/packages/docs/site/docs`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/docs) for English and [`/packages/docs/site/i18n`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/i18n) for other languages.
 
 ### Edit in the browser
 

packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributing/_category_.json

@@ -0,0 +1,3 @@
+{
+	"label": "Contribuindo"
+}

packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributing/code.md

@@ -0,0 +1,186 @@
+---
+slug: /contributing/code
+---
+
+<!--
+# Code contributions
+-->
+
+# Contribuições de código
+
+<!--
+Like all WordPress projects, Playground uses GitHub to manage code and track issues. The main repository is at [https://github.com/WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) and the Playground Tools repository is at [https://github.com/WordPress/playground-tools/](https://github.com/WordPress/playground-tools/).
+-->
+
+Como todos os projetos WordPress, o Playground usa o GitHub para gerenciar o código e rastrear problemas. O repositório principal está em [https://github.com/WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) e o repositório de Ferramentas do Playground está em [https://github.com/WordPress/playground-tools/](https://github.com/WordPress/playground-tools/).
+
+<!--
+:::info Contribute to Playground Tools
+
+This guide includes links to the main repository, but all the steps and options apply for both. If you're interested in the plugins or local development tools—start there.
+
+:::
+-->
+
+:::info Contribua para as Ferramentas do Playground
+
+Este guia inclui links para o repositório principal, mas todos os passos e opções se aplicam a ambos. Se você estiver interessado nos plugins ou nas ferramentas de desenvolvimento local, comece por aí.
+
+:::
+
+<!--
+Browse [the list of open issues](https://github.com/wordpress/wordpress-playground/issues) to find what to work on. The [`Good First Issue`](https://github.com/wordpress/wordpress-playground/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22) label is a recommended starting point for first-time contributors.
+-->
+
+Navegue pela [lista de issues abertas](https://github.com/wordpress/wordpress-playground/issues) para encontrar no que trabalhar. A etiqueta [`Good First Issue`](https://github.com/wordpress/wordpress-playground/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22) é um ponto de partida recomendado para contribuidores de primeira viagem.
+
+<!--
+Be sure to review the following resources before you begin:
+-->
+
+Certifique-se de revisar os seguintes recursos antes de começar:
+
+<!--
+-   [Coding principles](/contributing/coding-standards)
+-   [Architecture](/developers/architecture)
+-   [Vision and Philosophy](https://github.com/WordPress/wordpress-playground/issues/472)
+-   [WordPress Playground Roadmap](https://github.com/WordPress/wordpress-playground/issues/525)
+-->
+
+-   [Princípios de codificação](/contributing/coding-standards)
+-   [Arquitetura](/developers/architecture)
+-   [Visão e Filosofia](https://github.com/WordPress/wordpress-playground/issues/472)
+-   [Roteiro do WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/525)
+
+<!--
+## Contribute Pull Requests
+-->
+
+## Contribuir com Pull Requests
+
+<!--
+[Fork the Playground repository](https://github.com/WordPress/wordpress-playground/fork) and clone it to your local machine. To do that, copy and paste these commands into your terminal:
+-->
+
+[Faça um fork do repositório do Playground](https://github.com/WordPress/wordpress-playground/fork) e clone-o para sua máquina local. Para fazer isso, copie e cole estes comandos em seu terminal:
+
+```bash
+git clone -b trunk --single-branch --depth 1 --recurse-submodules
+
+# substitua `SEU-NOME-DE-USUARIO-GITHUB` pelo seu nome de usuário do GitHub:
+[email protected]:SEU-NOME-DE-USUARIO-GITHUB/wordpress-playground.git
+cd wordpress-playground
+npm install
+```
+
+<!--
+Create a branch, make changes, and test it locally by running the following command:
+-->
+
+Crie uma branch, faça as alterações e teste-a localmente executando o seguinte comando:
+
+```bash
+npm run dev
+```
+
+<!--
+Playground will open in a new browser tab and refresh automatically with each change.
+-->
+
+O Playground será aberto em uma nova aba do navegador e será atualizado automaticamente a cada alteração.
+
+<!--
+When your'e ready, commit the changes and submit a Pull Request.
+-->
+
+Quando estiver pronto, faça o commit das alterações e envie um Pull Request.
+
+<!--
+:::info Formatting
+
+We handle code formatting and linting automatically. Relax, type away, and let the machines do the work.
+
+:::
+-->
+
+:::info Formatação
+
+Nós lidamos com a formatação de código e o linting automaticamente. Relaxe, digite e deixe as máquinas fazerem o trabalho.
+
+:::
+
+<!--
+### Running a local Multisite
+-->
+
+### Executando um Multisite local
+
+<!--
+WordPress Multisite has a few [restrictions when run locally](https://developer.wordpress.org/advanced-administration/multisite/prepare-network/#restrictions). If you plan to test a Multisite network using Playground's `enableMultisite` step, make sure you either change `wp-now`'s default port or set a local test domain running via HTTPS.
+-->
+
+O WordPress Multisite tem algumas [restrições quando executado localmente](https://developer.wordpress.org/advanced-administration/multisite/prepare-network/#restrictions). Se você planeja testar uma rede Multisite usando o passo `enableMultisite` do Playground, certifique-se de alterar a porta padrão do `wp-now` ou definir um domínio de teste local executado via HTTPS.
+
+<!--
+To change `wp-now`'s default port to the one supported by WordPress Multisite, run it using the `--port=80` flag:
+-->
+
+Para alterar a porta padrão do `wp-now` para a suportada pelo WordPress Multisite, execute-o usando a flag `--port=80`:
+
+```bash
+npx @wp-now/wp-now start --port=80
+```
+
+<!--
+There are a few ways to set up a local test domain, including editing your `hosts` file. If you're unsure how to do that, we suggest installing [Laravel Valet](https://laravel.com/docs/11.x/valet) and then running the following command:
+-->
+
+Existem algumas maneiras de configurar um domínio de teste local, incluindo a edição do seu arquivo `hosts`. Se você não tiver certeza de como fazer isso, sugerimos instalar o [Laravel Valet](https://laravel.com/docs/11.x/valet) e, em seguida, executar o seguinte comando:
+
+```bash
+valet proxy playground.test http://127.0.0.1:5400 --secure
+```
+
+<!--
+Your dev server is now available on https://playground.test.
+-->
+
+Seu servidor de desenvolvimento agora está disponível em https://playground.test.
+
+<!--
+## Debugging
+-->
+
+## Depuração
+
+<!--
+### Use VS Code and Chrome
+-->
+
+### Use o VS Code e o Chrome
+
+<!--
+If you're using VS Code and have Chrome installed, you can debug Playground in the code editor:
+-->
+
+Se você estiver usando o VS Code e tiver o Chrome instalado, poderá depurar o Playground no editor de código:
+
+<!--
+-   Open the project folder in VS Code.
+-   Select Run > Start Debugging from the main menu or press `F5`/`fn`+`F5`.
+-->
+
+-   Abra a pasta do projeto no VS Code.
+-   Selecione Executar > Iniciar Depuração no menu principal ou pressione `F5`/`fn`+`F5`.
+
+<!--
+### Debugging PHP
+-->
+
+### Depurando o PHP
+
+<!--
+Playground logs PHP errors in the browser console after every PHP request.
+-->
+
+O Playground registra os erros do PHP no console do navegador após cada solicitação PHP.

packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributing/coding-standards.md

@@ -4,95 +4,115 @@ slug: /contributing/coding-standards
 
 <!--
 # Coding principles
-
-## Error messages
-
-A good error message tells the user what to do next. Any ambiguity in errors thrown by Playground public APIs will prompt the developers to open issues.
 -->
 
 # Princípios de codificação
 
+<!--
+## Error messages
+-->
+
 ## Mensagens de erro
 
-Uma boa mensagem de erro informa ao usuário o que fazer a seguir. Qualquer ambiguidade nos erros lançados pelas APIs públicas do Playground levará os desenvolvedores a abrir issues.
+<!--
+A good error message informs the user of the following steps to take. Any ambiguity in errors thrown by Playground public APIs will prompt the developers to open issues.
+-->
+
+Uma boa mensagem de erro informa o usuário sobre os próximos passos a serem seguidos. Qualquer ambiguidade nos erros lançados pelas APIs públicas do Playground levará os desenvolvedores a abrir issues.
 
 <!--
 Consider a network error, for example—can we infer the type of error and display a relevant message summarizing the next steps?
+-->
+
+Considere um erro de rede, por exemplo: podemos inferir o tipo de erro e exibir uma mensagem relevante resumindo os próximos passos?
 
+<!--
 -   **Network error**: "Your internet connection twitched. Try to reload the page.
 -   **404**: "Could not find the file".
 -   **403**: "The server blocked access to the file".
--   **CORS**: clarify it's a browser security feature and add a link to a detailed explanation (on MDN or another reliable source). Suggest the user move their file somewhere else, like raw.githubusercontent.com, and link to a resource explaining how to set up CORS headers on their servers.
+-   **CORS**: clarify it's a browser security feature and add a link to a detailed explanation (on MDN or another reliable source). Suggest the user move their file somewhere else, like `raw.githubusercontent.com`, and link to a resource explaining how to set up CORS headers on their servers.
 -->
 
-Considere um erro de rede, por exemplo: podemos inferir o tipo de erro e exibir uma mensagem relevante resumindo os próximos passos?
-
 -   **Erro de rede**: "Sua conexão com a internet oscilou. Tente recarregar a página."
 -   **404**: "Não foi possível encontrar o arquivo".
 -   **403**: "O servidor bloqueou o acesso ao arquivo".
--   **CORS**: esclareça que é um recurso de segurança do navegador e adicione um link para uma explicação detalhada (no MDN ou outra fonte confiável). Sugira que o usuário mova o arquivo para outro lugar, como raw.githubusercontent.com, e crie um link para um recurso que explique como configurar os cabeçalhos CORS em seus servidores.
+-   **CORS**: esclareça que é um recurso de segurança do navegador e adicione um link para uma explicação detalhada (no MDN ou outra fonte confiável). Sugira que o usuário mova o arquivo para outro lugar, como `raw.githubusercontent.com`, e adicione um link para um recurso explicando como configurar os cabeçalhos CORS em seus servidores.
 
 <!--
 We handle code formatting and linting automatically. Relax, type away, and let the machines do the work.
 -->
 
-Lidamos com a formatação e o linting do código automaticamente. Relaxe, digite e deixe as máquinas fazerem o trabalho.
+Nós lidamos com a formatação de código e o linting automaticamente. Relaxe, digite e deixe as máquinas fazerem o trabalho.
 
 <!--
 ## Public API
-
-Playground aims to keep the narrowest possible API scope.
 -->
 
 ## API Pública
 
+<!--
+Playground aims to keep the narrowest possible API scope.
+-->
+
 O Playground visa manter o escopo de API o mais restrito possível.
 
 <!--
 Public APIs are easy to add and hard to remove. It only takes one PR to introduce a new API, but it may take a thousand to remove it, especially if other projects have already consumed it.
+-->
+
+APIs públicas são fáceis de adicionar e difíceis de remover. Basta um PR para introduzir uma nova API, mas pode ser necessário mil para removê-la, especialmente se outros projetos já a consumiram.
 
+<!--
 -   Don't expose unnecessary functions, classes, constants, or other components.
 -->
 
-APIs públicas são fáceis de adicionar e difíceis de remover. Leva apenas um PR para introduzir uma nova API, mas pode levar mil para removê-la, especialmente se outros projetos já a consumiram.
-
 -   Não exponha funções, classes, constantes ou outros componentes desnecessários.
 
 <!--
 ## Blueprints
-
-Blueprints are the primary way to interact with Playground. These JSON files describe a set of steps that Playground executes in order.
 -->
 
 ## Blueprints
 
+<!--
+Blueprints are the primary way to interact with Playground. These JSON files describe a set of steps that Playground executes in order.
+-->
+
 Blueprints são a principal forma de interagir com o Playground. Estes arquivos JSON descrevem um conjunto de passos que o Playground executa em ordem.
 
 <!--
 ### Guidelines
+-->
 
+### Diretrizes
+
+<!--
 Blueprint steps should be **concise and focused**. They should do one thing and do it well.
+-->
+
+Os passos de um Blueprint devem ser **concisos e focados**. Devem fazer uma coisa e fazê-la bem.
 
+<!--
 -   If you need to create a new step, try refactoring an existing one first.
 -   If that's not enough, ensure the new step delivers a new capability. Don't replicate the functionality of existing steps.
 -   Assume the step would be called more than once.
 -   Assume it would run in a specific order.
 -   Add unit tests to verify that.
 -->
 
-### Diretrizes
-
-Os passos do Blueprint devem ser **concisos e focados**. Eles devem fazer uma coisa e fazê-la bem.
-
--   Se você precisar criar um novo passo, tente refatorar um existente primeiro.
--   Se isso não for suficiente, garanta que o novo passo entregue uma nova capacidade. Não replique a funcionalidade de passos existentes.
--   Assuma que o passo será chamado mais de uma vez.
--   Assuma que ele será executado em uma ordem específica.
+-   Se precisar criar um novo passo, tente refatorar um existente primeiro.
+-   Se isso não for suficiente, garanta que o novo passo ofereça uma nova capacidade. Não replique a funcionalidade de passos existentes.
+-   Suponha que o passo será chamado mais de uma vez.
+-   Suponha que ele será executado em uma ordem específica.
 -   Adicione testes unitários para verificar isso.
 
 <!--
 Blueprints should be **intuitive and straightforward**.
+-->
+
+Blueprints devem ser **intuitivos e diretos**.
 
+<!--
 -   Don't require arguments that can be optional.
 -   Use plain argument. For example, `slug` instead of `path`.
 -   Define constants in virtual JSON files—don't modify PHP files.
@@ -101,11 +121,9 @@ Blueprints should be **intuitive and straightforward**.
 -   Provide a usage example in the doc string. It's automatically reflected in the docs.
 -->
 
-Blueprints devem ser **intuitivos e diretos**.
-
--   Não exija argumentos que podem ser opcionais.
+-   Não exija argumentos que possam ser opcionais.
 -   Use argumentos simples. Por exemplo, `slug` em vez de `path`.
--   Defina constantes em arquivos JSON virtuais — não modifique arquivos PHP.
+-   Defina constantes em arquivos JSON virtuais—não modifique arquivos PHP.
 -   Defina um tipo TypeScript para o Blueprint. É assim que o Playground gera seu esquema JSON.
 -   Escreva uma função para lidar com um passo do Blueprint. Aceite o argumento do tipo que você definiu.
--   Forneça um exemplo de uso na docstring. Ele é refletido automaticamente na documentação.
+-   Forneça um exemplo de uso na doc string. Ele é refletido automaticamente nos documentos.