Merge branch 'master' of github.com:vuejs-br/docs-next

Author: arthurbergmz

README.md

@@ -1,33 +1,47 @@
-# v3.vuejs.org
+# vuejs-br/docs-next
 
-This site is built with [VuePress](https://vuepress.vuejs.org/). Site content is written in Markdown format located in `src`.
+Este é o repositório oficial da tradução para português brasileiro da documentação do [Vue.js](https://v3.vuejs.org/). Este _site_ é produzido com [VuePress](https://vuepress.vuejs.org/). Todo o conteúdo é escrito em Markdown e os arquivos podem ser encontrados em `src`.
 
-## Writing
+> Nota da equipe de tradução: o trabalho nesta nova versão da documentação ainda está em andamento, portanto muitos conteúdos estão em seu estado original (em inglês). Ajuda é muito bem-vinda!
 
-See the [Vue Docs Writing Guide](https://v3.vuejs.org/guide/writing-guide.html) for our rules and recommendations on writing and maintaining documentation.
+## Traduzindo
 
-> The docs are in beta: The team is currently in the midst of changes and we are not ready for additional contributions yet. All content is subject to change. If you see a problem that you would like to bring to our attention, please [create an issue](https://github.com/vuejs/docs-next/issues/new) and we will get to it when we can. You may want to wait until the content is finalized, though.
+Se você quer participar da tradução, ajudando a traduzir conteúdos que ainda permanecem em inglês e/ou ajudando a revisar conteúdos já traduzidos, sinta-se em casa. Para entender como tudo funciona e saber por onde começar, leia nosso guia de [Contribuição com a Documentação](https://vuejsbr-docs-next.netlify.app/guide/contributing/translations.html).
 
-## Developing
+> O _workflow_ para a realização da tradução está detalhadamente descrito em [Como colaborar com a versão em português?](https://vuejsbr-docs-next.netlify.app/guide/contributing/translations.html#como-colaborar-com-a-versao-em-portugues). Ler é o primeiro passo para todo colaborador em potencial.
 
-1. Clone repository
+## Escrevendo
+
+Se você quer participar ajudando na construção e atualização da documentação principal (em inglês), veja o [Guia de Escrita](https://v3.vuejs.org/guide/writing-guide.html) para regras e recomendações sobre escrever e manter a documentação.
+
+> Neste momento a documentação principal (em inglês) está em beta: o time está atualmente no meio de muitas mudanças e não está recebendo contribuições. Todo o conteúdo está sujeito a mudanças. Se você viu algo que gostaria de trazer à atenção do time, [crie uma _issue_](https://github.com/vuejs/docs-next/issues/new) e todos farão o possível para analisar. No entanto, provavelmente você precisará esperar até que todo o conteúdo esteja finalizado.
+
+## Desenvolvendo
+
+Se deseja executar o projeto localmente, seja para contribuir com a documentação ou seja para olhar como as coisas funcionam, sigua os passos a seguir.
+
+1. Clone este repositório:
 
 ```bash
-git clone git@github.com:vuejs/docs-next.git
+git clone https://github.com/vuejs-br/docs-next.git
 ```
 
-2. Install dependencies
+2. Instale as dependências:
 
 ```bash
 yarn # or npm install
 ```
 
-3. Start local development environment
+3. Inicie um ambiente de desenvolvimento local:
 
 ```bash
 yarn serve # or npm run serve
 ```
 
-## Deploying
+## Publicando
+
+[![Netlify Status](https://api.netlify.com/api/v1/badges/35e551aa-2430-4ca9-aae6-72ba49d7ffec/deploy-status)](https://app.netlify.com/sites/vuejsbr-docs-next/deploys)
+
+O _site_ é automaticamente publicado quando _commits_ chegam em `master`, via [Netlify](https://www.netlify.com/).
 
-The site is automatically deployed when commits land in `master`, via [Netlify](https://www.netlify.com/).
+O processo é disparado somente por um grupo de contribuidores selecionados para isso, a fim de manter a organização do projeto. Colabore apenas enviando _pull requests_ e, depois de revisados e aceitos, serão mesclados em `master` pela equipe. Ou seja, não se preocupe com a publicação, o _deploy_ é automático.

src/.vuepress/components/common/vuemastery-video-modal.vue

@@ -3,7 +3,7 @@
     <div ref="modal" class="modal" :class="{ open: isOpen }">
       <div class="video-space" style="padding: 56.25% 0 0 0; position: relative;">
         <iframe
-          src="https://player.vimeo.com/video/247494684?dnt=1"
+          src="https://player.vimeo.com/video/455611549?dnt=1"
           style="height: 100%; left: 0; position: absolute; top: 0; width: 100%; margin: 0"
           frameborder="0"
           webkitallowfullscreen
@@ -23,7 +23,7 @@
         >Vue Mastery</a>.
         Watch Vue Mastery’s free
         <a
-          href="https://www.vuemastery.com/courses/intro-to-vue-js/vue-instance/"
+          href="https://www.vuemastery.com/courses/intro-to-vue-3/intro-to-vue3"
           target="_blank"
           rel="sponsored noopener"
           title="Vue.js Courses on Vue Mastery"

src/guide/component-slots.md

@@ -252,7 +252,7 @@ We might want to replace the slot to customize it on parent component:
 ```html
 <todo-list>
   <i class="fas fa-check"></i>
-  <span class="green">{{ item }}<span>
+  <span class="green">{{ item }}</span>
 </todo-list>
 ```
 
@@ -279,7 +279,7 @@ Attributes bound to a `<slot>` element are called **slot props**. Now, in the pa
 </todo-list>
 ```
 
-<img src="/images/scoped-slot.png" width="611" height="auto" style="display: block; margin: 0 auto; max-width: 100%;" loading="lazy" alt="Scoped slot diagram"> 
+<img src="/images/scoped-slot.png" width="611" height="auto" style="display: block; margin: 0 auto; max-width: 100%;" loading="lazy" alt="Scoped slot diagram">
 
 In this example, we've chosen to name the object containing all our slot props `slotProps`, but you can use any name you like.
 
@@ -348,7 +348,7 @@ That means the value of `v-slot` can actually accept any valid JavaScript expres
 ```html
 <todo-list v-slot="{ item }">
   <i class="fas fa-check"></i>
-  <span class="green">{{ item }}<span>
+  <span class="green">{{ item }}</span>
 </todo-list>
 ```
 
@@ -366,7 +366,7 @@ You can even define fallbacks, to be used in case a slot prop is undefined:
 ```html
 <todo-list v-slot="{ item = 'Placeholder' }">
   <i class="fas fa-check"></i>
-  <span class="green">{{ item }}<span>
+  <span class="green">{{ item }}</span>
 </todo-list>
 ```
 
@@ -410,7 +410,7 @@ However, just as with other directives, the shorthand is only available when an
 
 <todo-list #="{ item }">
   <i class="fas fa-check"></i>
-  <span class="green">{{ item }}<span>
+  <span class="green">{{ item }}</span>
 </todo-list>
 ```
 
@@ -419,6 +419,6 @@ Instead, you must always specify the name of the slot if you wish to use the sho
 ```html
 <todo-list #default="{ item }">
   <i class="fas fa-check"></i>
-  <span class="green">{{ item }}<span>
+  <span class="green">{{ item }}</span>
 </todo-list>
 ```

src/guide/contributing/translations.md

@@ -12,7 +12,7 @@ Digamos que você fale Esperanto e quer saber quais iniciativas de tradução j
 
 ### Como colaborar com a versão em português?
 
-Mas se você está aqui, deve ser por falar português! Neste caso, para nos ajudar diretamente, intereja com a equipe em [nosso repositório de tradução](https://github.com/vuejs-br/docs-next).
+Mas se você está aqui, deve ser por falar português! Neste caso, para nos ajudar diretamente, interaja com a equipe em [nosso repositório de tradução](https://github.com/vuejs-br/docs-next).
 
 ::: tip
 Problemas pontuais em traduções já realizadas, como erros de grafia pequenos ou frases confusas, podem ser reportados apenas [criando uma _issue_](https://github.com/vuejs-br/docs-next/issues/new). Deixe claro sobre qual página se refere o problema e, preferencialmente, ofereça uma sugestão para a correção desejada.
@@ -40,7 +40,7 @@ Para uma documentação padronizada e de qualidade, seguimos alguns princípios
 
 - Traduzir os comentários dos códigos-fonte, sejam eles _inline_ `//` ou de múltiplas-linhas `/* */`;
 - Traduzir textos informativos dos códigos-fonte, por exemplo: `<div id="level-1">Nível 1</div>`;
-- Seguir maiúsculas e minúsculas conforme o original em inglês sempre que possível, exceto quando existir claramente uma regra de notaçãoo diferente na língua portuguesa;
+- Seguir maiúsculas e minúsculas conforme o original em inglês sempre que possível, exceto quando existir claramente uma regra de notação diferente na língua portuguesa;
 - Usar itálico em expressões sem tradução (por exemplo, _view layer_), exceto em nomes próprios grafados em maiúsculas (por exemplo, Internet);
 - Utilizar alguma extensão de ortografia e gramática vinculada ao seu editor de código, para evitar que erros deste tipo sejam submetidos;
 - Quando for submeter seu trabalho, sempre escreva a descrição do _commit_ em inglês (recomendação do _core team_).
@@ -108,11 +108,11 @@ Atualmente, recomenda-se que os termos a seguir sejam mantidos em inglês, inclu
 
 **Traduzir mas manter o original**
 
-Em alguns casos, para facilitar a compressão tanta por desenvolvedores menos experiências quanto mais experiências, alguns termos podem ser traduzidos mas com o original em inglês entre parênteses, por exemplo:
+Em alguns casos, para facilitar a compreensão, tanto por desenvolvedores menos experientes quanto pelos mais experientes, alguns termos podem ser traduzidos mas com o original em inglês entre parênteses, por exemplo:
 
 > A biblioteca principal é focada exclusivamente na camada visual (_view layer_) das aplicações.
 
-Na dúvida, discuta na _issue_ correspondete ao arquivo que estiver trabalhando, para trocar opiniões com os mantenedores.
+Na dúvida, discuta na _issue_ correspondente ao arquivo que estiver trabalhando, para trocar opiniões com os mantenedores.
 
 ## Como escrever melhor?
 

src/guide/events.md

@@ -1,7 +1,5 @@
 # Event Handling
 
-<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-user-events?friend=vuejs" target="_blank" rel="sponsored noopener" title="Learn how to handle events on Vue School">Learn how to handle events in a free Vue School lesson</a></div>
-
 ## Listening to Events
 
 We can use the `v-on` directive, which we typically shorten to the `@` symbol, to listen to DOM events and run some JavaScript when they're triggered. The usage would be `v-on:click="methodName"` or with the shortcut, `@click="methodName"`