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

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

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. In order to populate the repository, labels, or milestones for a draft issue, you must first convert the draft issue to an issue. For more information, see "Converting draft issues to issues."

Note: Users will not receive notifications when they are assigned to or mentioned in a draft issue unless the draft issue is converted to an issue.

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.

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. Alternatively, edit the labels, milestone, or repository fields of the draft issue that you want to convert.

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

Para restaurar um item arquivado, acesse o problema ou pull request. Na barra lateral do projeto no problema ou pull request, clique em Restaurar para o projeto para o qual você deseja restaurar o item. Os rascunhos de problemas não podem ser restaurados.

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

Your project tracks up-to-date information about issues and pull requests, including any changes to the title, assignees, labels, milestones, repository, reviewers, and linked pull requests. 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".
  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.

Posteriormente, você poderá editar as opções de seleção única e iteração de campos.

  1. Navigate to your project.
  2. Click to access the project settings.
  3. Em Campos, selecione o campo que deseja editar.
  4. Para campos de seleção única, você pode adicionar, excluir ou reordenar as opções.
  5. 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.

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. In your project, click .
  2. Under Default workflows, click on the workflow that you want to edit.
  3. 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.
  4. Next to Set, choose the value that you want to set the status to.
  5. If the workflow is disabled, click the toggle next to Disabled to enable the workflow.

Adding your project to a repository

You can list relevant projects in a repository. You can only list projects that are owned by the same user or organization that owns the repository.

In order for repository members to see a project listed in a repository, they must have visibility for the project. For more information, see "Managing the visibility of your projects (beta)" and "Managing access to projects (beta)."

  1. On GitHub, navigate to the main page of your repository.
  2. Clique em Projetos.
  3. Click Projects (Beta) in the side bar.
  4. Click Add project.
  5. In the search bar that appears, search for projects that are owned by the same user or organization that owns the repository.
  6. Click on a project to list it in your repository.

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.