Exibir e atualizar a página de resumo do projeto

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Cada projeto fornece um resumo ou página inicial para compartilhar informações e mostrar as atividades mais recentes do projeto. Esta página serve como um hub central para os membros da equipe se manterem informados e atualizados sobre o andamento do projeto. Use esta página para as seguintes tarefas:

• Compartilhe atualizações e anúncios importantes do projeto
• Destaque atividades e marcos recentes
• Forneça acesso rápido aos principais recursos e documentação do projeto
• Facilite a colaboração e a comunicação da equipe

Use a página de resumo do projeto para também executar tarefas mais específicas:

Tarefas do Administrador de Projetos

Tarefas dos membros do projeto

• Adicione uma breve descrição do projeto
• Escolha um arquivo README ou wiki para obter informações sobre o projeto
• Convide pessoas para contribuir com seu projeto
• Definir tags de projeto

• Exibir informações do projeto
• Exibir atividade do projeto
• Favorite um projeto
• Envie um e-mail ou inicie um bate-papo com um membro da equipe
• Iniciar uma pesquisa em seu projeto
• Exibir informações do projeto
• Envie um e-mail ou inicie um bate-papo com um membro da equipe
• Exibir atividade do projeto

Observação

Você pode designar projetos hospedados como Privados ou Públicos. Para projetos públicos, os usuários anônimos podem exibir o Resumo do projeto, exceto a seção Membros. Além disso, os ícones Curtir e Favorito não são visíveis para usuários anônimos. Para obter mais informações, confira O que é um projeto público?

Pré-requisitos

• Permissões: seja membro do grupo Administradores do projeto ou tenha sua permissão Editar informações no nível do projeto definida como Permitir para executar as seguintes tarefas:
  • Editar informações na página do projeto
  • Alterar o repositório que você usa para compartilhar informações do projeto
  • Gerenciar a associação ao projeto
• Tarefas específicas:
  • Para editar uma página de projeto, seja um colaborador do repositório ou ramificação ou tenha as permissões de Contribuição definidas como Permitir.
  • Para exibir o resumo do projeto, seja um membro válido do projeto. Para obter mais informações, consulte Sobre segurança, associação e permissões; Grupos de usuários válidos.
  • Para adicionar ou editar tags de projeto, defina a permissão Gerenciar propriedades no nível do projeto como Permitir. Essa permissão controla a API REST das propriedades do projeto.

Dica

Se você não tiver as permissões necessárias para editar uma página ou usar um recurso, os ícones e links correspondentes não ficarão visíveis para você.

Resumo do projeto aberto

No navegador da Web, selecione Resumo da visão geral>. Se você ainda não tiver um projeto, crie um projeto.

Se o resumo do projeto ainda não estiver configurado, uma página de boas-vindas será exibida:

Selecione uma das seguintes tarefas para começar:

• Convide para começar a adicionar outras pessoas ao seu projeto. Você só pode convidar usuários adicionados à sua organização.
• Quadros para começar a adicionar itens de trabalho.
• Repos para abrir a página Arquivos Repos> onde você pode clonar ou importar um repositório ou inicializar um arquivo README para a página de resumo do projeto.
• Pipelines para começar a definir um pipeline.
• Planos de teste para começar a definir planos de teste e conjuntos de testes.
• Gerencie seus serviços para desativar a visibilidade de um ou mais serviços.

Atualizar a página de resumo

A página de resumo exibe o arquivo README definido em um repositório do projeto ou a página inicial de um wiki do projeto. Para usar a página inicial do wiki do projeto, crie um wiki para o seu projeto e, em seguida, você pode alterar a página de resumo do projeto para apontar para o wiki.

1. Edite a página:

   • Se for a primeira vez que você edita a página, selecione Adicionar descrição do projeto.
     

   • Se não for a primeira vez que você edita a página, selecione Editar informações do projeto. Este ícone só é visível para membros com permissões para editar a página Resumo do projeto.

2. Forneça uma breve descrição da finalidade do projeto na caixa Descrição.

   

3. (Opcional) Adicione uma ou mais tags ao seu projeto. Essas marcas são semelhantes às marcas de item de trabalho. Você pode adicionar várias marcas de uma vez usando os delimitadores de vírgula ou ponto-e-vírgula. As tags devem estar em conformidade com as seguintes regras:

   • As tags devem ter 40 caracteres ou menos
   • As tags não podem conter o caractere de barra (/) ou terminar com o caractere de hífen (-)
   • Não é possível adicionar mais de 15 tags a um projeto
   • As tags não diferenciam maiúsculas de minúsculas e não são permitidas tags duplicadas ou vazias.

   Observação

   As funções de pesquisa e filtro não podem ser usadas para pesquisar ou filtrar tags de projeto.

