Skip to content

Commit

Permalink
convert content to md
Browse files Browse the repository at this point in the history
  • Loading branch information
@SphinxKnight
SphinxKnight committed Sep 17, 2022
1 parent 6c9ba90 commit c65b262
Show file tree
Hide file tree
Showing 18 changed files with 1,393 additions and 1,659 deletions.
35 changes: 12 additions & 23 deletions files/pt-br/mdn/at_ten/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,35 +7,24 @@ tags:
translation_of: MDN_at_ten
original_slug: dez_anos_de_MDN
---
<div class="summary"><span class="seoSummary">Celebrando 10 anos documentando sua Web.</span></div>
Celebrando 10 anos documentando sua Web.

<div class="column-container">
<div class="column-8">
<h2 id="A_história_do_MDN">A história do MDN</h2>
## A história do MDN

<p>No início de 2005, um pequeno time de sonhadores se propôs a criar um novo e livre recurso online contruído pela comunidade para todos os desenvolvedores Web. Sua brilhante mas inconvêncional ideia se tornou o Mozilla Developer Network— recurso essencial para todas as tecnologias Web livres. Dez anos depois, nossa comunidade global está maior do que nunca, e juntos nós ainda estamos criando documentações, amostras de código e recursos de aprendizagem para todas as tecnologias Web livres, incluindo CSS, HTML, JavaScript e tudo mais que faz a Web livre tão poderosa quanto é.</p>
No início de 2005, um pequeno time de sonhadores se propôs a criar um novo e livre recurso online contruído pela comunidade para todos os desenvolvedores Web. Sua brilhante mas inconvêncional ideia se tornou o Mozilla Developer Network— recurso essencial para todas as tecnologias Web livres. Dez anos depois, nossa comunidade global está maior do que nunca, e juntos nós ainda estamos criando documentações, amostras de código e recursos de aprendizagem para todas as tecnologias Web livres, incluindo CSS, HTML, JavaScript e tudo mais que faz a Web livre tão poderosa quanto é.

<p><a class="learnmore" href="/en-US/docs/MDN_at_ten/History_of_MDN">Aprenda mais <span class="offscreen">about the history</span></a></p>
[Aprenda mais about the history](/pt-BR/docs/MDN_at_ten/History_of_MDN)

## Contribuindo com o MDN

<h2 id="Contribuindo_com_o_MDN">Contribuindo com o MDN</h2>
Por dez anos a comunidade do MDN tem documentado a Web livre. Desde corrigir pequenos erros a escrever uma API completamente nova todo mundo tem alguma coisa a oferecer, e nenhuma contribuição é menor ou maior que a outra. Nós temos mais de 90.000 páginas de conteúdo que tem sido escritas ou traduzidas por membros de nossa fantástica comunidade de Mozillians. Você pode se tornar um de nós.

<p>Por dez anos a comunidade do MDN tem documentado a Web livre. Desde corrigir pequenos erros a escrever uma API completamente nova todo mundo tem alguma coisa a oferecer, e nenhuma contribuição é menor ou maior que a outra. Nós temos mais de 90.000 páginas de conteúdo que tem sido escritas ou traduzidas por membros de nossa fantástica comunidade de Mozillians. Você pode se tornar um de nós.</p>
[Aprenda mais about contributing](/pt-BR/docs/MDN_at_ten/Contributing_to_MDN)

<p><a class="learnmore" href="/en-US/docs/MDN_at_ten/Contributing_to_MDN">Aprenda mais <span class="offscreen">about contributing</span></a></p>
{{TenthCampaignQuote}}

<p> </p>
## Subnav

<p> </p>
</div>

<div class="column-4">{{TenthCampaignQuote}}</div>

<h2 id="Subnav">Subnav</h2>

