Exibir e atualizar a página de resumo do projeto

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020

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 progresso do projeto. Use esta página para as seguintes tarefas:

• Compartilhar atualizações e comunicados importantes do projeto
• Realçar atividades e marcos recentes
• Fornecer acesso rápido aos principais recursos e documentação do projeto
• Facilitar 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:

Pré-requisitos

Abrir resumo do projeto

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

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

Para começar, selecione uma das seguintes tarefas:

• Convidar 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.
• Repositórios para abrir a página Repositórios>Arquivos em que você pode clonar ou importar um repositório, ou inicializar um arquivo LEIAME para a página de resumo do seu 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 LEIAME 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, depois, poderá alterar a página de resumo do projeto para apontar para o wiki.

1. Edite a página:

   • Se estiver editando a página pela primeira vez, selecione Adicionar Descrição do Projeto.
     

   • Se não for a primeira edição da 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 do objetivo do projeto na caixa Descrição.

   

3. (Opcional) Adicione uma ou mais Marcas ao seu projeto. Essas marcas são parecidas com as marcas de item de trabalho. Para adicionar várias marcas por vez, use os delimitadores de vírgula ou ponto e vírgula. As marcas devem estar de acordo com as seguintes regras:

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

   Observação

   Não é possível usar as funções de pesquisa e filtro para pesquisar ou filtrar marcas de projeto.

4. Escolha se deseja referenciar um arquivo LEIAME ou a página inicial do wiki do projeto para o restante do conteúdo da página de resumo.

   Dica

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

   Se você escolher um arquivo Leiame, selecione o repositório para o LEIAME. Aparece uma visualização do texto atual do arquivo LEIAME.

   

   Se você escolher um Wiki, a página inicial do Wiki será referenciada e deverá ser o primeiro arquivo no sumário do Wiki. Não é possível alterar essa referência.

5. Para atualizar o conteúdo do arquivo LEIAME ou do wiki referenciado, edite o arquivo correspondente. Para saber mais, confira Criar um LEIAME para seu repositório ou Adicionar e editar páginas wiki.

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

   • Como os usuários podem colaborar com seu projeto
   • Quem contatar para elevar permissões ou adicionar extensões
   • Informações de roteiro
   • Links para instruções para configurar ambientes de desenvolvimento e teste
   • Links para instruções para colaborar em código, rastreamento de trabalho, criação de pipelines, implantação de 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.

Convidar colaboradores para o seu projeto

Envie um email para convidar usuários a colaborar com seu projeto, escolhendo Convidar. Para saber mais, confira Adicionar usuários ou grupos a uma equipe ou projeto, Convidar usuários na página Resumo.

Exibir a 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 email

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

Para enviar um email ou iniciar uma sessão de chat, escolha o membro da equipe mostrado e selecione sua opção.

Pesquisar um projeto

Na página Resumo, é possível iniciar uma pesquisa de código, itens de trabalho e wiki. Para saber mais, confira Introdução à pesquisa.

Inicializar um arquivo LEIAME para um repositório Git

Você pode compartilhar seu projeto e objetivo, além de formas em que membros da equipe podem colaborar com o projeto por meio de um arquivo LEIAME do projeto. Para projetos Git, o arquivo LEIAME.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. É possível criar uma página separada de boas-vindas/arquivo LEIAME.md para cada repositório.

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

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

   

   Um arquivo LEIAME padrão é adicionado ao repositório do projeto; nesse caso, o repositório de Teste Fabrikam.

3. Retorne a Visão geral>Resumo e escolha o arquivo LEIAME para a página do projeto. Selecione Editar.

   

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

   

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

   

   Você é direcionado à página Repositórios>Arquivos do arquivo LEIAME. Você pode editar e modificar o arquivo Markdown LEIAME, como faria com qualquer outro arquivo em um repositório Git. Você pode usar a linguagem Markdown para formatar o arquivo LEIAME e adicionar imagens. Para saber mais, confira Criar um LEIAME para seu repositório e Diretrizes básicas do Markdown.

Inicializar um arquivo LEIAME para um repositório TFVC

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

1. Abra Repositórios>Arquivos.

2. Selecione Adicionar Descrição do Projeto.

   

3. Selecione o repositório TFVC e escolha Salvar. Se não houver arquivo LEIAME no repositório, aparecerá a mensagem a seguir.

   

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

5. Nomeie o arquivo como LEIAME.md.

   

6. Adicione o conteúdo do arquivo LEIAME no formato Markdown e escolha Verificar....

   

7. Selecione Verificar para concluir o processo de verificação do arquivo LEIAME.

   

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

   

Conteúdo relacionado

• Saiba mais sobre Wikis, LEIAMEs e Markdown
• Introdução ao trabalho como administrador
• Navegue pelo portal da Web
• Recursos e serviços incluídos no Azure DevOps

APIs REST

• Obter propriedades do projeto
• Definir propriedades do projeto