MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Trabalhando em comunidade

Tradução em progresso.

Uma importante parte de contribuir com a documentação da MDN em qualquer escala significativa é saber como trabalhar como parte da comunidade MDN. Esse artigo oferece dicas sobre como você pode tirar o melhor proveito das suas interações com outros escritores e outros times de desenvolvimento.

Dicas gerais de etiqueta

Aqui estão algumas dicas gerais de conduta quando trabalhando na comunidade Mozilla.

  • Seja educado! Mesmo em discordância, todos nós temos a mesma missão: melhorar a Web.
  • Peça, não exija. As pessoas estarão muito mais dispostas a ajudar de forma responsiva quando você educadamente pedir ajuda em vez de exigi-la. Ainda que o trabalho de documentação seja importante, e nossa comunidade de desenvolvimento saiba disso, o instinto humano tende a fazer com que as pessoas sejam abrasivas e difíceis de lidar se você não tratá-las com o devido respeito.
  • Equilibre sua necessidade de informação juntamente com a urgência da documentação e o tempo que os outros na sua discussão tem para dedicar a ajudá-lo. Não fique pedindo mais e mais detalhes, a ponto de deixar loucos os outros envolvidos na conversa, se realmente não forem necessários nesse momento.
  • Tenha em mente que seu pedido toma tempo valioso das pessoas com as quais você entrou em contato, então tenha certeza de fazer bom uso do tempo delas.
  • Considere diferentes culturas. Mozilla é uma multinacional e possui uma equipe multicultural, então quando contatar alguém cuja cultura é, ou pode ser, diferente da sua, seja claro e mantenha em mente isto enquanto se comunica.
  • Inicie uma nova conversa em vez de reutilizar uma conversa existente. Não insira suas questões dentro de uma conversa não relacionada ao assunto principal somente porque as pessoas nas quais você precisa falar estão prestando atenção nisto. Embora isso pareça ser conveniente para você, isso pode irritar as pessoas que você está tentando conversar, e ocasiona um resultado abaixo do ideal.
  • Evite a Lei da trivialidade. Não deixe seu entusiasmo virar pedantice chata. Isso faz com que as conversas fiquem cansativas e percam o foco.

Tenha sensatez

Sempre seja sensato e respeitoso quando se comunicar com os outros.

Gentilmente aponte os erros

Se seu propósito em contatar alguém é para pedi-los para fazer alguma coisa diferentemente, ou apontar enganos que eles estão cometendo (especialmente se eles repetidamente estão fazendo isto), inicie sua mensagem com um comentário positivo. Isto suaviza o impacto, por assim dizer, e demonstra que você está tentando ser prestativo, ao invés de definir você como o cara mau.

Por exemplo, se um novo contribuidor tiver criado muitos páginas sem tags, e você gostaria de pontuar esse problema, sua mensagem para eles podem ser desta forma (o que você precisa mudar para cada caso está sublinhado):

Oi, MrBigglesworth, eu tenho que notificar suas contribuições para a documentação da Wormhole API e isto é fantástico ter sua ajuda! Eu particularmente gosto do modo que você equilibra seu nível de detalhes com legibilidade. Dito isto, contudo, você poderia fazer estes artigos sempre melhores e mais pertinentes se adicionar as corretas tags para as páginas enquanto você elabora.

