Create a Wiki for your project

  • Article
  • 5 minutes to read

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Learn how to open up a wiki and provision a Git repo for your wiki.

Every team projection can have a wiki. Use the wiki to share data with your squad to understand and contribute to your project.

Each squad projection wiki is powered by a Git repository in the dorsum-end. When you lot create a squad projection, a Wiki Git repo is not created by default. Provision a Git repository to store your wiki Markdown files, or publish existing Markdown files from a Git repository to a wiki.

Each team projection wiki is powered by a Git repository in the back-end. When you create a team project, a Wiki Git repo isn't created by default. Provision a Git repository to store your wiki Markdown files.

Prerequisites

  • Yous must have a squad project. If you don't take a team projection yet, create one in Azure DevOps.
  • You must have at least Bones access to create and modify a wiki.
  • You must have the permission Create Repository to publish code every bit wiki. By default, this permission is fix for members of the Projection Administrators group.
  • Anyone who is a member of the Contributors security group can add or edit wiki pages. Anyone with access to the team projection, including stakeholders, can view the wiki.
  • You must have a squad projection. If you lot don't take a squad project all the same, create one on-premises.
  • You must have the permission Create Repository to publish code as wiki. By default, this permission is set for members of the Project Administrators group.
  • Anyone who is a member of the Contributors security group can add or edit wiki pages. Anyone with access to the team projection, including stakeholders, can view the wiki.

Open up the Wiki

  • Browser
  • Azure DevOps CLI

Connect to your project using a supported web browser and choose Wiki.

Create wiki, provision a Git repo for your wiki or publish existing repo Markdown files

If you need to switch your team project, cull Azure DevOps to browse all squad projects and teams.

Provision a wiki Git repository

  • Browser
  • Azure DevOps CLI

Provision a new Git repository that stores all your wiki pages and related artifacts. From the Wiki landing page, select Create Project Wiki. (Fifty-fifty if yous use TFVC for source control, you can create a wiki with a Git repository.)

Create wiki, Git repo for your wiki or publish existing repo Markdown files

Create wiki, Git repo for your wiki

If you don't have access to create a Wiki Git repository or if you don't have admission to whatsoever of the existing wikis, the following message appears.

Insufficient permissions to create a Wiki repository

Your administrator tin provision the Wiki Git repository or y'all tin asking that they drag your permissions. Stakeholders can't create a wiki, as they have no permissions to piece of work in Repos or Code.

The Wiki Git repo is referred as TeamProjectName.wiki. For example, if your team project is 'foobar' then the Wiki repo is labeled 'foobar.wiki'.

Annotation

If you want to provision more wikis, then you must publish code every bit a wiki. You lot tin can ready multiple wiki repos inside a single project.

How tin can I go to the Git repository?

The TeamProjectName.wiki doesn't appear in the drop-down menu of repositories from Repos or Code. Information technology also isn't in the list provided from the Project Settings > Repositories or Project Settings > Version Control pages.
However, yous can get to it from the following URL:

https://dev.azure.com/<OrgName>/<TeamProjectName>/_git/<WikiName>

https://<ServerName>/DefaultCollection/<TeamProjectName>/_git/<WikiName>

Choose Clone Wiki from the ellipsis almost the wiki picker to access the Wiki URL.

Clone wiki

The URL of the wiki Git repository is exposed. Copy and paste information technology into your web browser to access the underlying Git repo.

Side by side steps