Início Rápido para Projects

Introdução

Este guia demonstra como usar Projects para planejar e acompanhar um trabalho. Neste guia, você criará um projeto, personalizará exibições e adicionará campos personalizados para gerenciar uma lista de pendências de equipe, planejamento de iteração e um roteiro de equipe para comunicar prioridades e progresso com seus colaboradores. Você também configurará fluxos de trabalho internos para gerenciar automaticamente os itens em seu projeto e gráficos para visualizar os itens em seu projeto.

Pré-requisitos

Você pode criar um projeto de organização ou um projeto de usuário. Para criar um projeto de organização, você precisa de uma organização de GitHub. Para obter mais informações sobre como criar uma organização, confira Criar uma organização do início.

Neste guia, você adicionará problemas existentes de repositórios pertencentes à sua organização (para projetos de organização) ou por você (para projetos de usuário) ao seu novo projeto. Para obter mais informações sobre como criar problemas, confira Criar um problema.

Criando um projeto

Primeiro, crie um projeto de organização ou um projeto de usuário.

Criando um projeto de organização

1. No canto superior direito de GitHub, selecione sua foto de perfil e clique em Your organizations.

2. Clique no nome da sua organização.

3. No nome da organização, clique em Projetos.

   

4. Clique em Novo projeto.

5. Selecione o tipo de projeto ou modelo que você deseja usar.

   • Para criar um projeto em branco, em "Começar do zero", clique em Tabela, Roteiro ou Quadro.
   • Para criar um projeto a partir de um modelo, clique no modelo que você deseja usar. Você pode selecionar entre os modelos internos selecionados por GitHub, os modelos criados por sua organização e os modelos recomendados que foram escolhidos por sua organização.

6. Opcionalmente, se você selecionou um modelo, revise os campos, exibições, fluxos de trabalho e insights que serão criados.

7. Na caixa de texto em "Nome do projeto", digite um nome para o novo projeto.

8. Clique em Criar projeto.

Criando um projeto de usuário

1. No canto superior direito do GitHub, selecione sua foto de perfil e selecione Seu perfil.

   

2. Em seu perfil, clique em Projetos.

   

3. Clique em Novo projeto.

4. Selecione o tipo de projeto ou modelo que você deseja usar.

   • Para criar um projeto em branco, em "Começar do zero", clique em Tabela, Roteiro ou Quadro.
   • Para criar um projeto a partir de um modelo, clique no modelo interno que você deseja usar.

5. Opcionalmente, se você selecionou um modelo, revise os campos, exibições, fluxos de trabalho e insights que serão criados.

6. Na caixa de texto em "Nome do projeto", digite um nome para o novo projeto.

7. Clique em Criar projeto.

Configurando a descrição e o README do seu projeto

Você pode definir a descrição e o LEIAME do projeto para compartilhar a finalidade do projeto, fornecer instruções sobre como usá-lo e incluir os links relevantes.

1. Procure seu projeto.

2. No canto superior direito, clique em para abrir o menu.

   

3. No menu, clique em Configurações para acessar as configurações do projeto.

4. Para adicionar uma breve descrição ao projeto, em "Adicionar uma descrição", digite a descrição na caixa de texto e clique em Salvar.

5. Para atualizar o LEIAME do projeto, em "LEIAME", digite o conteúdo na caixa de texto.

   • Você pode formatar o LEIAME usando o Markdown. Para saber mais, confira Sintaxe básica de gravação e formatação no GitHub.
   • Para alternar entre a caixa de texto e uma visualização das alterações, clique em ou .

6. Para salvar as alterações no LEIAME, clique em Salvar.

Veja e faça alterações rápidas na descrição e no LEIAME do projeto navegando até o projeto e clicando em no canto superior direito.

Como adicionar itens ao seu projeto

Adicione alguns itens ao seu projeto.

1. Coloque o cursor na linha inferior do projeto, ao lado do .

   

2. Cole a URL do problema ou pull request.

3. Para adicionar o problema ou a solicitação de pull, pressione Return/Enter.

Repita as etapas anteriores algumas vezes para adicionar vários itens ao projeto.

Para obter mais informações sobre outras maneiras de adicionar problemas ao seu projeto ou sobre outros itens que você pode adicionar ao projeto, confira Adicionar itens ao seu project.

Adicionando rascunhos de problemas ao seu projeto

Em seguida, adicione um rascunho ao seu projeto.

1. Coloque o cursor na linha inferior do projeto, ao lado do .

   

2. Digite sua ideia e pressione ENTER.

3. Para adicionar texto, clique no título do problema do rascunho. Na caixa de entrada markdown exibida, insira o texto do corpo do problema de rascunho e clique em Salvar.