<ol>
<li><a href="/en-US/docs/MDN_at_ten/">10 anos de MDN</a></li>
<li><a href="/en-US/docs/MDN_at_ten/History_of_MDN">A história do MDN</a></li>
<li><a href="/en-US/docs/MDN_at_ten/Contributing_to_MDN">Contribuindo com o MDN</a></li>
</ol>
</div>
1. [10 anos de MDN](/pt-BR/docs/MDN_at_ten/)
2. [A história do MDN](/pt-BR/docs/MDN_at_ten/History_of_MDN)
3. [Contribuindo com o MDN](/pt-BR/docs/MDN_at_ten/Contributing_to_MDN)
53 changes: 24 additions & 29 deletions files/pt-br/mdn/community/contributing/getting_started/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,50 +10,45 @@ tags:
- Novos Contribuidores
original_slug: MDN/Contribute/Getting_started
---
<div>{{MDNSidebar}}</div>
{{MDNSidebar}}

<p>Somos uma comunidade aberta de desenvolvedores construindo recursos para uma web melhor, independente de marca, navegador ou plataforma. Qualquer pessoa pode contribuir e cada contribuição nos torna mais fortes. Juntos podemos conduzir inovações na Web para servir ao bem maior. E começa aqui, com você.</p>
Somos uma comunidade aberta de desenvolvedores construindo recursos para uma web melhor, independente de marca, navegador ou plataforma. Qualquer pessoa pode contribuir e cada contribuição nos torna mais fortes. Juntos podemos conduzir inovações na Web para servir ao bem maior. E começa aqui, com você.

<p><span>Cada parte do MDN (documentações, demos e o próprio site) são criados por uma comunidade aberta de desenvolvedores. Por favor, junte-se a nós!</span></p>
Cada parte do MDN (documentações, demos e o próprio site) são criados por uma comunidade aberta de desenvolvedores. Por favor, junte-se a nós!

<h2 id="4_simple_steps_to_MDN">4 passos simples para o MDN</h2>
## 4 passos simples para o MDN

<p>MDN é uma fonte de código aberto na qual <strong>qualquer pessoa</strong> pode adicionar ou editar conteúdo. Você não precisa ser um programador ou saber muito sobre tecnologia. Existe uma variedade de tarefas que precisam ser feitas, das mais simples (Revisão e correção de erros de digitação) até as mais complexas (escrever documentação de API).</p>
MDN é uma fonte de código aberto na qual **qualquer pessoa** pode adicionar ou editar conteúdo. Você não precisa ser um programador ou saber muito sobre tecnologia. Existe uma variedade de tarefas que precisam ser feitas, das mais simples (Revisão e correção de erros de digitação) até as mais complexas (escrever documentação de API).

<p>Contribuir é fácil e seguro. Caso você cometa algum erro, este pode ser facilmente corrigido. Se você não sabe exatamente como as coisas deveriam parecer, ou se a sua gramática não é assim tão boa, não se preocupe! Temos uma equipe cujo trabalho é garantir que o conteúdo do MDN esteja o melhor possível. Alguém verificará seu trabalho para garantir que esteja correto e bem escrito. Compartilhe o que você sabe e siga seus pontos fortes.</p>
Contribuir é fácil e seguro. Caso você cometa algum erro, este pode ser facilmente corrigido. Se você não sabe exatamente como as coisas deveriam parecer, ou se a sua gramática não é assim tão boa, não se preocupe! Temos uma equipe cujo trabalho é garantir que o conteúdo do MDN esteja o melhor possível. Alguém verificará seu trabalho para garantir que esteja correto e bem escrito. Compartilhe o que você sabe e siga seus pontos fortes.

<h3>Passo 1: Crie uma conta no GitHub</h3>
### Passo 1: Crie uma conta no GitHub

