Compartilhar via


Compartilhe sua visão de projeto, veja a atividade do projeto

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

Cada projeto fornece um Resumo ou home page para compartilhar informações e mostrar a atividade mais recente do projeto. Use esta página para executar uma ou mais das seguintes tarefas.

Tarefas do Administrador do Projeto

Tarefas do membro do projeto

  • Adicionar uma breve descrição do projeto
  • Escolha um arquivo LEIA-ME 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
  • Favorito um projeto
  • Enviar por e-mail ou iniciar um bate-papo com um membro da equipe
  • Iniciar uma pesquisa em todo o seu projeto
  • Exibir informações do projeto
  • Enviar por e-mail ou iniciar um bate-papo com um membro da equipe
  • Exibir atividade do projeto

Observação

Os projetos hospedados podem ser designados como Privados ou Públicos. Para projetos públicos, usuários anônimos podem exibir o Resumo do projeto, exceto para 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, consulte O que é um projeto público?

Captura de tela da página de resumo.

Observação

Se você quiser usar um wiki do projeto para as informações do Resumo do projeto, crie primeiro um Wiki para o seu projeto. Em seguida, você pode alterar a página de resumo do projeto para apontar para o wiki.

Pré-requisitos

  • Você deve ser membro do grupo Administradores do Projeto ou ter sua permissão Editar informações no nível do projeto definida como Permitir para fazer o seguinte:
    • Editar informações na página do projeto
    • Alterar o repositório que você usa para compartilhar informações do projeto
    • Gerenciar associação ao projeto
  • Para editar uma página, você deve ser um colaborador do repositório ou ramificação ou ter as permissões de Colaboração definidas como Permitir.
  • Para exibir o Resumo do projeto, você deve ser 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, você deve ter a permissão Gerenciar propriedades no nível do projeto definida como Permitir. Essa permissão controla as propriedades da API REST do projeto. A API REST de propriedades do projeto é usada para conduzir a experiência de marcas de projeto no produto.

Dica

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

Abrir resumo do projeto

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

Se o resumo do projeto ainda não estiver configurado, você verá esta página de boas-vindas:

Captura de tela do resumo do projeto aberto.

Selecione uma das seguintes tarefas para começar:

Atualizar a página

A página Resumo exibe o arquivo LEIA-ME definido em um repositório de projeto ou a home page de um wiki de projeto. Se você quiser usar a home page do wiki do projeto, primeiro configure-a conforme descrito em Criar um Wiki para seu projeto.

  1. Edite a página:

    • Se for a primeira vez que você edita a página, selecione Adicionar Descrição do Projeto.
      Captura de tela da página de resumo, edição pela primeira vez.

    • Se não for a primeira vez que você edita a página, selecione Editar informações do projeto. Esse í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 .

    Sobre este projeto dialogar.

  3. (Opcional) Adicione uma ou mais Tags ao seu projeto. Essas tags são semelhantes às tags de item de trabalho. Você pode adicionar várias marcas ao mesmo tempo 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 mais do que 15 tags podem ser adicionadas 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 LEIA-ME ou à home page wiki do projeto para o restante do conteúdo da página Resumo.

    Dica

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

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

    Sobre esta caixa de diálogo do projeto, escolha e selecione o repositório LEIA-ME.

    Se você escolher um Wiki, a home page do Wiki será referenciada e deverá ser o primeiro arquivo dentro do sumário do Wiki. Não dá para alterar essa referência.

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

    Considere incluir os seguintes tipos de informações na 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 em código, controlar 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 e-mail ou postar uma pergunta no canal do Slack ou do Teams.

Convide pessoas para contribuir com seu projeto

Você pode enviar um e-mail para convidar 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 da página Resumo.

Captura de tela da página Resumo, botão Convidar.

Observação

Para o Servidor de DevOps do Azure, todas as ações de email exigem que um servidor SMTP seja configurado.

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.

Captura de tela da página Resumo, seção Estatísticas.

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.

Captura de tela da página Resumo, seção Membros.

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.

Captura de tela da página Resumo, seção Membros, opções disponíveis para se conectar a um membro da equipe.

Observação

Para o Azure DevOps local, todas as ações de email exigem que um servidor SMTP seja configurado.

Pesquisar um projeto

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

Captura de tela da página Resumo, caixa de pesquisa.

Inicializar um arquivo LEIA-ME para um repositório Git

Você pode compartilhar seu projeto e objetivo e maneiras de os membros da equipe contribuírem para o projeto por meio de um arquivo LEIA-ME do projeto. Para projetos Git, o arquivo README.md precisa estar na raiz de cada repositório na ramificação padrão. Para projetos baseados em Git, o painel esquerdo oferece 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 repositório ao escolher uma das opções para clonar, enviar por push, importar ou inicializar um repositório.

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

    Captura de tela do arquivo Leiame inicializar, versões mais recentes

    Um arquivo LEIA-ME padrão é adicionado ao repositório do projeto, neste caso, o repositório de teste da Fabrikam.

  3. Retorne ao Resumo da Visão Geral>e escolha o arquivo LEIA-ME para a página do projeto. Selecione Editar.

    Captura de tela do arquivo Escolher LEIA-ME.

  4. Selecione o repositório do projeto onde você inicializou o arquivo LEIA-ME.

    Captura de tela de Escolher repositório onde o arquivo LEIA-ME existe.

  5. Para editar o arquivo LEIA-ME, escolha o link do arquivo LEIA-ME.

    Captura de tela de Editar o arquivo LEIA-ME.

    Você será direcionado para a página Arquivos de Repositórios> do arquivo LEIA-ME. Você pode editar e modificar o arquivo Markdown LEIA-ME como faria com qualquer outro arquivo em um repositório Git. Você pode usar a linguagem Markdown para formatar o arquivo LEIA-ME e adicionar imagens. Para obter mais informações, consulte Criar um LEIA-ME para seu repositório e orientação de Markdown.

Inicializar um arquivo LEIA-ME para um repositório TFVC

Para projetos que selecionaram TFVC para controle de versão, o arquivo de 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.

    Captura de tela da página de boas-vindas, novo projeto do TFVC, criar readme.

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

    Captura de tela da caixa de diálogo Sobre este projeto.

  4. Para criar um arquivo LEIA-ME, escolha Arquivos de Repositórios>e escolha novo arquivo para adicionar um arquivo ao repositório do projeto.

  5. Nomeie o arquivo como README.md.

    Captura de tela da caixa de diálogo Adicionar novo arquivo.

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

    Captura de tela do conteúdo do arquivo README Enter.

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

    Captura de tela da caixa de diálogo Arquivo LEIA-ME de Check-in.

  8. Selecione Resumo de Visão Geral>para revisar a página de resumo do projeto com o arquivo LEIA-ME exibido.

    Captura de tela da página de resumo do projeto com o arquivo LEIA-ME exibido.

APIs REST