vuejs-br/docs-next

Documentação do Vue 3 traduzida para Português Brasileiro (WIP).

docs-next's Issues

Traduzir "guide/component-custom-events.md"

Traduzir "api/composition-api.md"

Link para o arquivo: api/composition-api

Traduzir "cookbook/index.md"

Link para o arquivo: cookbook/index

Como podemos automatizar coisas e facilitar o processo?

Inspirado por indagações em https://github.com/vuejs-br/br.vuejs.org/issues/283, temos que refletir/decidir algumas coisas:

• 1. Automatizar a criação de issues para itens ainda não traduzidos, talvez com um bot varrendo todos os .md dentro de src, mas levando em conta as issues já criadas manualmente para não gerar duplicações... Seria a melhor abordagem?
• 2. Este repositório (assim como seu upstream) é um projeto completamente novo em VuePress (a documentação antiga era em Hexo). Diversas diferenças estruturais à parte, ambos são baseados em Markdown. Então, na teoria, poderíamos aproveitar traduções anteriores. Mas... O próprio core team falou para as equipes de tradução tomarem cuidado, pois há muitas diferenças (às vezes apenas em alguns parágrafos dentro de um arquivo que parece ser idêntico a um antigo). Como fazer isso de forma automática? Alguma ideia git diff poderia ajudar?
• 3. Como vamos lidar com o deploy lá na frente? Nosso subdomínio br.vuejs.org está integrado com Netlify ao repositório vuejs-br/br.vuejs.org. No futuro, quando terminarmos o trabalho, poderemos arquivar o repositório antigo e tornar este o principal (talvez renomeando)... Ou mover este para lá como um novo branch e depois renomear os branches lá... De qualquer forma, não será muito complicado pois o core team pretende manter o Netlify, incluindo os subdomínios já mapeados como o nosso. Mas precisaremos definir como esta migração ocorrerá. E em que momento.
• 4. Mais urgente agora: como vamos lidar com o deploy durante a tradução? É muito legal poder acompanhar um alpha, depois um beta, depois um RC de nosso trabalho de tradução. Vamos manter cada contribuidor testando só localmente? Ou vamos subir este repositório em um domínio temporário (talvez do Netlify mesmo) para acompanhar o andamento "ao vivo"?
• 5. Aproveitando ou não trechos da tradução anterior, tem uma porrada de arquivos para serem traduzidos/revisados. É quase todo o trabalho de anos atrás acontecendo novamente! Apesar de cansativo, acreditamos fortemente que a documentação em português é um dos fatores que tornaram nosso querido framework tão bem visto no Brasil (e isto, claro, se reflete em mais vagas de emprego, mais visibilidade em eventos, etc). Como vamos instigar mais desenvolvedores brasileiros a colaborarem com este novo processo de tradução, para podermos entregar tudo o mais rápido possível e nos aproximarmos de comunidades como a chinesa, a francesa e a russa, que possuem documentação quase sempre sincronizada com a principal?

Vamos trocar ideias nesta issue para definir tais questões e eventualmente levantar outras.

Traduzir "coc/index.md"

Link para o arquivo: coc/index

Traduzir "guide/component-template-refs.md"

Traduzir "guide/template-syntax.md"

Traduzir "api/computed-watch-api.md"

Link para o arquivo: api/computed-watch-api

Traduzir "guide/introduction.md"

Traduzir "guide/class-and-style.md"

Traduzir "api/instance-methods.md"

Link para o arquivo: api/instance-methods

Adaptar "README.md" para nas necessidades o projeto de tradução

O README anterior tinha várias inclusões realizadas pela equipe de tradução. Idealmente, as instruções devem ser concisas lá, mas apontarem para as documentações de contribuição existentes no guia. É necessário refletir sobre o quanto queremos o README deste repositório distante do README original em inglês.

Traduzir "guide/conditional.md"

Traduzir "guide/component-dynamic-async.md"

Problemas de merge em "guide/list.md"

Traduzir e adaptar "guide/contributing/translations.md"

Traduzir "guide/contributing/doc-style-guide.md"

Traduzir "api/directives.md"

Link para o arquivo: api/directives

Traduzir "guide/forms.md"

Traduzir "style-guide/README.md"

Link para o arquivo: style-guide/README

Problemas de merge em "guide/conditional.md"

Traduzir "api/application-api.md"

Link para o arquivo: api/application-api

Problemas de merge em "guide/component-edge-cases.md"

Traduzir "guide/component-slots.md"

Traduzir "community/partners.md"

Link para o arquivo: community/partners

Traduzir "community/themes.md"

Link para o arquivo: community/themes

Criar deploy no Netlifly para testes durante a tradução

Configurar deploy automático do branch master na Netlify com as configurações:

• Build command: yarn build
• Publish directory: src/.vuepress/dist

Traduzir "guide/events.md"

Traduzir "guide/computed.md"

Traduzir "guide/component-provide-inject.md"

Traduzir "community/join.md"

Link para o arquivo: community/join

Traduzir "api/built-in-components.md"

Link para o arquivo: api/built-in-components

Traduzir "api/application-config.md"

Link para o arquivo: api/application-config

Traduzir "guide/installation.md"

Traduzir "support-vuejs/README.md"

Link para o arquivo: support-vuejs/README

Traduzir "api/instance-properties.md"

Link para o arquivo: api/instance-properties

Traduzir "guide/component-props.md"

Traduzir "api/global-api.md"

Link para o arquivo: api/global-api

Traduzir "guide/component-basics.md"

Traduzir "api/basic-reactivity.md"

Link para o arquivo: api/basic-reactivity

Componente "CodeSnippet" desatualizado

O componente genérico, criado em ".\src.vuepress\components\common\codepen-snippet.vue" e utilizado como <common-codepen-snippet /> nos arquivos da documentação, foi inicialmente pensado como uma simplificação da importação dos snippets, padronizando muitos comportamentos.

Após PR enviado para upstream e discussões com o core team, observou-se que ele carecia de muitos props, para que muitos comportamentos dos snippets originais não fosse perdido.

É necessário atualizá-lo aqui no repositório da tradução com o conjunto de props sugerido no PR feito para upstream.

Traduzir "guide/list.md"

Traduzir "guide/component-edge-cases.md"

Correções em "guide/contributing/translations.md"

Fiquei em dúvida sobre se utilizava o termo “traduzir 'file'” ou “melhorar 'file'” visto que a tradução já estava feita.

Mas nessa issue eu venho propor correções e a troca de de algumas palavras para se encaixar no contexto.

Traduzir "community/team.md"

Link para o arquivo: community/team

Traduzir "guide/contributing/writing-guide.md"

Automatization commands runner

Atenção quem estiver sendo notificado (e.g. por criação de issues) pois execução em massa pode lotar e-mail.
@ErickPetru

Traduzir "guide/component-attrs.md"

Traduzir "cookbook/editable-svg-icons.md"

Link para o arquivo: cookbook/editable-svg-icons

Traduzir "guide/instance.md"