Veja o MDN guia de etiquetas (https://developer.mozilla.org/pt-BR/docs/MDN/Contribute/guia/Como-marcar-as-paginas-corretamente) para detalhes.

Obrigado novamente, e aguardo suas futuras contribuições!

Compartilhe conhecimento

Assim que você participa do projeto MDN, é útil saber o que está acontecendo, e interagir com outros membros de sua comunidade. Para conversar com outros em nossa comunidade, você pode seguir e compartilhar ideias, status atualizado, e mais. Nós também temos ferramentas e informações que podem ajudar você a saber o que está sendo feito, e por quem.

Canais de comunicação

Há muitos caminhos que você pode engajar como membro da comunidade (como desenvolvedor ou como escritor), cada um tem algumas regras particulares de etiqueta.

IRC

Este é frequentemente o caminho mais rápido e o mais direto caminho para abordar alguém: só contatá-los no IRC. Encontre o canal correspondente à área do tópico que você está escrevendo a respeito, então somente fale com eles. Para dicas específicas de etiquetas, veja o artigo de suporte Mozilla "Comece iniciando com IRC". Para discussões sobre a documentação de desenvolvedor, use o canal #mdn .

Bugzilla

Quando escrever documentação para cobrir mudanças implementadas como um resultado de um bug no Bugzilla, você frequentemente interagirá com pessoas envolvidas naquele projeto. Seja claro para continuar o guia de etiqueta Bugzilla em mente em todas às vezes!

E-mail

Algumas vezes, uma troca de e-mail privado entre você e uma ou mais pessoas, é o caminho para seguir, se você possuir os endereços de e-mails deles.

Nota: Como regra geral, se alguém postou o endereço de e-mail pessoal em documentos sobre a tecnologia que você está documentando, ou deu a você o endereço de e-mail pessoal, ou geralmente tem um endereço de e-mail bem conhecido, então o e-mail torna-se uma abordagem aceitável como "primeiro contato". Se você precisa "escavar" mais sobre o assunto, provavelmente você deve tentar obter aguma permissão no IRC ou em uma lista de discussão primeiro, a menos que você tenha esgotado todas as outras tentativas de entrar em contato.

Ferramenta de status de conteúdo

Nós temos muitas ferramentas úteis que fornecem informações sobre o status do conteúdo da documentação.

Painel de Controle (Dashboard ) para revisão
O painel de controle para revisão providencia uma ferramenta fantástica para revisar mudanças feitas para o conteúdo do MDN. Você pode ver as histórias recentes, ou escolher um período de tempo para vê-las, e filtrar resultados com base em características como localidade, nome de contribuidores, e tópicos. Uma vez que você está olhando para um conjunto de revisões, você pode ver as mudanças feitas em cada revisão, abrir rapidamente a página, ver um histórico completo ou até reverter as alterações (se você tiver esses privilégios).
Visão geral do status da documentação
Nossa visão geral do status da documentação página providencia uma lista de todas as áreas do MDN que você tem configurado pela trilha de status, com informações sobre como muitas páginas são necessárias diferentes tipos de trabalho feito. Clique através de um particular tópico de área para ver detalhadas listas de conteúdo que necessitam trabalhar, tais como páginas que não tem tags, ou são tags com indicadores que certos tipos de trabalhos necessários para ser feito. Você pode mesmo ver listas de páginas que não tem sido atualizado em um longo tempo e pode se desatualizado, tão bem quanto uma lista de bugs que tem sido sinalizado como impactante na documentação daquela área.
Documentação dos planos de projetos
Nós temos um número de projetos escritos que estão no estágio de planejamento, ou são largos e em progresso, para o qual nós temos escrito documento de planejamento para ajudar-nos a guardar a trilha daquilo que nós precisamos fazer.
MDN Trello board
The MDN staff writers use a Trello board to manage current and future documentation projects. You can take a look to see what we're doing and how it's going, and you can see what projects we'd like to see happen soon. Some of those will be taken on by staff writers, but you should feel free to take one over if you like! For more information about how this board is used and how you can use it, you can read this page.

A comunidade de desenvolvimento

Possivelmente o mais importante relacionamento para desenvolver e manter, como um membro da comunidade de escrita do MDN, são aqueles que você desenvolve e sustenta com os desenvolvedores. Eles criam o software que nós estamos desenvolvendo, mas eles são também os mais usuais recursos de informações que nós temos. É crucial que nós mantenhamos bons relacionamentos com os desenvolvedores, pois são como você, vão responder suas questões rapidamente, precisamente, e completamente!

Em adição, você representa a comunidade de escrita MDN.

Por favor ajude a garantir que nós mantenhamos nosso excelente relacionamento de trabalho com a equipe dev para fazer toda a interação entre eles e a equipe de escrita seja ótima.

Em uma nota de relato, um grande caminho para encontrar a pessoa certa para falar olhe nas listas dos responsáveis dos módulos.

A comunidade de escrita

A comunidade de escrita é muito grande. Enquanto o número de frequentes extremos, ou contribuidores de grande escala é relativamente pequeno, Há muitas dezenas ou centenas de pessoas que contribuem de vez em quando. Felizmente, estas são grandes pessoas maravilhosas com um genuíno amor da web, Mozilla, e/ou documentação, e interagem com eles e quase sempre muito bonito.

Veja o artigo una a comunidade para mais informações sobre a comunidade MDN.

O lugar mais frequente que você irá diretamente interagir com outros escritores é no canal #mdn do IRC. Este canal é especificamente reservado para discussões sobre documentação. Para IRC-dicas de etiqueta especifica, veja o artigo de suporte da Mozilla, veja o artigo de suporte "Inicie com IRC". "Você também terá discussões conosco no dev-mdc mailing list. Em geral, IRC tende a ser usado para rapidamente, mais pessoas na discussão enquanto a lista de e-mail é tipicamente usada numa conversa de longa duração. Seja guardando na mente General etiquette guidelines, você encontrará aqueles usualmente coisas para muito smoothly.

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: MarceloBRN, FLR, mak213k, RenanBirck
 Última atualização por: MarceloBRN,