Adicionar campos

Depois, crie campos personalizados para gerenciar a iteração, a prioridade e as estimativas dos itens do projeto.

Como criar um campo de iteração

Crie um campo de iteração para que você possa planejar e acompanhar seu trabalho ao longo de blocos de tempo que se repetem. As iterações podem ser configuradas de acordo com a maneira com que você e a sua equipe trabalham, com durações personalizáveis e a capacidade de inserir quebras.

1. Na exibição de tabela, clique em no cabeçalho do campo mais à direita.
   
2. Clique em Novo campo.
3. Na parte superior do menu suspenso, digite o nome do novo campo.
4. Selecione Iteração
5. Para alterar a duração de cada iteração, digite um novo número, selecione o menu suspenso e clique em dias ou semanas.
6. Clique em Save (Salvar).

Especifique uma iteração para todos os itens em seu projeto.

Como criar um campo de prioridade

Agora, crie um campo personalizado nomeado Priority e que contenha os valores: High, Medium ou Low.

1. Na exibição de tabela, clique em no cabeçalho do campo mais à direita.
   
2. Clique em Novo campo.
3. Na parte superior do menu suspenso, digite o nome do novo campo.
4. Escolha Seleção única
5. Abaixo de "Opções", digite a primeira opção, "Alto".
6. Para adicionar campos adicionais, para "Médio" e "Baixo", clique em Adicionar opção.
7. Clique em Save (Salvar).

Especifique uma prioridade para todos os itens no seu projeto.

Como criar um campo de estimativa

Crie um campo personalizado chamado Estimate para acompanhar a complexidade de cada item.

1. Na exibição de tabela, clique em no cabeçalho do campo mais à direita.
   
2. Clique em Novo campo.
3. Na parte superior do menu suspenso, digite o nome do novo campo.
4. Selecione Número
5. Clique em Save (Salvar).

Especifique uma estimativa para todos os itens no projeto.

Criando exibições

Crie modos de exibição para visualizar seus itens em uma tabela, quadro e roteiro.

Para saber mais sobre como personalizar exibições, confira Personalizar exibições em seu project.

Como criar uma lista de pendências de equipe

Você pode usar um layout de tabela para visualizar a lista de pendências da equipe como uma planilha, permitindo que você exiba muitos campos e faça edições.

Selecione campos visíveis para sua exibição para comunicar a prioridade e o progresso da lista de pendências da equipe.

1. Na exibição de tabela, clique em no cabeçalho do campo mais à direita.

   

2. Em "Campos ocultos", clique em Status, Assignees, Linked pull requests, Priority e Estimate.

Em seguida, agrupe todos os itens do seu projeto por prioridade para facilitar o foco nos itens de alta prioridade.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Group.

3. Clique em Prioridade.

Agora, transfira os itens entre grupos para alterar a prioridade.

1. Escolha um item.
2. Arraste e solte o item para um grupo de prioridade diferente. Ao fazer isso, a prioridade do item passará a ser a prioridade do seu novo grupo.

Você também pode mostrar a soma do campo Estimate para cada grupo de prioridade.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Field sum.

3. Selecione Estimar.

Quando você agrupa os itens por prioridade e adiciona uma soma de campo nas etapas anteriores, seu projeto exibe um indicador para mostrar que a exibição foi modificada. Salve essas alterações para que os seus colaboradores vejam as tarefas agrupadas por prioridade.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Salvar alterações.

Você pode compartilhar a URL com seu time para manter todos alinhados com as prioridades do projeto. Quando a visualização é salva, qualquer pessoa que abrir o projeto verá a visualização salva. Aqui, você agrupou por prioridade, mas você também pode adicionar outros modificadores como ordenação, filtro ou layout.

Por fim, para indicar o propósito da visão, dê um nome descritivo.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Rename view.

3. Digite o novo nome da sua exibição.

4. Para salvar as alterações, pressione Return/Enter.

Em seguida, você criará novas exibições com layouts diferentes.

Para saber mais sobre como personalizar tabelas, confira Personalizar o layout de tabela.

Como criar um modo de exibição de quadro de iteração semanal

Para exibir o progresso dos itens do projeto em um quadro kanban, você pode usar o layout do quadro. O layout do quadro é baseado no campo de status por padrão. Portanto, especifique um status para cada item no seu projeto.

Primeiro, crie uma exibição.

1. À direita das exibições existentes, clique em Nova exibição
   

Em seguida, alterne para o layout do quadro.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Em "Layout", clique em Quadro.

Para indicar o propósito da visão, dê um nome descritivo.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Rename view.

3. Digite o novo nome da sua exibição.

