Github Brasil

Dúvida?
Email github-owners  mozilla.org Bugzilla mozilla.org :: Github: Administração irc #github on moznet

Notícias

• A partir de 20 de junho de 2016, todos os membros devem ter habilitado 2FA Você será notificado se impacta você.

Recomendações e FAQ

Onde eu posso realizar mais perguntas?

• Envie um email para github-owners  mozilla.org e nós responderemos imediatamente! Nós também estamos no canal #github no IRC.

Como eu posso enviar um novo aplicativo para um repositório da org. mozilla?

Desenvolvedoras de aplicativos podem facilmente impactar muitos outros repositórios além do inicial. Por estas razões, os seguintes passos são fortemente encorajados:

1. Crie você mesmo um novo usuário no GitHub para este repositório.
2. Faça deste usuário o administrador do repositório (ou repositórios) temporariamente.
3. Se autentique com o novo usuário do GitHub e configure a aplicação do terceiro.
4. Volte e se autentique com seu usuário normal.
5. Tente reduzir o acesso daquele usuário administrador do repositório para acesso somente de leitura.
6. Se passo (5) não funcionar, pelo menos a aplicação do terceiro não terá acesso as contas de usuários normais (incluindo repositórios privados).

• Autorizar uma aplicação para trabalhar com GitHub utiliza as permissões que sua conte tem -- então, qualquer repositório que você tenha acesso a aplicação também terá acesso (incluindo acesso privado). Se você quer permitir acesso para uma aplicação que ninguém na organização Mozilla tenha utilizado, você verá um botão para "Requisitar acesso" durante o fluxo de configuração. Você precisará clicar naquele botão para requisitar aprovação. Veja abaixo um exemplo:

• Em alguns casos, a aplicação não necessitará de aprovação para funcionar corretamente, como ela tem acesso de leitura a qualquer repositório público. (Algumas aplicações só querem ter acesso de escrita para ajudá-lo a configurar a aplicação na primeira vez.)

• Em outros casos, a aplicação necessitará de permissão de escrita, e/ou permissão de leitura em repositório privado. Nesses casos, é conveniente enviar os detalhes para o responsável da equipe, seja por reportando um bug ou email.

Revisando responsáveis e permissões

Como um criador ou um administrador de repositório você é responsável por manter a lista de pessoas com acesso ao seu projeto. Por favor seja ativo e prudente enquanto mantém a lista.

Posso ser um responsável da Organização Mozilla?

Os responsáveis por grupos no GitHub tem total poder administrativo e serão limitados a um pequeno grupo de pessoas e revisores regularmente. Se uma pessoa é responsável espera-se participação ativa no grupo e suporte aos outros quando requisitado. Outros responsáveis serão adicionados quando surgir a necessidade (por exemplo, suporte em outro fuso horário) conforme determinado pelos atuais responsáveis.

Todos os responsáveis deverão ter ativo 2FA para suas credenciais no GitHub. (Todo mundo deveria.)

Posso ser um membro da Organização Mozilla?

Com as melhorias recentes do GitHub (2015), nós encorajamos (fortemente) seguir as diretrizes, que recomenda a criação de equipes no GitHub. Lembrando que, todos os membros da Organização Mozilla no GitHub concordam em serem vinculados ao Requisitos de Acesso para Submissão da Mozilla, como prática.

• "Colaborador externo": administradores do respositório podem conceder acesso para qualquer usuário que possua uma conta no GitHub como colaborador externo. "Colaboradores externos" são análogos ao "Nível 1a" de acesso aos repositórios hospedados pela Mozilla.
• "Membros da equipe": Mantedores de equipes podem adicionar usuários do GitHub a uma equipe, se eles já forem membros da organização. Se você ainda não é um membro da organização, o administrador da equipe deve requerer sua adição a sua equipe, como um atestado. "Membros de equipe" são análogos ao "Nível 2" ou "Nível 3", com a diferença sendo o repositório gerenciado pela equipe.

Note: A partir de 30 de Junho de 2016, todos os membros da Organização Mozilla no GitHub DEVEM ter 2FA ativo.

Note: Contas para automação também devem ter 2FA ativo. Scripts devem utilizar tokens de acesso com permissões mínimas somente para execução da tarefa.

Algumas pessoas estão interessadas em se tornar membros da Organização Mozilla no GitHub como uma forma de demonstrar suas contribuições com o Projeto Mozilla. Obrigado pela sua ajuda! E existe um lugar melhor para demonstrar seu trabalho. Por favor verifique no FAQ sobre este processo.

Devo criar uma organização separada no GitHub ou somente criar um repositório em uma existente?