<p>Para começar a contribuir no MDN, você precisa <a href="https://github.com/mdn/content/#setup">criar uma conta no GitHub</a>.</p>
Para começar a contribuir no MDN, você precisa [criar uma conta no GitHub](https://github.com/mdn/content/#setup).

### Passo 2: Escolha uma tarefa

<h3 id="Step_2_Pick_a_task_to_complete">Passo 2: Escolha uma tarefa</h3>
Agora que você está logado, leia as descrições dos diferentes tipos de tarefas disponíveis na [página principal de Contribuição](/pt-BR/docs/MDN/Contribute), e escolha a que te agradar mais. Você pode escolher qualquer tarefa que gostar para iniciar sua contribuição.

<p>Agora que você está logado, leia as descrições dos diferentes tipos de tarefas disponíveis na <a href="/pt-BR/docs/MDN/Contribute">página principal de Contribuição</a>, e escolha a que te agradar mais. Você pode escolher qualquer tarefa que gostar para iniciar sua contribuição.</p>
### Passo 3: Faça a tarefa

<h3 id="Step_3_Do_the_task">Passo 3: Faça a tarefa</h3>
Assim que decidir que tipo de tarefa você quer fazer, procure uma página específica, exemplo de código e quaisquer outros recursos disponíveis para trabalhar e faça!

<p>Assim que decidir que tipo de tarefa você quer fazer, procure uma página específica, exemplo de código e quaisquer outros recursos disponíveis para trabalhar e faça!</p>
### Passo 4: Peça ajuda

<h3 id="Step_4_Ask_for_help">Passo 4: Peça ajuda</h3>
Se você não tiver certeza do que fazer em qualquer momento, então você está mais que bem-vindo para pedir ajuda. Existem algumas opções diferentes de ajuda:

<p>Se você não tiver certeza do que fazer em qualquer momento, então você está mais que bem-vindo para pedir ajuda. Existem algumas opções diferentes de ajuda:</p>
- Se você quer falar conosco de forma síncrona e perguntar sobre o MDN em si, junte-se a discussão no [chat da Documentação Web do MDN](https://chat.mozilla.org/#/room/#mdn:mozilla.org) no [Matrix](https://wiki.mozilla.org/Matrix).
- Você também pode enviar um email para <[email protected]>.
- Se você está aprendendo desenvolvimento web e está emperrado em um problema de código, nós temos [fórums ativos](https://discourse.mozilla.org/c/mdn/learn/250) nos quais você pode fazer perguntas e obter ajuda.

<ul>
<li>Se você quer falar conosco de forma síncrona e perguntar sobre o MDN em si, junte-se a discussão no <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">chat da Documentação Web do MDN</a> no <a href="https://wiki.mozilla.org/Matrix">Matrix</a>.</li>
<li>Você também pode enviar um email para <a href="mailto:[email protected]">[email protected]</a>.</li>
<li>Se você está aprendendo desenvolvimento web e está emperrado em um problema de código, nós temos <a href="https://discourse.mozilla.org/c/mdn/learn/250">fórums ativos</a> nos quais você pode fazer perguntas e obter ajuda.</li>
</ul>
Não se preocupe em fazer tudo perfeito; outros colaboradores do MDN estão aqui para ajudar a corrigir os erros que passaram despercebidos.

<p>Não se preocupe em fazer tudo perfeito; outros colaboradores do MDN estão aqui para ajudar a corrigir os erros que passaram despercebidos.</p>
## Guias completos úteis para iniciantes

<h2 id="useful_complete_beginners_guides">Guias completos úteis para iniciantes</h2>
Nós esperamos que os contribuidores do MDN tenham uma certa quantidade de conhecimento prévio antes de começar a trabalhar no conteúdo. Se você é novo nos tópicos a seguir, nós aconselhamos que você visite os links fornecidos para te ajudar a começar mais rapidamente:

<p>Nós esperamos que os contribuidores do MDN tenham uma certa quantidade de conhecimento prévio antes de começar a trabalhar no conteúdo. Se você é novo nos tópicos a seguir, nós aconselhamos que você visite os links fornecidos para te ajudar a começar mais rapidamente:</p>

<ul>
<li>Tecnologias Web: Se você é novo com HTML, CSS, JavaScript, etc., confira nossos tutoriais para <a href="/pt-BR/docs/Learn">Aprender desenvolvimento web</a>.</li>
<li>Código aberto: Se você nunca contribuiu com um projeto de código aberto antes, leia <a href="/pt-BR/docs/MDN/Contribute/Open_source_etiquette">Etiqueta básica para projetos de código aberto</a>.</li>
<li>Git e GitHub: Se você não está familiarizado com estas ferramentas, <a href="/pt-BR/docs/MDN/Contribute/GitHub_beginners">GitHub para iniciantes</a> vai te ajudar a começar.</li>
<li>Estrutura de repositórios do MDN: Se você não está certo sobre qual repositório editar para mudar diferentes partes do conteúdo do MDN, <a href="/pt-BR/docs/MDN/Contribute/Where_is_everything">Onde está tudo no MDN?</a> será seu ponto de entrada para os lugares certos.</li>
</ul>
- Tecnologias Web: Se você é novo com HTML, CSS, JavaScript, etc., confira nossos tutoriais para [Aprender desenvolvimento web](/pt-BR/docs/Learn).
- Código aberto: Se você nunca contribuiu com um projeto de código aberto antes, leia [Etiqueta básica para projetos de código aberto](/pt-BR/docs/MDN/Contribute/Open_source_etiquette).
- Git e GitHub: Se você não está familiarizado com estas ferramentas, [GitHub para iniciantes](/pt-BR/docs/MDN/Contribute/GitHub_beginners) vai te ajudar a começar.
- Estrutura de repositórios do MDN: Se você não está certo sobre qual repositório editar para mudar diferentes partes do conteúdo do MDN, [Onde está tudo no MDN?](/pt-BR/docs/MDN/Contribute/Where_is_everything) será seu ponto de entrada para os lugares certos.
30 changes: 13 additions & 17 deletions files/pt-br/mdn/community/contributing/our_repositories/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,26 +10,22 @@ tags:
- Repositórios
original_slug: MDN/Contribute/Where_is_everything
---
<p>{{MDNSidebar}}</p>
{{MDNSidebar}}

<p>MDN é um projeto complexo com muitas partes móveis. É fácil começar a contribuir para o site, se você sabe um pouco sobre GitHub e está começando com algum erro de escrita simples ou pequenas melhorias de código. Contudo, quando você começa a fazer contribuições significantes como adicionar páginas completamente novas, você vai notar que alguns pedaços de conteúdo não estão no código fonte da página e, ao invés disso, vem de algum outro lugar.</p>
MDN é um projeto complexo com muitas partes móveis. É fácil começar a contribuir para o site, se você sabe um pouco sobre GitHub e está começando com algum erro de escrita simples ou pequenas melhorias de código. Contudo, quando você começa a fazer contribuições significantes como adicionar páginas completamente novas, você vai notar que alguns pedaços de conteúdo não estão no código fonte da página e, ao invés disso, vem de algum outro lugar.

<p>Este artigo age como um guia rápido para encontrar diferentes repositórios que você precisa editar e atualizar para mudar diferentes partes do conteúdo do MDN.</p>
Este artigo age como um guia rápido para encontrar diferentes repositórios que você precisa editar e atualizar para mudar diferentes partes do conteúdo do MDN.

<h2 id="core_repos">Repositórios principais</h2>
## Repositórios principais

<ul>
<li><strong>Conteúdo principal</strong>: <a href="https://github.com/mdn/content">https://github.com/mdn/content</a>. O repositório mais importante para o conteúdo do MDN — Aqui é onde todo o conteúdo base, em inglês, do site está armazenado, e onde você vai fazer mudanças padrões para o conteúdo da página.</li>
<li><strong>Plataforma MDN</strong>: <a href="https://github.com/mdn/yari">https://github.com/mdn/yari</a>. Aqui é onde a plataforma MDN é armazenada, e onde você vai se quiser fazer mudanças de alto nível na estrutura de páginas do MDN ou no maquinário de renderização.</li>
<li><strong>Dados de compatibilidade do Browser</strong>: <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>. Aqui é onde os dados usados para gerar as tabelas de compatibilidade dos browsers em nossas páginas de referências são armazenados (exemplo). Vá aqui para fazer mudanças nos dados de compatibilidade!</li>
<li><strong>Exemplos interativos</strong>: <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a>. Este repositório armazena o renderizador de código e blocos de código de exemplo que juntos produzem os belos, editáveis e copiáveis exemplos encontrados no topo de muitas de nossas páginas de referência (exemplo). Edite esses exemplos aqui.</li>
<li><strong>Conteúdo traduzido</strong>: <a href="https://github.com/mdn/translated-content">https://github.com/mdn/translated-content</a>. Aqui é onde mora nosso conteúdo localizado. Vá aqui se você quiser ajudar a traduzir páginas em qualquer um de nossos locais mantidos ativamente.
<li><strong>Dados CSS</strong>: <a href="https://github.com/mdn/data">https://github.com/mdn/data</a>. Originalmente previsto para ser um repositório que guarda os dados gerais do MDN, o repositório agora tem o propósito de guardar dados sobre funcionalidades do CSS como sintaxe formal, herança, valor computado, tipos de animação, etc. Ele é usado para gerar seções nas páginas de referências de CSS como uma definição formal (exemplo) e sintaxe formal (exemplo).</li>
</ul>
- **Conteúdo principal**: <https://github.com/mdn/content>. O repositório mais importante para o conteúdo do MDN — Aqui é onde todo o conteúdo base, em inglês, do site está armazenado, e onde você vai fazer mudanças padrões para o conteúdo da página.
- **Plataforma MDN**: <https://github.com/mdn/yari>. Aqui é onde a plataforma MDN é armazenada, e onde você vai se quiser fazer mudanças de alto nível na estrutura de páginas do MDN ou no maquinário de renderização.
- **Dados de compatibilidade do Browser**: <https://github.com/mdn/browser-compat-data>. Aqui é onde os dados usados para gerar as tabelas de compatibilidade dos browsers em nossas páginas de referências são armazenados (exemplo). Vá aqui para fazer mudanças nos dados de compatibilidade!
- **Exemplos interativos**: <https://github.com/mdn/interactive-examples>. Este repositório armazena o renderizador de código e blocos de código de exemplo que juntos produzem os belos, editáveis e copiáveis exemplos encontrados no topo de muitas de nossas páginas de referência (exemplo). Edite esses exemplos aqui.
- **Conteúdo traduzido**: <https://github.com/mdn/translated-content>. Aqui é onde mora nosso conteúdo localizado. Vá aqui se você quiser ajudar a traduzir páginas em qualquer um de nossos locais mantidos ativamente.
- **Dados CSS**: <https://github.com/mdn/data>. Originalmente previsto para ser um repositório que guarda os dados gerais do MDN, o repositório agora tem o propósito de guardar dados sobre funcionalidades do CSS como sintaxe formal, herança, valor computado, tipos de animação, etc. Ele é usado para gerar seções nas páginas de referências de CSS como uma definição formal (exemplo) e sintaxe formal (exemplo).

<h2 id="other_repos">Outros repositórios</h2>
## Outros repositórios

<ul>
<li><strong>Repositório de demos</strong>. O GitHub da organização do MDN contém um grande número de repositórios de demonstração, por exemplo <a href="https://github.com/mdn/css-examples">css-examples</a>, <a href="https://github.com/mdn/dom-examples">dom-examples</a>, <a href="https://github.com/mdn/webaudio-examples">webaudio-examples</a>. Estes, no geral, contém exemplos autônomos que são frequentemente ligados as páginas do MDN, mas, ocasionalmente, você vai encontrar algum destes exemplos embutidos em uma página usando uma chamada macro como esta — \{{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}}. Se você quer editar o exemplo autônomo, ele sempre será encontrado em algum destes repositórios de exemplos.</li>
<li><strong>MDN-minimalist</strong>: <a href="https://github.com/mdn/mdn-minimalist">https://github.com/mdn/mdn-minimalist</a>. As informações base de estilização do MDN. Se você quer ajudar a melhorar o estilo CSS do MDN, este é o lugar para visitar.</li>
</ul>
- **Repositório de demos**. O GitHub da organização do MDN contém um grande número de repositórios de demonstração, por exemplo [css-examples](https://github.com/mdn/css-examples), [dom-examples](https://github.com/mdn/dom-examples), [webaudio-examples](https://github.com/mdn/webaudio-examples). Estes, no geral, contém exemplos autônomos que são frequentemente ligados as páginas do MDN, mas, ocasionalmente, você vai encontrar algum destes exemplos embutidos em uma página usando uma chamada macro como esta — \\{{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}}. Se você quer editar o exemplo autônomo, ele sempre será encontrado em algum destes repositórios de exemplos.
- **MDN-minimalist**: <https://github.com/mdn/mdn-minimalist>. As informações base de estilização do MDN. Se você quer ajudar a melhorar o estilo CSS do MDN, este é o lugar para visitar.
Loading

0 comments on commit c65b262

Please sign in to comment.