4. Para salvar as alterações, pressione Return/Enter.

Adicione um filtro para iteration:@current para incluir apenas itens da iteração atual.

Você também pode mostrar a soma do campo Estimate para cada coluna de status.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Field sum.

3. Selecione Estimar.

Quando você adicionou um filtro e uma soma de campo nas etapas anteriores, seu projeto exibiu um indicador para mostrar que a exibição foi modificada. Salve esta visualização para que você e seus colaboradores possam acessá-la facilmente no futuro.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Salvar alterações.

Para saber mais sobre como personalizar quadros, confira Personalizando o layout do quadro.

Como criar um roteiro de equipe

Para exibir os itens do projeto em uma linha do tempo, você pode usar o layout de roteiro. Os roteiros usam campos personalizados de data e iteração para posicionar seus problemas e suas pull requests e para criar rascunhos de itens em uma linha do tempo, permitindo que você acompanhe o trabalho ao longo do tempo e observe o progresso.

Primeiro, crie uma exibição.

1. À direita das exibições existentes, clique em Nova exibição
   

Depois, alterne para o layout do roteiro.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Em "Layout", clique em Roadmap.

Você pode adicionar marcadores verticais em um roteiro para mostrar os marcos associados aos itens em seu projeto.

1. No canto superior direito do roteiro, clique em Markers.

   

2. No menu, selecione quais marcadores você deseja exibir no roteiro.

Quando você adicionou marcadores, seu projeto exibiu um indicador para mostrar que a exibição foi modificada. Salve esta visualização para que você e seus colaboradores possam acessá-la facilmente no futuro.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Salvar alterações.

Para indicar o propósito da visão, dê um nome descritivo.

1. Clique em ao lado do nome da exibição aberta no momento.

   

2. Clique em Rename view.

3. Digite o novo nome da sua exibição.

4. Para salvar as alterações, pressione Return/Enter.

Para saber mais sobre como personalizar roteiros, confira Personalizando o layout do roteiro.

Como configurar a automação integrada

Em seguida, configure o fluxo de trabalho de adição automática para adicionar automaticamente problemas abertos em um repositório com um rótulo específico ao seu projeto.

1. Procure seu projeto.

2. No canto superior direito, clique em para abrir o menu.

   

3. No menu, clique em Fluxos de trabalho.

4. Na lista "Fluxos de trabalho padrão", clique em Adicionar automaticamente ao projeto.

5. Para começar a editar o fluxo de trabalho, no canto superior direito, clique em Editar.

   

6. Em "Filtros", selecione o repositório ao qual você deseja adicionar itens.

7. Ao lado da seleção do repositório, digite os critérios de filtro que você deseja que sejam correspondentes aos itens antes de serem adicionados automaticamente ao seu projeto. Por exemplo, para capturar todos os problemas e pull requests abertas com o rótulo "pergunta", use is:issue,pr label:question.

8. Para ativar o novo fluxo de trabalho, clique em Salvar e ativar o fluxo de trabalho.

Por fim, adicione um fluxo de trabalho interno para definir o status como Tarefas Pendentes quando um item for adicionado ao projeto.

1. No canto superior direito, clique em para abrir o menu.
   
2. No menu, clique em Workflows.
3. Em Fluxos de trabalho padrão, clique em Item adicionado ao projeto.
4. Ao lado de Quando, verifique se issues e pull requests estão selecionados.
5. Ao lado de Definir, selecione Status:Tarefa Pendente.
6. Clique na alternância Desabilitado para habilitar o fluxo de trabalho.

Para obter mais informações sobre como automatizar seu projeto e outros fluxos de trabalho padrão que você pode configurar para manter seus itens de projeto atualizados, confiar Automatizar seu project.

Como exibir gráficos e insights

Você pode usar os insights dos Projects para exibir, criar e personalizar gráficos que usam os itens adicionados ao seu projeto como dados de origem. Você pode aplicar filtros ao gráfico padrão e criar seus próprios gráficos escolhendo o agrupamento, o layout, o eixo X e a configuração do eixo Y.

1. Procure seu projeto.
2. No canto superior direito, para acessar os insights, clique em .
   
3. No menu à esquerda, clique em Novo gráfico.
4. Opcionalmente, para alterar o nome do novo gráfico, clique em , digite um novo nome e pressione Return.
5. Acima do gráfico, digite os filtros para alterar os dados utilizados para a construção do gráfico. Confira Filtrar projects.
6. À direita da caixa de texto do filtro, clique em Salvar alterações.

Para saber mais, confira Sobre insights para Projects.

Leitura adicional

• Melhores práticas para Projects
• Gerenciar itens em seu project
• Noções básicas sobre campos