Como criar um projeto
O GitHub Projects é uma poderosa ferramenta de planejamento e acompanhamento que oferece à sua equipe exibições flexíveis, como tabelas, quadros e linhas do tempo, para organizar seu trabalho e ver o quadro geral.
Imagine que você deseja gerenciar o backlog de recursos da sua equipe em um só lugar. Essa ferramenta interna facilita a organização, a priorização e o acompanhamento de tudo em uma única exibição.
Nesta unidade, você aprenderá a:
- Crie um projeto.
- Defina o nome, a descrição e o README do seu projeto.
- Adicione problemas e pull requests ao seu projeto.
Criando um Projeto de propriedade da organização
Primeiro, é recomendável estabelecer a base criando um novo projeto. A criação é relativamente rápida e simples.
No canto superior direito do GitHub.com, selecione sua foto de perfil e selecione Suas organizações.
Captura de tela do menu suspenso Perfil que inclui Seu perfil, Seus repositórios, Seus Codespaces, Suas organizações e Suas empresas com a opção Sua organização destacada.
Role para baixo para selecionar a organização para o novo projeto.
Navegue a partir da guia Visão geral até a guia Projetos.
Selecione o botão verde chamado Novo projeto.
Um pop-up solicita que você selecione um modelo ou comece do zero. Vamos escolher a opção Iniciar do zero e selecionar Tabela.
Selecione o botão verde Criar projeto.
Você acabou de criar um projeto!
Dica
Você também pode criar um Projeto pessoal selecionando sua foto de perfil e navegando até Seus projetos e clicando em Novo projeto.
Além disso, os projetos podem ser criados diretamente de um repositório— isso vincula o repositório ao Projeto automaticamente, embora o projeto em si ainda seja criado no nível da organização e possa ser vinculado a outros repositórios ou projetos no futuro.
Defina o nome, a descrição e o README do seu projeto
Vamos definir seu projeto de duas maneiras diferentes para que sua equipe possa entender facilmente o que você está acompanhando.
Navegue até o projeto recém-criado para editar o nome, a descrição e o arquivo README do projeto.
No canto superior direito da página, selecione os três pontos para abrir o menu e selecione Configurações.
Nome do projeto é onde você edita o nome do projeto.
Breve descrição permite que você adicione algumas informações sobre o projeto.
README permite que você adicione informações para que sua equipe entenda por que você criou esse projeto e o que espera realizar com ele. Depois de terminar, selecione Salvar alterações.
Adicione problemas e pull requests ao seu projeto
Adicionar problemas e pull requests ao seu projeto é o que torna a ferramenta tão poderosa. O Projects permite que você saiba o status das tarefas nas quais sua equipe está trabalhando para coordenar e concluir suas metas.
Vamos percorrer as diferentes maneiras de adicionar problemas e pull requests ao seu projeto.
Adicionar um problema e uma pull request existente
Copie o URL de um problema ou pull request existente.
Coloque o cursor na linha inferior do projeto ao lado de + e cole o URL do seu problema ou pull request.
Pressione Enter e seu problema ou pull request será exibido como uma tarefa em seu projeto.
Pesquisar um problema e uma solicitação de pull existente
Você pode pesquisar problemas ou pull requests existentes adicionando um novo item.
Insira # para pesquisar os repositórios. Você pode digitar parte do nome do repositório para restringir suas opções.
Selecione o repositório onde o pull request ou problema está localizado, o que solicitará a pesquisa de problemas e pull requests.
Comece a digitar o título do problema ou pull request para localizar o que você deseja.
Selecione o problema ou pull request.
Adição em massa de problemas e pull requests
Você pode adicionar problemas e efetuar pull requests em massa a um repositório existente para economizar tempo. Isso permite que você comece a organizar sua equipe mais rapidamente.
Selecione + na linha inferior do projeto.
Selecione Adicionar item no repositório.
Para alterar o repositório, selecione a lista suspensa e escolha um repositório. Os problemas e pull requests são então preenchidos.
Você pode selecionar todos ou selecionar os problemas ou pull requests que deseja incluir.
Quando estiver pronto para adicionar os problemas e pull requests ao seu projeto, selecione o botão verde intitulado Adicionar itens selecionados no canto inferior direito.
Fluxos de trabalho do projeto
Para ajudar a simplificar o trabalho, o GitHub Projects dá suporte a fluxos de trabalho padrão. Isso permite que itens como problemas e solicitações de pull sejam adicionados automaticamente a um Projeto e marcados com um status inicial, como "Todo".
Para habilitar um fluxo de trabalho:
- Abra seu Projeto.
- Selecione o menu de três pontos no canto superior direito e escolha Fluxos de Trabalho.
- Escolha um gatilho como "Item adicionado ao projeto".
- Defina valores, como Status: Todo.
- Selecione Salvar e ativar o fluxo de trabalho.
Converter itens de lista de verificação em sub-problemas
A partir de fevereiro de 2025, o GitHub Projects dá suporte à conversão de itens de lista de verificação em sub-problemas. Esse recurso facilita a separação de tarefas em itens de trabalho menores e rastreáveis, diretamente de um problema.
Para converter um item de lista de verificação:
- Crie ou abra um problema que contenha uma lista de verificação.
- Passe o mouse sobre o item da lista de verificação.
- Clique no menu ... ao lado do item.
- Selecione Converter em sub-problema.
Isso cria um problema vinculado que aparece no modo de exibição Projetos com seu próprio status, metadados e acompanhamento. Os subemissões fornecem melhor visibilidade do trabalho relacionado e substituem o recurso de bloco da lista de tarefas mais antigo, que foi preterido em 30 de abril de 2025.
Na próxima unidade, você aprenderá a organizar e priorizar seu projeto para manter as tarefas no caminho certo.