Como começar

Ajudar o MDC é tão simples como usar o seu browser. Se você preenche campos de formulários na web ou usa caixas de texto para postar em weblogs, você tem todas as habilidades com o browser necessárias para começar.

Introdução

Sinta-se encorajado a escrever, editar, revisar, e traduzir qualquer documentação que encontrar neste wiki. Por favor, faça isso com espírito cooperativo pensando na melhoria do conteúdo, entretanto, não se sinta desapontado se alguém mais tarde fizer algumas correções ou melhorias em seu texto. Nós estamos aqui para tornar a documentação da Mozilla cada vez melhor (salva de spammers), cooperando, trabalhando juntos, ajudando e encorajando a todos.

O básico

Aqui está um pequeno guia sobre como editar e criar páginas no wiki do MDC. Você é bem vindo a praticar suas habilidades em wikis na Sandbox:Test Page.

Editando páginas

Simplesmente clique no atalho Criar Conta e preencha os campos. É preciso ter uma conta e identificar-se para poder editar páginas. Estes passos são necessários pois permitem lutar contra ações de vandalismo e torna mais fácil registrar (e agradecer-lhe pelas) contribuições.

Na coluna da direita de todas as páginas você vai ver um link "Editar". Clicando neste link você será levado a uma página onde poderá editar o conteúdo fazendo as alterações que achar necessárias, pré-visualizá-las, então salvá-las no Wiki. Uma vez salvas, você pode ver suas modificações imediatamente na página

Iniciando uma nova página

O caminho mais fácil para criar uma nova página é criar um link para ela em sua página de usuário, então usar este link para entrar no modo de edição da página.

Para chegar até sua página de usuário, clique em seu nome de usuário no topo da página do wiki. Se você ainda não adicionou nada em sua página, você será levado imediatamente para o formulário de edição da página, onde poderá adicionar o conteúdo que quiser.

Criar um link à página que você quer adicionar é tão simples quanto escrever o título para a página incluído entre colchetes, como este: [[Este é um exemplo]]. Quando salvo, isto se tornará um link, como este: Este é um exemplo.

Caso a página não exista, o link será vermelho, caso exista, será azul. Se você pretende criar uma página e o título que você deseja incluir já esteja sendo examinado, verifique antes se você pode ajudar a editar e melhorar o artigo existente. Caso contrário, pense em um título diferente para sua página e crie um link para ela.

Quando você quiser adicionar conteúdo em sua página nova, simplesmente clique no link vermelho que você criou e comece a escrever. Lembre-se de usar o botão "Salvar página" no final do formulário de edição para salvar seu trabalho (frequentemente, se você estiver trabalhando em uma parte longa).

Guia para nomeação de páginas

Para mais informações sobre criar e nomear páginas novas, veja nosso Guia para nomeação de páginas.

Marcação do Wiki

Se você clicar em "Editar" na coluna da direita, você verá que o texto desta página contém alguns caracteres especiais, por exemplo os "==" entre os títulos e os "[[ ]]" entre os links. Esta é uma forma muito simples de marcação textual que é exclusiva de sistemas wiki. O poder deste tipo de marcação reside no fato de que é muito fácil de aprender e pode ser facilmente corrigido caso ocorra algum erro.

Referência de marcação no Wiki

Nós temos uma completa referência de marcação onde você pode aprender a linguagem com a qual pode editar e escrever textos dentro do Wiki.

Escrevendo, editando e revisando

Aqui está uma pequena introdução do MDC para escritores, editores e revisores.

Escritores

O MDC está sempre interessado em novos conteúdos, então sinta-se encorajado a escrever novos artigos quando quiser relacionados aos tópicos que o wiki abrange. Um novo conteúdo pode ser uma simples página de dicas ou algo tão complexo quanto um guia de referência de programação. A quantidade que você deve escrever é uma decisão que cabe inteiramente a você.

Caso você esteja empreendendo um grande projeto, sugerimos que você entre na Comunidade MDC e discuta suas idéias primeiramente lá, apenas para tomar conhecimento se alguém está planejando ou já iniciou um projeto similar.

Consulte o guia do escritor se você tem dúvidas sobre o estilo ou políticas de uso dentro do wiki.

Editores

Edição é sempre bem-vinda em nosso Wiki, particularmente para melhorar ou corrigir o estilo de escrita ou gramática. Por favor, veja nosso guia do escritor para maiores informações.

Revisores

Melhorias técnicas e revisões são sempre bem-vindas aqui, então se você estiver lendo uma página e encontrar um erro técnico (seja ele no código ou no texto), por favor sinta-se livre para corrigí-lo. Caso esta mudança cause alguma controvérsia, faça uma observação na página de "talk" (clicando no link "Discussion" na coluna da direita) e deixe uma nota explicando as razões de sua modificação.