Esta é uma decisão pessoal. Se você tem um projeto ou uma organização grande o suficiente, sinta-se livre para escolher. Sugerimos usar as estratégias e recomendações neste documento como modelo para gerenciar os detalhes.

Forking vs Transferência

Não "fork" um repositório dentro de uma Organização Mozilla. Fazendo isso dá direito a todas as equipes na organização a fazerem também.

Se você criou um repositório na sua própria conta (por exemplo, meuusuario/meurepositorio) e isso deveria estar em uma Organização Mozilla, aqui estão os passos para isso:

Note: Assim que você transferir, seu repositório estará no "limbo" (somente você terá acesso de escrita) até que você tenha assistência de um administrador da organização que possa realizar as alterações. Por favor planeje com antecedência se o tempo for crítico.

1. Se vocẽ não é membro de nenhuma equipe, converse com um administrador da organização.
2. Dentro do repositório administrado, transfira a posse para a Organização Mozilla. Se vocẽ não conseguir ver esta opção, volte para o passo 1.
3. Escolha quais equipes devem ser dadas acesso. Todas as equipes escolhidas terão somente acesso de leitura neste ponto.
4. Peça a um administrador da organização para conceder permissões de acesso maior que leitura ('escrita' e 'admin' são outras opções). (Mantenedores de equipes não tem capacidade de mudar o estado de repositórios.)
5. Fork o repositório da Mozilla (mozilla/meurepo) de volta para sua conta (recriando meuusuario/meurepo). Enquanto o repositório transferido se torna a base no GitHub (e.g. todos os forks são agora forks de mozilla/meurepo) outros usuários podem estar apontando para seu repositório pela URL. (Opcional, GitHub irá redirecionar URLs antigas para as transferências, mas você provavelmente deseja um repositório local se quiser usar o fluxo de PR.)

Eu preciso ser um dono para criar repositórios?

Não. Se uma pessoa tem acesso de leitura/escrita a outro repositório naquela organização elas podem criar mais repositórios nesta organização. No entanto, é recomendado que você crie repositório no contexto de equipe.

Existem requisitos para quando ou como eu devo criar uma nova equipe?

Não. Quando requisitos eram propostos eles pareciam muito rígidos e demorados. Em vez disso nós recomendamos manter a flexibilidade e utilização de boas nomeclaturas e documentação para projetos (semelhanças ao nomear classes CSS ou variáveis).

Em grandes equipes recomendamos que você separe equipes para leitura/escrita e administração dos repositórios.

"mozilla" é a única "organização" no GitHub referente a Mozilla?

Não, existem muitas "organizações" no GitHub relacionadas a Mozilla. Como princípio básico, iniciativas que criam um grande número de sub-repositórios criarão suas próprias "organizações". Aqui está (provavelmente incompleta) uma lista delas:

Existem outros repositórios não-oficiais ou repositórios relacionados a Mozilla no GitHub?

Sim! Sem ordem relacionada:

• https://github.com/kinetiknz/nestegg/ : WebM demultiplexador
• https://github.com/xiph/opus/ : Compressão de áudio moderna para internet.
• https://github.com/webmproject/libvpx : Somente espelho. Por favor não envie _pull requests_.
• https://github.com/campd/fxdt-adapters : Adaptadores de Protocolos para as Ferramentas para Desenvolvimento Firefox.
• https://github.com/kripken/emscripten : Emscripten: Um compilador LLVM-para-JavaScript.
• https://github.com/bbondy/codefirefox : Site com tutorial em vídeo e exercícios para desenvolver para Firefox e outras tecnologias relacionadas a Mozilla.
• https://github.com/nickdesaulniers/where-is-firefox-os : Um mapa mostrando onde no mundo os telefones com Firefox OS foram vendidos.
• https://github.com/jdm/bugsahoy : Uma página para tornar fácil o descobrimento de _bugs_ relevantes para novos contribuidores Mozilla.
• https://github.com/w3c/web-platform-tests : Suite de teste para especificações de plataformas Web.
• https://github.com/w3c/wptserve : Um servidor Web desenvolvido para o uso com a Plataforma de testes para Web.
• https://github.com/w3c/wptrunner : Executor multi-plataformas de testes para diferentes navegadores para testes de plataformas Web. Utilizado no mozilla-central e servo.
• https://github.com/w3c/testharness.js : (sem descrição)
• https://github.com/jdm/asknot : Não pergunte o que a Mozilla pode fazer por você mas o quê você pode fazer pela Mozilla.
• https://github.com/jeffbryner/MozDef: Plataforma Mozilla Defense.
• https://github.com/jgraham/webdriver-rust: Biblioteca WebDriver para Rust.