Skip to main content

Criando um projeto (beta)

Aprenda a criar um projeto, preencher e adicionar campos personalizados.

Os projetos são uma coleção personalizável de itens que se mantêm atualizados com os dados do GitHub. Seus projetos podem rastrear problemas, pull requests, e ideias que você anotar. Você pode adicionar campos personalizados e criar visualizações para fins específicos.

Note: Projects (beta) is currently in public beta and subject to change.

Criando um projeto

Criando um projeto de organização

  1. Em GitHub, acesse a página principal da sua organização.

  2. Clique em Projetos.

  3. Selecione o menu suspenso Novo projeto e clique em Novo projeto (Beta).

    Novo projeto

  4. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click Create.

    Screenshot showing template selection modal

Criando um projeto de usuário

  1. On any GitHub page, click on your avatar, then select Your projects.

  2. Selecione o menu suspenso Novo projeto e clique em Novo projeto (Beta).

    Novo projeto

  3. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click Create.

    Screenshot showing template selection modal

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

You can set your project's description and README to share the purpose of your project, provide instructions on how to use the project, and include any relevant links.

  1. Navigate to your project.
  2. In the top-right, click to open the menu.
  3. In the menu, click Settings to access the project settings.
  4. To add a short description to your project, under "Add a description", type your description in the text box and click Save.
  5. To update your project's README, under "README", type your content in the text box.
  6. To save changes to your README, click Save.

You can view and make quick changes to your project description and README by navigating to your project and clicking in the top right.

Adicionando itens ao seu projeto

Seu projeto pode acompanhar os rascunhos de problemas, problemas e pull requests.

Criando problemas de rascunho

Os rascunhos são úteis para capturar ideias rapidamente.

  1. Coloque seu cursor na linha inferior do projeto, ao lado do .
  2. Digite sua ideia e, em seguida, pressione Enter.
  3. Para adicionar texto, clique no título do problema do rascunho. Na caixa de entrada do markdown que será exibida, digite o texto para o texto do problema do rascunho e clique em Salvar.

Os problemas do rascunho podem ter um título, texto, responsável e quaisquer campos personalizados do seu projeto. Para preencher o repositório, etiquetas ou marcos para o rascunho de um problema, você deverá primeiro converter o rascunho do problema em um problema. Para obter mais informações, consulte "Convertendo rascunhos de problema em problemas. "

Observação: Os usuários não receberão notificações quando forem atribuídos ou mencionados em um rascunho de problema, a menos que o rascunho do probelam seja convertido em um problema.

Problemas e pull requests

Cole a URL de um problema ou pull request

  1. Coloque seu cursor na linha inferior do projeto, ao lado do .
  2. Cole a URL do problema ou pull request.

Pesquisando um problema ou pull request

  1. Coloque seu cursor na linha inferior do projeto, ao lado do .
  2. Digite #.
  3. Selecione o repositório onde está localizado o pull request ou problema. Você pode digitar parte do nome do repositório para restringir suas opções.
  4. Selecione o problema ou pull request. Você pode digitar parte do título para restringir suas opções.

Adicionando vários problemas ou pull requests de um repositório

  1. No GitHub.com, acesse o repositório que contém os problemas ou pull requests que você deseja adicionar ao projeto.
  2. No nome do repositório, clique em Problemas ou Pull requests. Problemas e seleção da guia pull requests
  3. À esquerda de cada título do problema, selecione os problemas que você deseja adicionar ao seu projeto. Captura de tela que mostra caixa de seleção para selecionar problema ou pull request
  4. Opcionalmente, para selecionar cada problema ou pull request na página, na parte superior da lista de problemas ou pull requests, selecione tudo. Captura de tela que mostra caixa de seleção para selecionar todos na tela
  5. Acima da lista de problemas ou pull requests, clique em Projetos (beta). Captura de tela que mostra caixa de seleção para selecionar todos na tela
  6. Clique nos projetos aos quais você deseja adicionar os problemas selecionados ou pull requests. Captura de tela que mostra caixa de seleção para selecionar todos na tela