4. Escolha se deseja fazer referência a um arquivo README ou à página inicial do wiki do projeto para o restante do conteúdo da página de resumo.

   Dica

   Um README padrão é criado no repositório adicionado quando você criou seu projeto. Você pode escolher este README ou criar outro repositório e arquivo README para essa finalidade.

   Se você escolher um arquivo Leiame, selecione o repositório para o LEIAME. Uma visualização do texto atual do arquivo README é mostrada.

   

   Se você escolher um Wiki, a página inicial do Wiki será referenciada e deverá ser o primeiro arquivo dentro do sumário do Wiki. Você não pode alterar essa referência.

5. Para atualizar o conteúdo do arquivo README ou wiki referenciado, edite o arquivo correspondente. Para obter mais informações, consulte Criar um README para seu repositório ou Adicionar e editar páginas wiki.

   Considere incluir os seguintes tipos de informações em sua página Resumo :

   • Maneiras pelas quais os usuários podem contribuir para seu projeto
   • Quem contatar para elevar permissões ou adicionar extensões
   • Informações do roteiro
   • Links para instruções para configurar seus ambientes de desenvolvimento e teste
   • Links para instruções para colaborar no código, acompanhar o trabalho, criar pipelines, implantar versões
   • Links para modelos para registrar um bug, problema ou solicitação
   • Links para listas de distribuição para enviar uma pergunta por email ou postar uma pergunta no Slack ou no canal do Teams.

Convide colaboradores para o seu projeto

Envie um e-mail para convidar os usuários a contribuir com seu projeto escolhendo Convidar. Para obter mais informações, consulte Adicionar usuários ou grupos a uma equipe ou projeto, Convidar usuários na página Resumo.

Exibir atividade do projeto

Na seção Estatísticas do projeto ou Atividade , você pode exibir as atualizações feitas no projeto nos últimos 1, 7 ou 30 dias. Escolha a opção de exibição conforme mostrado na imagem a seguir.

Converse com um membro do projeto ou envie um e-mail

Na seção Membros , você pode ver alguns dos membros adicionados ao projeto e conectar-se a eles por e-mail ou bate-papo com um membro.

Observação

100+ indica que 100 ou mais membros são adicionados ao projeto.

Para enviar um e-mail ou iniciar uma sessão de bate-papo, escolha o membro da equipe mostrado e selecione sua opção.

Pesquisar um projeto

Na página Resumo , você pode iniciar uma pesquisa de código, itens de trabalho e wiki. Para obter mais informações, consulte Introdução à pesquisa.

Inicializar um arquivo README para um repositório Git

Você pode compartilhar seu projeto e objetivo, além de maneiras de os membros da equipe contribuírem com o projeto por meio de um arquivo README do projeto. Para projetos Git, o arquivo README.md precisa estar na raiz de cada repositório no branch padrão. Para projetos baseados em Git, o painel esquerdo dá suporte à navegação para outros repositórios. Uma página de boas-vindas/arquivo README.md separado pode ser criado para cada repositório.

1. Abra Arquivos Repos>. Esta página orienta você a começar rapidamente adicionando código ao seu repositório ao escolher uma das opções para clonar, enviar, importar ou inicializar um repositório.

2. Com a caixa de seleção Adicionar um README marcada, escolha Inicializar.

   

   Um arquivo README padrão é adicionado ao repositório do projeto, nesse caso, o repositório de teste da Fabrikam.

3. Retorne ao Resumo da visão geral>e escolha o arquivo README para a página do projeto. Selecione Editar.

   

4. Selecione o repositório do projeto em que você inicializou o arquivo README.

   

5. Para editar o arquivo README, escolha o link do arquivo README.

   

   Você é direcionado para a página Arquivos Repos> do arquivo README. Você pode editar e modificar o arquivo README Markdown como faria com qualquer outro arquivo em um repositório Git. Você pode usar a linguagem Markdown para formatar o arquivo README e adicionar imagens. Para obter mais informações, consulte Criar um README para seu repositório e diretrizes de Markdown.

Inicializar um arquivo README para um repositório TFVC

Para projetos que selecionaram TFVC para controle de versão, o arquivo README.md precisa estar na raiz da pasta do projeto de equipe, por exemplo, $/TeamProject/README.md.

1. Abra Arquivos Repos>.

2. Selecione Adicionar descrição do projeto.

   

3. Selecione o repositório TFVC e escolha Salvar. Se nenhum arquivo README estiver no repositório, você verá a seguinte mensagem.

   

4. Para criar um arquivo README, escolha Arquivos Repos>e escolha novo arquivo para adicionar um arquivo ao repositório do projeto.

5. Nomeie o arquivo como README.md.

   

6. Adicione o conteúdo do arquivo README no formato Markdown e escolha Check-in....

   

7. Selecione Check-in para concluir o processo de check-in do arquivo README.

   

8. Selecione Resumo da visão geral>para revisar a página de resumo do projeto com o arquivo README exibido.

   

Artigos relacionados

• Saiba mais sobre Wikis, READMEs e Markdown
• Introdução como administrador
• Navegue pelo portal da Web
• Descubra o que você obtém com um projeto

APIs REST

• Obter propriedades do projeto
• Definir propriedades do projeto