Criar uma wiki para seu projeto

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

Neste artigo, saiba como abrir um wiki e criar um repositório Git para 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 wiki do Git não é criado por padrão. Crie um repositório Git para armazenar seus arquivos Markdown wiki ou publique arquivos Markdown existentes de um repositório Git em 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 padrão, essa permissão é definida para membros do grupo Administradores do Projeto.
  • Qualquer pessoa que seja membro do grupo de segurança Colaboradores pode adicionar ou editar páginas wiki. Qualquer usuário com acesso ao projeto de equipe, incluindo as 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 padrão, essa permissão é definida para membros do grupo Administradores do Projeto.
  • Qualquer pessoa que seja membro do grupo de segurança Colaboradores pode adicionar ou editar páginas wiki. Qualquer usuário com acesso ao projeto de equipe, incluindo as partes interessadas, pode visualizar o wiki.

Abrir 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 com suporte e escolha Wiki.

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

Se você precisar mudar seu projeto de equipe, escolha Azure DevOps para navegar por todos os projetos e equipes da equipe.

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 o TFVC para controle do código-fonte, poderá criar um wiki com um repositório Git.

Captura de tela de Criar wiki, repositório Git para seu wiki ou publicar arquivos 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 ele eleve suas permissões. As partes interessadas não podem criar um wiki, pois não têm permissões para trabalhar em Repos ou Code.

O repositório wiki Git é conhecido como TeamProjectName.wiki. Por exemplo, se o seu projeto de equipe for foobar , o repositório wiki será rotulado foobar.wikicomo .

Observação

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 Code. 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 Clonar Wiki nas reticências próximas ao seletor de wiki para acessar a URL do wiki.

Captura de tela da ação Clonar wiki.

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

Próximas etapas