Criar um wiki para o seu projeto

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Neste artigo, saiba como abrir um wiki e criar um repositório Git para o seu wiki. Cada projeto de equipe tem um wiki. Use o wiki para compartilhar informações com sua equipe para entender e contribuir com seu projeto.

Cada wiki de projeto de equipe é alimentado por um repositório Git no back-end. Quando você cria um projeto de equipe, um repositório Git wiki não é criado por padrão. Crie um repositório Git para armazenar seus arquivos de Markdown wiki ou publique arquivos Markdown existentes de um repositório Git para um wiki.

Pré-requisitos

  • Você deve ter um projeto de equipe. Se você ainda não tiver um projeto de equipe, crie um no Azure DevOps.
  • Você deve ter pelo menos acesso básico para criar e modificar um wiki.
  • Você deve ter a permissão Criar repositório para publicar código como wiki. Por predefinição, esta permissão está definida para membros do grupo Administradores de Projetos.
  • Qualquer pessoa que seja membro do grupo de segurança Contribuidores pode adicionar ou editar páginas wiki. Qualquer usuário com acesso ao projeto de equipe, incluindo partes interessadas, pode visualizar o wiki.
  • Você deve ter um projeto de equipe. Se você ainda não tiver um projeto de equipe, crie um local.
  • Você deve ter a permissão Criar repositório para publicar código como wiki. Por predefinição, esta permissão está definida para membros do grupo Administradores de Projetos.
  • Qualquer pessoa que seja membro do grupo de segurança Contribuidores pode adicionar ou editar páginas wiki. Qualquer usuário com acesso ao projeto de equipe, incluindo partes interessadas, pode visualizar o wiki.

Abra o Wiki

Você pode abrir e visualizar uma página wiki para o seu projeto.

Conecte-se ao seu projeto usando um navegador da Web suportado e escolha Wiki.

Captura de tela mostrando a seleção do menu Wiki realçado.

Se você precisar alternar seu projeto de equipe, escolha Azure DevOps para procurar todos os projetos de equipe e equipes.

Criar um repositório Git wiki

Crie um novo repositório Git que armazene todas as suas páginas wiki e artefatos relacionados. Na página inicial do wiki, selecione Criar wiki do projeto. Mesmo se você usar TFVC para controle de código-fonte, você pode criar um wiki com um repositório Git.

Captura de tela de Criar wiki, repositório Git para seu wiki ou publicar arquivos de Markdown de repositório existentes.

Se você não tiver acesso para criar um repositório Git wiki ou se não tiver acesso a nenhum dos wikis existentes, a seguinte mensagem será exibida.

Captura de tela de Permissões insuficientes para criar um repositório wiki.

Seu administrador pode criar o repositório Git wiki ou você pode solicitar que eles elevem suas permissões. As partes interessadas não podem criar um wiki, pois não têm permissões para trabalhar em repositórios ou código.

O repositório Git wiki é referido como TeamProjectName.wiki. Por exemplo, se o seu projeto de equipe éfoobar, então o repositório wiki é rotulado .foobar.wiki

Nota

Se você quiser criar mais wikis, então você deve publicar o código como um wiki. Você pode configurar vários repositórios wiki em um único projeto.

Como posso ir para o repositório Git?

O TeamProjectName.wiki não aparece no menu suspenso de repositórios de Repos ou Código. Ele também não está na lista fornecida nas páginas Repositórios de Configurações > do Projeto ou Controle de Versão das Configurações > do Projeto.
No entanto, você pode acessá-lo a partir do seguinte URL:

https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>

https://<Server_Name>/Default_Collection/<Team_Project_Name>/_git/<Wiki_Name>

Selecione Clone Wiki nas reticências perto do seletor wiki para acessar o URL do wiki.

Screenshot da ação wiki Clone.

A URL do repositório Git wiki está exposta. Copie e cole-o em seu navegador da Web para acessar o repositório Git subjacente.

Próximos passos