Iniciação na MDN

Nós somos uma comunidade aberta de programadores e autores que criam recursos para uma melhor Web, independentemente da marca, navegador, ou plataforma. Qualquer um pode contribuir e cada pessoa 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.

Todas as partes da MDN (a partir do código que faz o site funcionar para a documentação, amostras de código e demonstrações) é criado por uma comunidade de desenvolvedores e autores. Todos têm algo a oferecer, esperamos que você se junte a nós!

3 passos simples para a MDN

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

Contribuir é fácil e seguro. Mesmo que cometa um erro, 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! Temos uma equipa de pessoas cujo trabalho é ter a certeza 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. Compartilhe 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 para a MDN, será necessário ter uma conta na MDN. Para mais detalhes, por favor veja como criar uma conta.

Passo 2: Escolher uma tarefa

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

Passo 3: Executar a tarefa

Logo que decida que tipo de tarefa pretende fazer, procure uma página em específico, exemplo de código, etc. para trabalhar. É só começar!

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

Nota: Se quiser experimentar editar na MDN antes de fazer algo "a sério", temos a página Sandbox onde poderá fazer testes livremente. Por favor, faça as experiências apenas nesta página. Pedimos que não proceda a alterações desnecessárias ao conteúdo das páginas apenas para ver como irá ficar; isso é causar confusões que outros vão ter de resolver posteriormente.

Quando já tiver terminado a tarefa escolhida, sinta-se livre para escolher outro item ou veja 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 de uma página (5-15 minutos)
Revisões editoriais (5–30 minutos)
Atualizar um artigo existente com novas informações (5 minutos-1 hora)
Escrever uma nova entrada no glossário (15 minutos-1 hora)
Escrever um artigo sobre uma nova tecnologia ou API (30 minutos-2 horas)
Escrever um artigo para ajudar as pessoas a aprender sobre a web (1-3 horas)

Nota: Se estiver a rever ou escrever novos artigos, pedimos-lhe, por favor, que reveja o Guia de Estilo. Isso ajudará a garantir que os artigos sejam consistentes.

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

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

Converter amostras de códigos para ser "ao vivo" (30 minutos)
Definir um ambiente de construção no Kuma (1 hora)
Enviar os seus códigos para a base de códigos do Kuma (1 hora)
Submeter uma nova demonstração (1 hora)

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)
Conectar com outros localizadores listados em Projetos de localização (30 minutos)

Opção 5: Eu encontrei algumas informações erradas mas não sei como corrigi-las

Pode comunicar os problemas, preenchendo um formulário de erro na documentação (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.