Iniciação na MDN

Nós somos uma comunidade aberta de programadores e autores que criam recursos para uma Web melhor, independentemente da marca, navegador, ou plataforma. Qualquer pessoa pode contribuir e cada uma que o faz, torna-nos mais fortes. Juntos, nós podemos continuar a inovar na Web para o bem de todos. Isso começa aqui, consigo.

Cada parte da MDN (desde o código que faz com que o site funcione até à documentação, amostras de código, e demonstrações) é criada por uma comunidade de programadores e autores. Todos têm algo a oferecer e nós esperamos que se junte a nós!

3 passos simples para a MDN

A MDN é uma wiki, onde qualquer pessoa pode adicionar e editar conteúdo. Não precisa de ser um programador ou saber muito sobre tecnologia. Existem várias coisas que precisam ser feitas, desde tarefas simples, tal como a revisão de textos e correção de erros ortográficos até às mais complexas, tal como escrever documentação API.

Contribuir é fácil e seguro. Mesmo que cometa um erro, este é facilmente corrigido; Se não sabe ao certo qual deverá ser o aspeto final ou o seu vocabulário não é o mais rico, não se preocupe! Nós temos uma equipa de pessoas cujo trabalho é ter a certeza de que o conteúdo da MDN é tão bom quanto possível. Alguém certificar-se-á de que o seu trabalho está conciso e bem escrito. Partilhe o que sabe, siga o seu instinto e confie no resto da comunidade para o ajudar a melhorar o seu trabalho.

Passo 1: Criar uma conta na MDN

Para começar a contribuir na MDN precisa de ter uma conta na MDN. Para mais detalhes, por favor, consulte como criar uma conta. Note que irá precisar de uma conta GitHub antes de poder criar uma conta MDN, porque atualmente nós utilizamos o GitHub para autenticação.

Se a sua tarefa envolve a criação de novas páginas, por favor, consulte Getting page creation permissions in How to create and edit pages for important information about how to get permission to add new pages; for security reasons, new accounts don't have this ability by default.

Passo 2: Escolher uma tarefa

Agora que iniciou a sessão, leia as descrições dos tipos de tarefa diferentes em a lista abaixo, e decida qual é a mais apelativa para si. Pode escolher qualquer tarefa que lhe agrade e comece a contribuir.

Passo 3: Executar a tarefa

Assim que decidir que tipo de tarefa é que pretende fazer, procure uma página específica, exemplo de código, etc., para trabalhar, e comece!

Não se preocupe em ser perfecionista; outros colaboradores da MDN estão aqui para ajudar a corrigir eventuais erros. Se entretanto tiver dúvidas, consulte a página da Comunidade para informação sobre contactos e canais de conversação onde poderá obter as suas respostas.

Nota: se quiser experimentar com a edição na MDN antes de fazer algo "a sério", nós temos a página Sandbox onde poderá testar livremente. Por favor, experimente apenas nesta página. Nós pedimos que não proceda a alterações desnecessárias ao conteúdo das páginas apenas para ver como irá ficar; isso é criar uma bagunça para os outros corrigirem ou, pior, confundir os leitores que estão apenas a tentar aprender alguma coisa ou a procurar alguma coisa.

Quando tiver terminado a tarefa escolhida, sinta-se livre para escolher outro item, ou consulte abaixo outras coisas que pode fazer na MDN.

Tipos de tarefas possíveis

Existem várias formas possíveis para que possa contribuir para a MDN, dependendo do seu conjunto de habilidades e interesses. Mesmo que algumas tarefas possam ser assustadoras, nós temos muitas atividades simples disponíveis. Algumas delas apenas precisam de cinco minutos (ou menos!) do seu tempo. Abaixo, juntamente com a tarefa e respetiva breve descrição, encontrará o tempo aproximado que cada tipo de tarefa normalmente demora.

Opção 1: Eu gosto de palavras

Pode ajudar-nos a rever ou a editar documentos existentes, e aplicar as etiquetas corretas para os mesmos.

Definir o resumo para uma página (5 a 15 minutos)
Efetuar revisões editoriais (5 a 30 minutos)
Escrever uma nova entrada no Glossário (15 minutos a 1 hora)
Como escrever um artigo para ajudar as pessoas a aprenderem sobre a Web (1 a 3 horas)

Se estiver a rever ou a escrever novos artigos, nós pedimos-lhe para, por favor, rever o Guia de Estilo. Isto irá ajudar a assegurar que os artigos sejam consistentes.

Opção 2: Eu gosto de código

Nós precisamos de mais exemplos de código! Também pode ajudar a criar a plataforma do nosso site, Kuma!

Converter exemplos de código para ficarem live (30 minutos)
Read the Getting Involved Guide (30 minutes)
Set up a Kuma build environment (1 hour)
Send your code patch to the Kuma codebase (1 hour)

Opção 3: Eu gosto de palavras e código

Nós temos tarefas que requerem competências técnicas e linguísticas, tais como escrever novos artigos, rever para uma correção técnica, ou adaptar documentos.

Marcar páginas de JavaScript (5 minutos)
Promover a MDN na sua própria página web (5 minutos)
Revisões técnicas (30 minutos)
Escrever um novo artigo sobre um tema com o qual se sente familiarizado (1 hora ou mais)
Criar um exercício interativo para ajudar as pessoas a aprender sobre a web (1 hora ou mais)
Corrigir um erro de documentação na Categoria MDN do Bugs Ahoy (1 hora ou mais)

Opção 4: Eu quero a MDN no meu idioma

Todo o trabalho de localização e tradução feito na MDN é elaborado pela nossa incrível comunidade de voluntários.

Traduzir páginas (2 horas) (Ver prioridades de topo)
Interligar com outros localizadores listados nos Projetos de Localização (30 minutos)

Opção 5: Eu encontrei alguma informação errada, mas não sei como corrigi-la

Pode comunicar problemas, preenchendo um formulário de erro na documentação (EN) (5 minutos)

Outras coisas que pode fazer na MDN

Aderir à Comunidade da MDN.
Preencha o seu perfil, assim os outros podem saber mais sobre si.
Saiba mais sobre como contribuir para a MDN.