Guia do escritor

Nós possuímos um Guia do escritor frizando o estilo preferencial de escrita . Se você tiver alguma dúvida sobre algum estilo não explicado aqui, recomendamos a seguinte consulta: Economist style guide ou, se ainda assim não estiver satisfeito, esta: Chicago Manual of Style.

Nós iremos expandir o guia no decorrer do tempo, então caso você tenha dúvidas específicas não explanadas no Guia do escritor, por favor envie-a para a lista de e-mails da MDC ou para o administrador do projeto, assim saberemos que ela deve ser adicionada.

Traduzindo documentação

A prioridade atual do MDC em português é traduzir toda a documentação existente no MDC em inglês. Para fazê-lo:

  1. Escolha um documento que você gostaria de traduzir na lista de documentos a traduzir.
  2. Remova a página da lista de documentos a traduzir e adicione-o na lista de traduções em andamento.
  3. Crie estas páginas caso não estejam criadas e migre o conteúdo, formatando-o da melhor forma que você puder, conforme o Guia de referência de marcação.
  4. Adicione o item na lista de documentos traduzidos.

Caso você queira fazer um trabalho realmente bom, poderá também:

  1. Usar nosso sistema de busca para procurar por qualquer link do documento original do wiki, então alterá-lo em sua nova página.
  2. Checar por redirecionamentos externos ao documento original, e marcar estes redirecionamentos para deleção colocando-os na categoria "Sucata" adicionando-o a seguinte marcação: [[Categoria:Sucata]]

== Migrando documentações antigas == Um dos maiores sub-projetos do MDC é migrar toda a documentação que existe atualmente em mozilla.org para o wiki. Este procedimento é simples: # Escolha um documento que você gostaria de migrar da lista de conteúdo existente. # Consulte o Guia de nomeação de páginas e decida como as páginas daquele documento devem ser chamadas no wiki. # Crie estas páginas e migre o conteúdo, formatando-o da melhor forma que você puder, conforme o Guia de referência de marcação. # Adicione o item na lista de conteúdo existente. Caso você queira fazer um trabalho realmente bom, poderá também: # Usar nosso sistema de busca para procurar por qualquer link do documento original do wiki, então alterá-lo em sua nova página. # Checar por redirecionamentos externos ao documento original, e marcar estes redirecionamentos para deleção colocando-os na categoria "Sucata" adicionando-o a seguinte marcação:

Localizando o MDC

Se você está interessado em ajudar a traduzir a documentação em qualquer dos wiki MDC's em outras linguas, você pode fazer simplesmente visitando o wiki da linguagem que deseja e editar ou criar páginas.

Localização de projetos existentes

Atualmente o MDC possui wikis para as seguintes línguas: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어.

Como começar um novo projeto de localização

Se você estiver interessado em iniciar um novo projeto de localização para uma linguagem, nós não temos atualmente um wiki para isso, por favor leia a página de projetos de localização e siga as instruções.

Resolvendo "guerras de edição" ou outros conflitos

Se por qualquer razão você entrar em uma "guerra de edição" em alguma página, onde duas ou mais pessoas estão continua e repetidamente fazendo e revertendo mudanças, por favor, primeiramente tente resolver o conflito diretamente com a pessoa envolvida.

Se nenhuma resolução for possível, por favor traga isto ao conhecimento de outros, preferencialmente a lista de discussão do MDC ou, como último recurso para o administrador do projeto. Outros escritores, técnicos e editores serão consultados, e suas opiniões formarão a base para resolução do problema.

Requisitando deleções de páginas

Caso você tenha criado uma página acidentalmente ou encontrar alguma página que deveria ser deletada, adicione-a à categoria "Sucata", adicionando o código [[Categoria:Sucata]] no rodapé da página.

A categoria Sucata é checada periodicamente pelos administradores do wiki e as páginas que contém são analisadas e deletadas propriamente.

Nota: Por favor não delete outro conteúdo ou categorias das páginas que você entitular como "Sucata".

Juntando-se à comunidade MDC

O Mozilla Developer Center é em sua maior parte formado pelo trabalho de um grupo de voluntários, e nós estamos sempre dispostos a ajudar escritores e editores novos a se envolverem.

Listas de e-mail e newsgroup

A maior parte do planejamento e discussão do projeto MDC ocorre no Grupo Google, na lista de e-mail e newsgroup.

Se você tiver algum problema com a lista, ou tiver alguma pergunta, sinta-se livre para entrar em contato com um administrador.

IRC

Você é bem vindo para juntar-se ao canal #mdc-pt em irc.mozilla.org.

Administradores do MDC em português

Os administradores da versão em língua portuguesa do Mozilla Developer Center são os seguintes:

Document Tags and Contributors

Last updated by: lzfernando,