docs: updates portuguese translation in the documentation (#1210)

* docs: <getting started> translate missing snippets
* docs: translate missing snippets
* docs: translate plugins create article
* docs: translate documentation to contribute
* docs: translate contribute core
* docs: translate first-party-plugins
* docs: translate contribute/github-actiosn

docs/pt-br/contribute/core.md

@@ -2,11 +2,11 @@
 
 > Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.
 
-`asdf` core contribution guide.
+guia de contribuição principal `asdf`.
 
-## Initial Setup
+## Configuração inicial
 
-Fork `asdf` on GitHub and/or Git clone the default branch:
+Fork `asdf` no GitHub e/ou Git clone o branch padrão:
 
 ```shell:no-line-numbers
 # clone your fork
@@ -15,31 +15,31 @@ git clone https://github.com/<GITHUB_USER>/asdf.git
 git clone https://github.com/asdf-vm/asdf.git
 ```
 
-The tools for core development are in this repo's `.tool-versions`. If you wish to manage with `asdf` itself, add the plugins:
+As ferramentas para o desenvolvimento do núcleo estão em `.tool-versions` deste repositório.  Se você deseja gerenciar com o próprio `asdf`, adicione os plugins:
 
 ```shell:no-line-numbers
 asdf plugin add bats https://github.com/timgluz/asdf-bats.git
 asdf plugin add shellcheck https://github.com/luizm/asdf-shellcheck.git
 asdf plugin add shfmt https://github.com/luizm/asdf-shfmt.git
 ```
 
-Install the versions to develop `asdf` with:
+Instale as versões para desenvolver `asdf` com:
 
 ```shell:no-line-numbers
 asdf install
 ```
 
-It _may_ be useful to not use `asdf` to manage the tools during development on your local machine as you may need to break functionality which would then break your dev tooling. Here's the raw list of tools:
+_pode_ ser útil não usar `asdf` para gerenciar as ferramentas durante o desenvolvimento em sua máquina local, pois você pode precisar quebrar funcionalidades que, então, quebrariam suas ferramentas de desenvolvimento.  Aqui está a lista bruta de ferramentas:
 
-- [bats-core](https://github.com/bats-core/bats-core): Bash Automated Testing System, for unit testing Bash or POSIX compliant scripts.
-- [shellcheck](https://github.com/koalaman/shellcheck): Static analysis tool for shell scripts.
-- [shfmt](https://github.com/mvdan/sh): A shell parser, formatter, and interpreter with bash support; includes shfmt
+- [bats-core](https://github.com/bats-core/bats-core): Bash Automated Testing System, para testes unitários de scripts compatíveis com Bash ou POSIX.
+- [shellcheck](https://github.com/koalaman/shellcheck): Ferramenta de análise estática para scripts de shell.
+- [shfmt](https://github.com/mvdan/sh): Um analisador, formatador e interpretador de shell com suporte a bash; inclui shfmt
 
-## Development
+## Desenvolvimento
 
-If you want to try out your changes without making change to your installed `asdf`, you can set the `$ASDF_DIR` variable to the path where you cloned the repository, and temporarily prepend the `bin` and `shims` directory of the directory to your path.
+Se você quiser testar suas alterações sem fazer alterações em seu `asdf` instalado, você pode definir a variável `$ASDF_DIR` para o caminho onde você clonou o repositório e anexar temporariamente o diretório `bin` e `shims` do diretório para o seu caminho.
 
-It is best to format, lint and test your code locally before you commit or push to the remote. Use the following scripts/commands:
+É melhor formatar, lint e testar seu código localmente antes de confirmar ou enviar para o controle remoto. Use os seguintes scripts/comandos:
 
 ```shell:no-line-numbers
 # Shellcheck
@@ -56,15 +56,15 @@ bats test/list_commands.bash
 
 ::: tip
 
-**Add tests!** - Tests are **required** for new features and speed up review of bug fixes. Please cover new code paths before you create a Pull Request. See [bats-core documentation](https://bats-core.readthedocs.io/en/stable/index.html)
+ **Adicione testes!** - Os testes são **necessários** para novos recursos e aceleram a revisão de correções de bugs.  Por favor, cubra novos caminhos de código antes de criar um Pull Request.  Consulte [documentação do bats-core](https://bats-core.readthedocs.io/en/stable/index.html)
 
 :::
 
-## Bats Testing
+## Teste de morcego
 
-It is **strongly encouraged** to examine the existing test suite and the [bats-core documentation](https://bats-core.readthedocs.io/en/stable/index.html) before writing tests.
+É **fortemente recomendado** examinar o conjunto de testes existente e a [documentação do bats-core](https://bats-core.readthedocs.io/en/stable/index.html) antes de escrever os testes.
 
-Bats debugging can be difficult at times. Using the TAP output with `-t` flag will enable you to print outputs with the special file descriptor `>&3` during test execution, simplifying debugging. As an example:
+A depuração de morcegos pode ser difícil às vezes. Usar a saída TAP com o sinalizador `-t` permitirá que você imprima saídas com o descritor de arquivo especial `>&3` durante a execução do teste, simplificando a depuração. Como um exemplo:
 
 ```shell
 # test/some_tests.bats
@@ -73,15 +73,15 @@ printf "%s\n" "Will not be printed during bats test/some_tests.bats"
 printf "%s\n" "Will be printed during bats -t test/some_tests.bats" >&3
 ```
 
-This is further documented in bats-core [Printing to the Terminal](https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal).
+Isso está documentado em bats-core [Imprimindo no Terminal](https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal).
 
-## Pull Requests, Releases & Conventional Commits
+## Pull Requests, Releases e Commits Convencionais
 
-`asdf` is using an automated release tool called [Release Please](https://github.com/googleapis/release-please) to automatically bump the [SemVer](https://semver.org/) version and generate the [Changelog](https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md). This information is determined by reading the commit history since the last release.
+O `asdf` está usando uma ferramenta de lançamento automatizada chamada [Release Please](https://github.com/googleapis/release-please) para aumentar automaticamente a versão [SemVer](https://semver.org/) e gerar a [Changelog](https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md).  Essas informações são determinadas lendo o histórico de confirmação desde a última versão.
 
-[Conventional Commit messages](https://www.conventionalcommits.org/) define the format of the Pull Request Title which becomes the commit message format on the default branch. This is enforced with GitHub Action [`amannn/action-semantic-pull-request`](https://github.com/amannn/action-semantic-pull-request).
+[Mensagens de confirmação convencionais](https://www.conventionalcommits.org/) definem o formato do título da solicitação pull que se torna o formato da mensagem de confirmação na ramificação padrão. Isso é aplicado com GitHub Action [`amannn/action-semantic-pull-request`](https://github.com/amannn/action-semantic-pull-request).
 
-Conventional Commit follows this format:
+O Commit Convencional segue este formato:
 
 ```:no-line-numbers
 <type>[optional scope][optional !]: <description>
@@ -94,22 +94,22 @@ docs(website): some change for the website
 feat!: feature with breaking change
 ```
 
-The full list of `<types>` are: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`.
+A lista completa de `<types>` é: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`.
 
-The `!` indicates a breaking change.
+O `!` indica uma mudança de ruptura.
 
 `fix`: will create a new SemVer `patch`
 `feat`: will create a new SemVer `minor`
 `<type>!`: will create a new SemVer `major`
 
-The Pull Request Title must follow this format.
+O título da solicitação pull deve seguir este formato.
 
 ::: tip
 
-Use Conventional Commit message format for your Pull Request Title.
+Use o formato de mensagem de confirmação convencional para seu título de solicitação de pull.
 
 :::
 
-## Docker Images
+## Imagens Docker
 
-The [asdf-alpine](https://github.com/vic/asdf-alpine) and [asdf-ubuntu](https://github.com/vic/asdf-ubuntu) projects are an ongoing effort to provide Dockerized images of some asdf tools. You can use these docker images as base for your development servers, or for running your production apps.
+Os projetos [asdf-alpine](https://github.com/vic/asdf-alpine) e [asdf-ubuntu](https://github.com/vic/asdf-ubuntu) são um esforço contínuo para fornecer imagens de algumas ferramentas asdf.  Você pode usar essas imagens docker como base para seus servidores de desenvolvimento ou para executar seus aplicativos de produção.

docs/pt-br/contribute/documentation.md

@@ -2,11 +2,11 @@
 
 > Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.
 
-Documentation & site contribution guide.
+Documentação e guia de contribuição do site.
 
-## Initial Setup
+## Configuração inicial
 
-Fork `asdf` on GitHub and/or Git clone the default branch:
+Fork `asdf` no GitHub e/ou Git clone o branch padrão:
 
 ```shell:no-line-numbers
 # clone your fork
@@ -15,73 +15,72 @@ git clone https://github.com/<GITHUB_USER>/asdf.git
 git clone https://github.com/asdf-vm/asdf.git
 ```
 
-The tools for Docs site development are managed with `asdf` in the `docs/.tool-versions`. Add the plugins with:
+As ferramentas para desenvolvimento de sites Docs são gerenciadas com `asdf` em `docs/.tool-versions`. Adicione os plugins com:
 
 ```shell:no-line-numbers
 asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs
 ```
 
-Install the tool version(s) with:
+Instale a(s) versão(ões) da ferramenta com:
 
 ```shell:no-line-numbers
 asdf install
 ```
 
-- [Node.js](https://nodejs.org): JavaScript runtime built on Chrome's V8 JavaScript engine.
-
-Install Node.js dependencies from `docs/package.json`:
+- [Node.js](https://nodejs.org): tempo de execução JavaScript criado no mecanismo JavaScript V8 do Chrome.
+- 
+Instale as dependências do Node.js do `docs/package.json`:
 
 ```shell:no-line-numbers
 npm install
 ```
 
-## Development
+## Desenvolvimento
 
-[Vuepress (v2)](https://v2.vuepress.vuejs.org/) is the Static Site Generator (SSG) we use to build the asdf documentation site. It was chosen to replace [Docsify.js](https://docsify.js.org/) as we would like to support an HTML only fallback when users do not have JavaScript available or enabled. This was not possible with Docsify. Other than this, the feature-set is largely the same, with the focus on writing Markdown files with minimal configuration.
+[Vuepress (v2)](https://v2.vuepress.vuejs.org/) é o Static Site Generator (SSG) que usamos para construir o site de documentação do asdf. Foi escolhido para substituir [Docsify.js](https://docsify.js.org/), pois gostaríamos de oferecer suporte a um substituto somente HTML quando os usuários não tiverem JavaScript disponível ou ativado. Isso não era possível com o Docsify. Fora isso, o conjunto de recursos é basicamente o mesmo, com foco em escrever arquivos Markdown com configuração mínima.
 
-`package.json` contains the scripts required for development:
+`package.json` contém os scripts necessários para o desenvolvimento:
 
 @[code json{3-5}](../package.json)
 
-To start the local development server:
+ Para iniciar o servidor de desenvolvimento local:
 
 ```shell:no-line-numbers
 npm run dev
 ```
 
-Format the code before committing:
+Formate o código antes de confirmar:
 
 ```shell:no-line-numbers
 npm run format
 ```
 
-## Pull Requests, Releases & Conventional Commits
+## Pull Requests, Releases e Commits Convencionais
 
-`asdf` is using an automated release pipeline which relies on Conventional Commits in PR titles. Detailed documentation found in the [core contribution guide](./core.md).
+`asdf` está usando um pipeline de lançamento automatizado que depende de Commits Convencionais em títulos de PR. Documentação detalhada encontrada no [guia de contribuição principal](./core.md).
 
-When creating a PR for documentation changes please make the PR title with the Conventional Commit type `docs` in the format `docs: <description>`.
+Ao criar um PR para alterações na documentação, por favor, faça o título do PR com o tipo de Commit Convencional `docs` no formato `docs: <description>`.
 
 ## Vuepress
 
-Configuration of the site is contained within a few JavaScript files with JS Objects used to represent the config. They are:
+A configuração do site está contida em alguns arquivos JavaScript com objetos JS usados para representar a configuração. Eles estão:
 
-- `docs/.vuepress/config.js`: the root config file for the site. Read the [Vuepress documentation](https://v2.vuepress.vuejs.org/guide/configuration.html#config-file) for it's spec.
+- `docs/.vuepress/config.js`: o arquivo de configuração raiz do site. Leia a [documentação do Vuepress](https://v2.vuepress.vuejs.org/guide/configuration.html#config-file) para obter as especificações.
 
-To simplify the root config, the larger JS Objects representing the _navbar_ and _sidebar_ configuration have been extracted and separated by their locale. See both in:
+Para simplificar a configuração raiz, os objetos JS maiores que representam a configuração _navbar_ e _sidebar_ foram extraídos e separados por sua localidade. Veja os dois em:
 
 - `docs/.vuepress/navbar.js`
 - `docs/.vuepress/sidebar.js`
 
-With the official documentation for these configs living in the [Default Theme Reference](https://v2.vuepress.vuejs.org/reference/default-theme/config.html#locale-config).
+Com a documentação oficial para essas configurações vivendo na [Referência de tema padrão](https://v2.vuepress.vuejs.org/reference/default-theme/config.html#locale-config).
 
 ## I18n
 
-Vuepress has first-class support for internationalization. The
-root config `docs/.vuepress/config.js` defines the supported locales with their URL, title in the selection dropdown menu and navbar/sidebar configs references.
+Vuepress tem suporte de primeira classe para internacionalização. O root config `docs/.vuepress/config.js` define os locais suportados com sua URL, título no menu suspenso de seleção e referências de configurações navbar/sidebar.
 
-The navbar/sidebar configs are captured in the aforementioned config files, separated by locale and exported individually.
+As configurações da barra de navegação/barra lateral são capturadas nos arquivos de configuração mencionados acima, separadas por localidade e exportadas individualmente.
 
-The markdown content for each locale must fall under a folder with the same name as the keys for `locales` in the root config. That is:
+O conteúdo de markdown para cada localidade deve estar em uma pasta com o mesmo nome das chaves para `locales` na configuração raiz.  Isso é:
 
 ```js
 {
@@ -103,7 +102,7 @@ The markdown content for each locale must fall under a folder with the same name
 }
 ```
 
-`/pt-BR/` will require the same set of markdown files located under `docs/pt-BR/`, like so:
+`/pt-BR/` exigirá o mesmo conjunto de arquivos markdown localizados em `docs/pt-BR/`, assim:
 
 ```shell:no-line-numbers
 docs
@@ -118,4 +117,4 @@ docs
       └─ README.md
 ```
 
-The [official Vuepress i18n documentation](https://v2.vuepress.vuejs.org/guide/i18n.html#site-i18n-config) goes into more detail.
+A [documentação oficial do Vuepress i18n](https://v2.vuepress.vuejs.org/guide/i18n.html#site-i18n-config) entra em mais detalhes.

docs/pt-br/contribute/first-party-plugins.md

@@ -2,14 +2,14 @@
 
 > Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.
 
-The asdf core team has authored some plugins relevant to their daily work life. Help is always welcome in maintaining and improving these plugins. See the associated repo for each linked below:
+A equipe principal do asdf criou alguns plugins relevantes para sua vida profissional diária. A ajuda é sempre bem-vinda na manutenção e melhoria desses plugins. Veja o repositório associado para cada link abaixo:
 
 - [Elixir](https://github.com/asdf-vm/asdf-elixir)
 - [Erlang](https://github.com/asdf-vm/asdf-erlang)
 - [Node.js](https://github.com/asdf-vm/asdf-nodejs)
 - [Ruby](https://github.com/asdf-vm/asdf-ruby)
 
-For community plugins, see:
+Para plugins da comunidade, consulte:
 
 - [`asdf-community` organisation](https://github.com/asdf-community): A collaborative, community-driven project for long-term maintenance of `asdf` plugins.
 - [`asdf-plugins` shortname repo](https://github.com/asdf-vm/asdf-plugins): Short-name list used by `asdf` core to lookup popular `asdf` plugins.

docs/pt-br/contribute/github-actions.md

@@ -2,4 +2,4 @@
 
 > Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.
 
-Thanks for your interest, please see the [asdf actions repo](https://github.com/asdf-vm/actions) for their existing Issues, conversations and Contributing Guidelines.
+Obrigado pelo seu interesse, consulte o [repositório de ações asdf](https://github.com/asdf-vm/actions) para ver os problemas, conversas e diretrizes de contribuição existentes.

docs/pt-br/guide/getting-started.md

@@ -148,42 +148,42 @@ O auto completar é configurado automaticamente durante a instalação do pacote
 
 ::: details Elvish & Git
 
-Add `asdf.elv` to your `~/.config/elvish/rc.elv` with:
+Adicione `asdf.elv` ao `~/.config/elvish/rc.elv` através do comando:
 
 ```shell:no-line-numbers
 mkdir -p ~/.config/elvish/lib; ln -s ~/.asdf/asdf.elv ~/.config/elvish/lib/asdf.elv
 echo "\n"'use asdf _asdf; var asdf~ = $_asdf:asdf~' >> ~/.config/elvish/rc.elv
 echo "\n"'set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~' >> ~/.config/elvish/rc.elv
 ```
 
-Completions are automatically configured.
+Ao concluir atualizará automaticamente
 
 :::
 
 ::: details Elvish & Homebrew
 
-Add `asdf.elv` to your `~/.config/elvish/rc.elv` with:
+Adicione `asdf.elv` ao `~/.config/elvish/rc.elv` através do comando:
 
 ```shell:no-line-numbers
 mkdir -p ~/.config/elvish/lib; ln -s (brew --prefix asdf)/libexec/asdf.elv ~/.config/elvish/lib/asdf.elv
 echo "\n"'use asdf _asdf; var asdf~ = $_asdf:asdf~' >> ~/.config/elvish/rc.elv
 echo "\n"'set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~' >> ~/.config/elvish/rc.elv
 ```
 
-Completions are automatically configured.
+Ao concluir atualizará automaticamente
 :::
 
 ::: details Elvish & Pacman
 
-Add `asdf.elv` to your `~/.config/elvish/rc.elv` with:
+Adicione `asdf.elv` ao `~/.config/elvish/rc.elv` através do comando:
 
 ```shell:no-line-numbers
 mkdir -p ~/.config/elvish/lib; ln -s /opt/asdf-vm/asdf.elv ~/.config/elvish/lib/asdf.elv
 echo "\n"'use asdf _asdf; var asdf~ = $_asdf:asdf~' >> ~/.config/elvish/rc.elv
 echo "\n"'set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~' >> ~/.config/elvish/rc.elv
 ```
 
-Completions are automatically configured.
+Ao concluir atualizará automaticamente
 :::
 
 ::: details ZSH & Git

docs/pt-br/manage/commands.md

@@ -2,6 +2,6 @@
 
 > Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.
 
-The list of all commands available in `asdf`. This list is the `asdf help` command text.
+A lista de todos os comandos disponíveis em `asdf`. Esta lista é o texto do comando `asdf help`.
 
 @[code](../../../help.txt)