Atribuindo um projeto de dentro de um problema ou pull request

  1. Acesse o problema ou pull request que você deseja adicionar a um projeto.

  2. Na barra lateral, clique em Projetos.

  3. Selecione o projeto ao qual você deseja adicionar o problema ou pull request.

  4. Opcionalmente, preencha os campos personalizados.

    Barra lateral do projeto

Convertendo rascunhos de problemas em problemas

No layout de tabela:

  1. Clique em no rascunho do problema que você deseja converter.
  2. Selecione Converter para problema.
  3. Selecione o repositório ao qual você deseja adicionar o problema.
  4. Como alternativa, edite os campos etiquetas, marco ou repository do rascunho do problema que você deseja converter.

Layout do quadro:

  1. Clique em no rascunho do problema que você deseja converter.
  2. Selecione Converter para problema.
  3. Selecione o repositório ao qual você deseja adicionar o problema.

Removendo itens do seu projeto

Você pode arquivar um item para manter o contexto sobre o item no projeto, mas removê-lo das visualizações do projeto. Você pode excluir um item para removê-lo do projeto completamente.

  1. Selecione o(s) item(ns) para arquivar ou excluir. Para selecionar múltiplos itens, siga um dos passos a seguir:
    • Command+Click (Mac) ou Ctrl+Click (Windows/Linux) em cada item.
    • Selecione um item e, em seguida, Shift+ ou Shift+para selecionar itens adicionais acima ou abaixo do item selecionado inicialmente.
    • Selecione um item e, em seguida, Shift+ clique em outro item para selecionar todos os itens entre dois itens.
    • Insira Command+A (Mac) ou Ctrl+A (Windows/Linux) para selecionar todos os itens em uma coluna em um layout de tabuleiro ou em um layout de tabela.
  2. Para arquivar todos os itens selecionados, digite E. Para excluir todos os itens selecionados, digite Del. Como alternativa, selecione o (no layout de tabela) ou o (no layout do quadro) e, em seguida, selecione a ação desejada.

Você pode restaurar itens arquivados, mas não itens excluídos. Para obter mais informações, consulte Restaurando itens arquivados.

Restaurando itens arquivados

  1. Navigate to your project.

  2. No canto superior direito, clique em .

  3. No menu, clique em Itens arquivados.

  4. Opcionalmente, para filtrar os itens arquivados exibidos, digite seu filtro na caixa de texto acima da lista de itens. Para obter mais informações sobre os filtros disponíveis, consulte "Filtrando projetos (beta)".

    Captura de tela que mostra o campo para filtrar itens arquivados

  5. À esquerda de cada item de título, selecione os itens que deseja restaurar.

    Captura de tela que mostra as caixas de seleção próximas aos itens arquivados

  6. Para restaurar os itens selecionados, acima da lista de itens, clique em Restaurar.

    Captura de tela que mostra o botão "Restaurar"

Adicionando campos

Como os valores do campo mudam, eles são sincronizados automaticamente para que o seu projeto e os itens que ele rastreia fiquem atualizados.

Mostrando campos existentes

O seu projeto rastreia informações atualizadas sobre problemas e pull requests, incluindo todas as alterações no título, responsáveis, etiquetas, marcos, repositórios, revisores e pull requests vinculados. Quando seu projeto é inicializado, são exibidos "título" e "responsáveis". Os outros campos permanecem ocultos. Você pode alterar a visibilidade desses campos no seu projeto.

  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).
  2. Comece a digitar "mostrar".
  3. Selecione o comando desejado (por exemplo: "Mostrar: Repositório").

Como alternativa, você pode fazer isso na interface do usuário:

  1. Clique em no cabeçalho mais à direita. Será exibido um menu suspenso com os campos do projeto. Exibir ou ocultar campos
  2. Selecione o(s) campo(s) que você deseja exibir ou ocultar. Um indica quais campos serão exibidos.

Adicionando campos personalizados

