aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/mdn/comunidade/trabalhando_em_comunidade/index.html
blob: 38d851532daca5f86ebf06102473ac44a5e36034 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
---
title: Trabalhando em comunidade
slug: MDN/Comunidade/Trabalhando_em_comunidade
translation_of: MDN/Community/Working_in_community
---
<div>{{MDNSidebar}}</div>

<p>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.</p>

<h2 id="Dicas_gerais_de_etiqueta">Dicas gerais de etiqueta</h2>

<p>Aqui estão algumas dicas gerais de conduta quando trabalhando na comunidade Mozilla.</p>

<ul>
 <li>Seja educado! Mesmo em discordância, todos nós temos a mesma missão: melhorar a Web.</li>
 <li>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.</li>
 <li>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.</li>
 <li>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.</li>
 <li>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.</li>
 <li>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.</li>
 <li>Evite a {{interwiki("wikipedia", "Lei da trivialidade")}}. Não deixe seu entusiasmo virar pedantice chata. Isso faz com que as conversas fiquem cansativas e percam o foco.</li>
</ul>

<h2 id="Tenha_sensatez">Tenha sensatez</h2>

<p>Sempre seja sensato e respeitoso quando se comunicar com os outros.</p>

<h3 id="Gentilmente_aponte_os_erros">Gentilmente aponte os erros</h3>

<p>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.</p>

<p>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):</p>

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

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

<p>Obrigado novamente, e aguardo suas futuras contribuições!</p>
</blockquote>

<h2 id="Compartilhe_conhecimento">Compartilhe conhecimento</h2>

<p>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.</p>

<h3 id="Canais_de_comunicação">Canais de comunicação</h3>

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

<h4 id="Bugzilla">Bugzilla</h4>

<p>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 <a href="https://bugzilla.mozilla.org/page.cgi?id=etiquette.html">etiqueta Bugzilla</a> em mente em todas às vezes!</p>

<h4 id="E-mail">E-mail</h4>

<p>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.</p>

<div class="note">
<p><strong>Nota:</strong> Como regra geral, <span id="result_box" lang="pt"><span>se alguém postou o endereço de e-mail pessoal em documentos sobre a tecnologia que você está documentando</span></span>, ou deu a você o endereço de e-mail pessoal, <span id="result_box" lang="pt"><span>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"</span></span>. <span id="result_box" lang="pt"><span>Se você precisa "escavar" mais sobre o assunto, provavelmente você deve tentar obter aguma permissão no Matrix ou em uma lista de discussão primeiro, a menos que você tenha esgotado todas as outras tentativas de entrar em contato.</span></span></p>
</div>

<h3 id="Ferramenta_de_status_de_conteúdo">Ferramenta de status de conteúdo</h3>

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

<dl>
 <dt><a href="/dashboards/revisions">Painel de Controle (<em>Dashboard</em> ) para revisão</a></dt>
 <dd>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, <span id="result_box" lang="pt"><span>abrir rapidamente a página, ver um histórico completo ou até reverter as alterações (se você tiver esses privilégios)</span></span>.</dd>
 <dt><a href="https://developer.mozilla.org/en-US/docs/MDN/Doc_status/Overview">Visão geral do status da documentação </a></dt>
 <dd><a href="https://developer.mozilla.org/en-US/docs/MDN/Doc_status/Overview">Nossa visão geral do status da documentação</a> 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.</dd>
 <dt><a href="/en-US/docs/MDN/Plans">Documentação dos planos de projetos</a></dt>
 <dd>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.</dd>
 <dt><a href="https://trello.com/b/HAhl54zz/status">MDN Trello board</a></dt>
 <dd>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 <a href="/en-US/docs/MDN/Contribute/Community/Trello">this page</a>.</dd>
</dl>

<h3 id="A_comunidade_de_desenvolvimento">A comunidade de desenvolvimento</h3>

<p>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!</p>

<p>Em adição, você representa a comunidade de escrita MDN.</p>

<p>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.</p>

<p>Em uma nota de relato, um grande caminho para encontrar a pessoa certa para falar olhe nas <a href="https://wiki.mozilla.org/Modules">listas dos responsáveis dos módulos.</a></p>

<h2 id="A_comunidade_de_escrita">A comunidade de escrita</h2>

<p>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.</p>

<p>Veja o artigo <a href="/en-US/docs/MDN/Community">una a comunidade</a> para mais informações sobre a comunidade MDN.</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li><a href="/pt-BR/docs/Project:MDN/Contributing" title="/en-US/docs/Project:MDN/Contributing">Contribuindo para o MDN</a></li>
 <li><a href="/pt-BR/docs/Project:MDN/Contributing/Join_the_community" title="/pt-BR/docs/Project:MDN/Contributing/Join_the_community">Comunidade MDN</a></li>
 <li><a href="http://matt.might.net/articles/how-to-email/" title="http://matt.might.net/articles/how-to-email/">Como enviar e responder um e-mail</a></li>
 <li><a href="http://blog.gerv.net/2012/10/how-to-be-a-mozillia/">Como ser um<em> Mozillian</em></a></li>
</ul>