github projects teams
Este tutorial no GitHub explica conceitos como projetos GitHub, organização e equipes, bifurcação de um repositório, problemas e marcos do projeto, GitHub Wiki etc:
No tutorial anterior da série de tutoriais no GitHub, vimos como um desenvolvedor pode utilizar a plataforma para armazenar os artefatos relacionados ao projeto e o controle de versão da mesma. Também vimos os conceitos em torno de solicitações pull, mesclagem, ramificação e proteção de ramificações.
Bem, isso não é tudo. Neste tutorial, vamos nos aprofundar e descobrir o que mais o GitHub pode fazer pelos desenvolvedores.
=> Confira o Guia de treinamento perfeito do GitHub aqui.
Aqui está o que iremos focar.
- Criar Organização e Equipes
- Fork um repositório
- Criar problemas e marcos do projeto
- Criar quadro de projeto
- Criando GitHub Wiki
O que você aprenderá:
- Criar Organização e Equipes
- GitHub Fork
- Problemas do GitHub e marcos do projeto
- Quadro do projeto GitHub
- Wiki do GitHub para documentação
- Conclusão
- Leitura recomendada
Criar Organização e Equipes
Como um pré-cursor para esta seção, o GitHub fornece os três tipos de contas a seguir.
- Contas de usuário pessoais onde você pode criar repositórios públicos e privados ilimitados e também convidar colaboradores.
- Contas da Organização que é principalmente um conceito de contas compartilhadas e verá mais nesta seção.
- Conta corporativa que é usado por empresas que gerenciam as políticas internamente para os usuários que usam o GitHub. Isso normalmente é usado em uma versão On-Premise do GitHub Enterprise.
Na Parte 1, vimos como um repositório foi criado usando uma única conta pessoal em que esse usuário era o único proprietário do repositório. Isso é adequado para pequenas equipes scrum onde você tem de 3 a 9 pessoas ou talvez mais algumas pessoas ou para criar um repositório para um único projeto, tudo bem.
Mas e se houver grandes projetos Github que precisam de vários repositórios e acesso de várias equipes para os mesmos para a execução? Aqui, precisamos ver como a Organização GitHub ajuda a agrupar vários repositórios para um único projeto grande. Portanto, também haverá vários proprietários, pois haverá vários Repositórios / Equipes envolvidos.
Para começar a criar uma nova Organização, clique no + no canto superior direito e selecione Nova organização.
Selecione um plano adequado. Estaremos usando um plano gratuito por agora que é Equipe de código aberto.
Insira os detalhes sobre a Organização e clique em Próximo.
Adicione os membros à organização e clique em Configuração completa.
A próxima etapa é começar a criar repositórios de acordo com as necessidades do projeto e adicionar equipes aos mesmos.
Você também pode clicar em Convidar alguém para adicionar membros à organização recém-criada. Conforme os membros são adicionados, a função também pode ser atribuída como membro ou proprietário. Para fazer isso vá para o Pessoas Tab e selecione Mudança de papel para esse membro.
Bem, por enquanto, manteremos 1 usuário como proprietário e o outro como membro. Assim, o proprietário pode criar vários repositórios e atribuir equipes aos respectivos repositórios.
Antes de criar repositórios, vamos criar equipes primeiro. Vou ao Times guia e clique em Novo time.
Criaremos 2 equipes, ou seja, Equipe de UI e Equipe de Middleware.
Clique em Crie uma equipe. Assim que a equipe for criada, você pode adicionar membros à equipe conforme mostrado abaixo.
Da mesma forma, crie a outra equipe e adicione membros a ela. Agora você pode ver que existem 2 equipes.
Vamos continuar criando repositórios. Então, como cenário, agora vamos criar 2 repositórios ou seja, um para conter o código relacionado à IU e o outro para conter o código de middleware. As equipes serão designadas de acordo.
Vou ao Repositórios guia e crie um Novo Repositório .
Clique no Criar repositório botão. O próximo é fornecer acesso à equipe de UI ao repositório.
Vou ao Times aba. Clique no Equipe UI e vá para o Repositórios aba. Clique em cada equipe e adicione os repositórios novamente a partir do Repositórios aba.
Adicione o repositório inserindo o nome do repositório.
Certifique-se também Permissão de escrita para os membros da equipe neste repositório, ou seja, os membros da equipe podem ler, clonar e enviar para este repositório.
Da mesma forma, siga as etapas acima para adicionar o repositório de Middleware à outra equipe. Assim, agora temos uma Organização com repositórios dentro dela e as equipes também. Os membros da equipe podem clonar o repositório ao qual têm acesso e trabalhar no mesmo.
GitHub Fork
Bifurque um Repositório e mantenha-o em sincronia com o Repositório original.
Nas seções anteriores e no tutorial anterior, vimos repositórios sendo criados e o código-fonte adicionado a eles. Agora, o que aconteceria se as equipes desejassem testar algumas alterações no código quando o repositório original não é o lugar para isso.
Uma cópia deve ser criada para experimentar quaisquer alterações no código, mantendo o repositório original intacto. Isso é chamado GitHub Forquilha . Para criar um fork, navegue até o repositório que foi criado na conta pessoal e não a organização. Clique em Forquilha no lado superior direito.
Selecione a conta em que você precisa bifurcar o repositório original. Neste caso, selecione a conta da organização onde o repositório será bifurcado.
O repositório agora está bifurcado como Demo-Proj-Org / Demo_Project_Repo_VN . Portanto, qualquer experimento com o código pode ser feito no repositório bifurcado e não no repositório original.
Se alguma mudança foi feita no repositório original, então o repositório bifurcado deve estar em sincronizar . As opções da linha de comando podem ser usadas para sincronizar o repositório bifurcado, mas criar uma solicitação pull é uma opção mais simples.
Supondo que uma mudança seja feita em um arquivo no repositório original, prossiga para criar uma solicitação pull.
exemplo de árvore de pesquisa binária c ++
Clique no link compare entre garfos.
Selecione o cabeçote como o repositório original e a base como o repositório bifurcado conforme mostrado e clique em Crie uma solicitação de pull.
Clique em Merge pull request e confirme a merge.
As alterações aparecem no repositório bifurcado e estão em sincronia com o repositório original.
Problemas do GitHub e marcos do projeto
Normalmente, em cada projeto, é necessário rastrear tarefas, defeitos, melhorias, etc. como parte do progresso. Você pode usar os problemas no GitHub para rastrear todos os mencionados acima junto com os painéis do projeto.
Com problemas, você pode associar o mesmo às solicitações pull para que possa ser fechado automaticamente quando a solicitação pull for mesclada. Além disso, se houver problemas em aberto, eles também podem ser transferidos para outros repositórios. Nesta seção, veremos muito mais sobre como os problemas podem ser usados.
Criação de problemas e marcos
Vá para a página principal do repositório e vá para o Problemas Aba. Clique em Novo problema.
Atribua-o a um colaborador no qual trabalhar, adicione Rótulo para distinguir como um aprimoramento. Uma boa prática é também mencionar sobre o Marco histórico para acompanhar o andamento das questões levantadas.
Clique em Envie um novo problema.
O resumo do problema é exibido. Observe que o número do problema é # 11, que será mencionado mais tarde.
O problema também pode ser transferido para outro repositório. A opção de fazer isso está na parte inferior ‘Problema de transferência’.
Adicione um Data de Vencimento para o marco - R1. Na página principal do repositório vá para o Problemas Tab e clique em Milestones .
Editar os detalhes para o Milestone R1 e adicione uma data de vencimento. Salve as alterações uma vez feitas.
O Milestone R1 agora tem 2 questões em aberto e a% de conclusão também pode ser vista.
Clique no Milestone R1 para ver as edições a serem entregues para este milestone. Os problemas também podem ser priorizados novamente movendo-os para cima e para baixo.
Problemas de filtro
Supondo que haja vários problemas que estão no estado Aberto / Fechado e atribuídos a vários colaboradores. É muito essencial procurar aquelas questões que se baseiam em determinados critérios.
Por exemplo, todos os problemas atribuídos a você, todos os problemas em estado aberto, etc. O GitHub oferece a opção de pesquisa para filtrar os problemas e até mesmo obter solicitações.
Vá para a guia Problemas e na caixa de filtro insira os critérios da seguinte maneira.
Por exemplo, todos os problemas abertos no estado Aberto e atribuídos a um colaborador.
tipo: estado do problema: aberto cessionário: vniranjan2512 marco: R1 rótulo: aprimoramento
Associar problemas à solicitação de pull
Quando uma solicitação pull é referenciada com uma determinada palavra-chave e número de problema e, uma vez mesclado, o problema é automaticamente fechado. Mesmo se um commit for referenciado com a palavra-chave e o número do problema, o problema é encerrado.
A palavra-chave pode ser qualquer, ou seja, fechar, fechar, consertar, consertar, resolver, resolver.
Por exemplo, na solicitação pull ou menção de mensagem de confirmação fecha o nº 11.
Crie uma solicitação de pull e mencione a palavra-chave e o número de referência conforme mostrado na mensagem. Clique em Crie uma solicitação pull e mescle.
O problema é fechado automaticamente na mesclagem da solicitação pull. Um pouco de automação é definitivamente necessário.
Criar ou abrir novos problemas do código-fonte
Para qualquer alteração de código, um novo problema pode ser aberto. Com isso, o URL para a linha de alteração do código é adicionado ao problema. Em um modo de não edição do código, clique nos 3 pontos (...) ao lado da linha de código e selecione Referência em novo problema .
Detalhes do problema atualizados.
Problema de PIN
Você pode fixar o problema para que seja mais fácil encontrá-los e também evitar problemas duplicados de sendo criado.
Abra o problema e, na parte inferior direita do problema, clique em Problema com o PIN.
O problema foi adicionado acima da lista de problemas.
Observação: No máximo 3 problemas podem ser fixados a qualquer momento.
Quadro do projeto GitHub
Um painel de projeto no GitHub fornece uma maneira fácil de visualizar os problemas. Você pode ver o andamento do projeto e ver quais problemas ainda não foram iniciados, em andamento e problemas concluídos.
Um quadro de projeto no GitHub pode ser criado com base em modelos Kanban que possuem um fluxo de trabalho predefinido e também pode ser personalizado. O exemplo mostrará um quadro criado com base na conta do usuário.
Na página principal do repositório vá para o Projetos guia e crie um Novo projeto.
Como você pode ver acima, o painel do projeto ajuda a:
- Classificar tarefas
- Planeje seu projeto
- Automatize seu fluxo de trabalho
- Acompanhar o progresso
- Compartilhar status
- Fechar projeto
Novo quadro de projeto com um modelo Kanban básico.
O quadro é criado com um fluxo de trabalho. Colunas de fluxo de trabalho adicionais também podem ser adicionadas clicando no + Adicionar coluna.
O fluxo de trabalho também pode ser automatizado. Por exemplo, se um novo problema for criado, ele pode ser adicionado diretamente ao Status de tarefas pendentes. Selecione os Gerenciar automação opção para esse status.
fase de teste de ciclo de vida de desenvolvimento de software
Selecione a caixa de seleção Adicionado recentemente e clique em Atualizar automação. Portanto, quando um novo problema é criado, o projeto selecionado para o problema será automaticamente adicionado ao Status de tarefas pendentes. Você também pode arrastar e soltar o problema existente para o status e mover de um status para outro.
A uma coluna, você também pode adicionar notas que garantirão que você forneça algumas informações importantes sobre os problemas dessa coluna. Clique no + assine e adicione uma nota.
Clique em Adicionar.
Wiki do GitHub para documentação
Uma das atividades muito importantes em qualquer projeto é criar e manter a documentação do seu repositório para uso de toda a equipe. O repositório GitHub vem com suporte para criar tal documentação usando GitHub Wiki. Assim, todas as informações sobre seu projeto e seu uso podem ser capturadas no wiki.
Os wikis estão disponíveis para repositórios públicos no GitHub gratuitamente. Os wikis usam a biblioteca de marcação de código aberto. Veremos como usar essa biblioteca ao escrever wikis.
Habilitando Suporte Wiki para Repositório
Na página principal do repositório, clique no botão Configurações guia e certifique-se de que o Wikis opção é selecionada em Características seção.
Crie um Wiki no GitHub
Na página principal do repositório vá para o Wiki aba. Clique em Crie a primeira página.
Insira um título e adicione texto ao Wiki. Além disso, você pode usar a opção de formatação usando o suporte Markdown. Clique no Salvar pagina Uma vez feito.
Observe que o conteúdo acima # é para o título1, ## é para o título2, ### é para o título3. * é usado para listagem não ordenada. A visualização será como mostrado abaixo.
No Wiki clique na guia + Adicionar um rodapé personalizado.
Adicione o conteúdo e salve a página.
Abra qualquer Wiki salvo e você verá o rodapé.
Adicionar barra lateral
Na guia wiki, clique em + Adicione uma barra lateral personalizada.
Adicione conteúdo para a barra lateral e salve a página.
Abra qualquer wiki e você verá a barra lateral.
Ver o histórico do Wiki
No histórico, você pode ver quem fez a alteração, enviar mensagens e a data em que a alteração foi feita.
Abra o Wiki e edite a página. Clique em Histórico da página, do lado direito.
Clique em Hash para ver as mudanças. Selecione as revisões para comparar as alterações e reverter as alterações de uma revisão mais recente. Clique em Reverta as alterações.
As alterações são revertidas para a revisão anterior.
Observação : Você pode reverter as alterações com base na permissão para editar o Wiki.
Conclusão
Nas partes 1 e 2 da série GitHub, vimos atividades de controle de versão, criação de repositórios, solicitações pull, ramificações, revisões de código, organizações e equipes, bifurcação de um repositório, rótulos, marcos, problemas, projetos do GitHub, wikis.
Em nosso próximo tutorial, veremos a criação de lançamentos, integração com Jira e alguns Comandos Git que ajudará os desenvolvedores antes que eles enviem mudanças para o repositório GitHub.
Esperamos que todos os desenvolvedores considerem essa abordagem prática do GitHub útil em seus projetos.
=> Visite aqui para ver a série exclusiva de tutoriais de treinamento do GitHub.
Leitura recomendada
- Tipos de riscos em projetos de software
- Tutorial do GitHub para desenvolvedores | Como usar o GitHub
- Como usar o Microsoft TFS para projetos JAVA com Eclipse no DevOps
- Tutorial do JIRA Agile: Como usar o JIRA com eficácia para gerenciar projetos Agile
- Como o planejamento de teste difere para projetos manuais e de automação?
- Exemplos de asserção de selênio - Aplicações práticas em projetos
- No local - Modelo Offshore de Projetos de Teste de Software (e como fazer funcionar para você)
- Git vs GitHub: explore as diferenças com exemplos