Você pode adicionar campos personalizados ao seu projeto. Campos personalizados serão exibidos na barra lateral de problemas e pull requests no projeto.

Os campos personalizados podem ser texto, número, data, seleção única ou iteração:

  • Texto: O valor pode ser qualquer texto.
  • Número: O valor deve ser um número.
  • Data: O valor deve ser uma data.
  • Seleção única: O valor deve ser selecionado a partir de um conjunto de valores especificados.
  • Iteração: O valor deve ser selecionado a partir de um conjunto de intervalos de datas (iterações). As iterações anteriores são automaticamente marcadas como "concluídas", e a iteração que cobre o intervalo de datas atual é marcada como "atual". Para obter mais informações, consulte "Gerenciando iterações nos projetos. "
  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux). Comece a digitar qualquer parte de "Criar novo campo". Quando "Criar novo campo" for exibido na paleta de comandos, selecione-o.
  2. Como alternativa, clique em no cabeçalho do campo mais à direita. Será exibido um menu suspenso com os campos do projeto. Clique em Novo campo.
  3. Uma janela pop-up irá aparecer para inserir informações sobre o novo campo. Novo campo
  4. Na caixa de texto, digite um nome para o novo campo.
  5. Selecione o menu suspenso e clique no tipo desejado.
  6. Se você especificou Seleção única como o tipo, insira as opções.
  7. Se você especificou Iteração como o tipo, digite a data de início da primeira iteração e a duração da iteração. Três iterações são criadas automaticamente, e você pode adicionar iterações adicionais na página de configurações do projeto.

Você também pode editar seus campos personalizados.

  1. Navigate to your project.

  2. In the top-right, click to open the menu.

  3. In the menu, click Settings to access the project settings.

  4. Em Campos, selecione o campo que deseja editar.

  5. Para campos de seleção única, você pode adicionar, excluir ou reordenar as opções.

  6. Para campos de iteração, você pode adicionar ou excluir as iterações, alterar nomes da iteração e alterar a data e a duração de início da iteração.

    Para obter mais informações sobre como modificar campos de iteração, consulte "Gerenciando iterações nos projetos.

Personalizando as suas visualizações

Você pode ver seu projeto como uma tabela ou quadro, agrupar itens por campo, filtrar itens e muito mais. Para obter mais informações, consulte "Personalizar as visualizações do seu projeto (beta)".

Configurando a automação integrada

Projects (beta) includes built-in workflows that you can use to update the Status of items based on certain events. For example, you can automatically set the status to Todo when an item is added to your project or set the status to Done when an issue is closed.

When your project initializes, two workflows are enabled by default: When issues or pull requests in your project are closed, their status is set to Done, and when pull requests in your project are merged, their status is set to Done.

Você pode habilitar ou desabilitar os fluxos de trabalho internos para o seu projeto.

  1. Navigate to your project.
  2. In the top-right, click to open the menu.
  3. In the menu, click Workflows.
  4. Under Default workflows, click on the workflow that you want to edit.
  5. If the workflow can apply to both issues and pull requests, next to When, check the item type(s) that you want to act on.
  6. Next to Set, choose the value that you want to set the status to.
  7. If the workflow is disabled, click the toggle next to Disabled to enable the workflow.

Adicionando seu projeto a um repositório

Você pode listar projetos relevantes em um repositório. Você só pode listar projetos que pertencem ao mesmo usuário ou organização proprietária do repositório.

Para que os participantes do repositório vejam um projeto listado em um repositório, eles deverão ter visibilidade sobre o projeto. Para obter mais informações, consulte "Gerenciando a visibilidade dos seus projetos (beta)" e "Gerenciando o acesso a projetos (beta)".

  1. No GitHub, navegue até a página principal do seu repositório.
  2. Clique em Projetos.
  3. Clique em Projetos (Beta) na barra lateral.
  4. Clique Adicionar projeto.
  5. Na barra de pesquisa que aparece, pesquise por projetos pertentencentes ao mesmo usuário ou organização proprietária do repositório.
  6. Clique em um projeto para listá-lo no seu repositório.