Trabalhando em comunidade

Houve um erro de script nesta página. Enquanto este erro é encaminhado para os editores do site, você pode ver o conteúdo parcial abaixo.

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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 exigí-la. Ainda que o trabalho de documentação seja importante, e a 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 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 uma equipe multinacional, Então quando contatar alguém desta cultura e, ou pode ser, diferente de você, seja claro e mantenha em mente isto enquanto se comunica.
  • Inicie uma nova conversa em vez de sequestrar uma conversa existente. Não injete suas questãos dentro de uma conversa não relacionada somente porque a pessoa que você precisa falar está prestando atenção nisto. Enquanto conveniente para você, isto pode irritar a pessoa que você está tentando falar, e resultar em menos do que um resultado ideal.
  • Evite o {{interwiki("wikipedia", "bikeshedding")}}. 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.

Polidamente pontue os erros

Se seu propósito em contatar alguém é para pedi-los para fazer alguma coisa diferentemente, ou pontuar enganos eles estão fazendo (especialmente se eles repetidamente fazem isto), inicie sua mensagem com um comentário positivo. Isto suaviza o impacto, então para falar, e isto demonstra que você está tentando ser prestativo, melhor do que 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 (

For example, if a new contributor has been creating lots of pages without tags, and you'd like to point out this problem, your message to them might look like this (o caso que você precisa mudar para cada caso está sublinhado):

Oi, MrBigglesworth, Eu tenho que notificar seus contribuidores para a documentação da API do buraco de minhoca  e isto é fantástico ter sua ajuda! Eu particularmente como você balanceia seu nível de detalhes com legibilidade. Isto diz, apesar disto, você pode fazer estes artigos sempre melhores e mais útil se você adicionar as corretas tags para as páginas enquanto você vai.

Veja o MDN guia de tags

 (https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Tag) for details.

Obrigado novamente, e eu sigo em frente para suas futuras contribuições!

Compartilhe conhecimento

Como você participa do projeto MDN, isto é útil saber o que está acontecendo, e para interagir com outros membros de sua comunidade. Para tomar com outros em nossa comunidade, você pode conseguir--e compartilhar--idéias, 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 (tanto desenvolvedores ou escritores), cada um tem algumas regras particulares de etiqueta.

IRC

Este é frequentemente o caminho mais rápido e mais direto caminho para abordar alguém: Só pingá-los no IRC. Encontre o canal correspondente para a área tópico que você está escrevendo sobre e somente falar com eles. Para IRC-específica dica de etiquetas, veja o artigo de suporte Mozilla "Comece iniciando com IRC". Para discussões sobre a documentação de desenvolvedor, use o canal {{IRCLink("mdn")}} .

This is often the quickest and most direct way to approach someone: just ping them in IRC. Find the channel corresponding to the topic area you're writing about and just talk to them. For IRC-specific etiquette tips, see the Mozilla Support article "Getting Started with IRC." For discussions about developer documentation, use the {{IRCLink("mdn")}} channel.

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!

Email

Algumas vezes, uma troca de email privada entre você e um ou mais outras pessoas é o caminho para seguir, se você ter o endereço de e-mail deles.

Nota: Como regra geral, se alguém tiver postado endereço de email deles nos documentos sobre a tecnologia que você está documentando, tem dado a você o endereço de email pessoal, ou geralmente tem um bem conhecido endereço de email, email é uma abordagem aceitável "primeiro contato". Se você estiver cavando, você provavelmente deverá tentar ganhar permissão no IRC ou uma lista de email primeiro, ao menos você tem exaustivamente tentado todas as outras tentativas para conseguir contato.

Ferramenta de status de conteúdo

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

Dashboard de revisão
A revisão do dashboard providencia uma ferramenta fantástica para revisar mudanças feitas para o conteúdo do MDN. Você pode ver as histórias recentes, escolha um período de tempo para ver, e filtrar baseado nas coisas como localidade, nome de contribuidores, e topicos. Uma vez que você está olhando para um conjunto de revisões, você pode ver as mudanças feitas em cada revisão, rapidamente abra a página, veja a história total, ou mesmo reverta as mudanças (Se você tem aqueles previlé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 tranbalhos 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--são como você, vão responder suas questõesrapidamente, 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 frequantes 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 {{IRCLink("mdn")}} do IRC. Este canal é especificamente reservado para discussões sobre documentação. Para IRC-dicas de etiqueta especìfica, 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 {{anch("General etiqueta das linhas gerais}}}, voê encontrará aqueles usualmente coisas para muito smoothly.

Veja também

  • Contribuindo para o MDN
  • A comunicação ajuda
  • Vou mandar uma réplica 
  • Pode ser uim smootht 

Etiquetas do documento e colaboradores

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