Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
In Azure DevOps, every team project has a wiki. You can use the wiki to share information with your team and support project contribution. The wiki is powered by a Git repository in the backend. This article describes how to open the project wiki and create the Git repo.
When you create a team project, a wiki Git repo isn't created by default. You can create the repo to store your wiki Markdown files, or publish existing Markdown files from a Git repository to a wiki.
Prerequisites
Category | Requirements |
---|---|
Project access | Member of the project where the wiki is located. If you don't have access, request it from your project administrator. Anyone with access to the team project can view the wiki, including Stakeholders. |
Permissions | - To add or edit wiki pages: Member of the Contributors group. - To publish code as wiki: Create Repository permission. By default, this permission is set for members of the Project Administrators group. |
Access levels | At least Basic access. |
Open the Wiki
You can open and view the wiki page for your team project from Azure DevOps in the browser or use the Azure DevOps CLI.
Connect to your project by using a supported web browser and select Wiki:
If you need to switch your team project, select
Azure DevOps to browse all team projects and teams.
Create a wiki Git repository
This section describes how to create the Git repo for your wiki. You can work directly with the Azure DevOps UI in the browser or use the Azure DevOps CLI.
In the browser, you can create a new Git repository to store your wiki pages and related artifacts. From the Wiki landing page, select Create project wiki. Even if you use Team Foundation Version Control (TFVC) for source control, you can create a wiki with a Git repository.
If you don't have the necessary permissions to create a wiki Git repo or you can't access any existing wikis, you see the following message:
Users with Project administrator-level access can create the wiki Git repo. Users with Stakeholder access can't create a wiki because they don't have permissions to work in the Repos or Code sections of the project.
The name for your wiki repo is based on your project name. The convention is <ProjectName>.wiki
. If your team project name is Contoso
then your wiki repo name is Contoso.wiki
.
Tip
You can create multiple wikis for a single project by publishing your code as a wiki.
Access your wiki repo
The Git repository for your wiki (ProjectName.wiki
) isn't included in the dropdown list of repositories in the Repos or Code sections of your project. The wiki repo is also not listed in the Project Settings > Repositories or Version Control pages. Instead, you can access your wiki repo from the Repos > Files page for your wiki.
Create the URL for the Repos > Files page. In the following URL, substitute your server, organization, project, and wiki name for any
<Placeholder>
portions:https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>
https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>
Paste the URL into a browser and open the Files page for your wiki.
On the Repos > Files page, locate your wiki repo name and select More options (...) > Clone.
The Clone option opens a dialog that includes the URL for your wiki repo.
In the dialog, select HTTP and then select the Copy icon (double page):
The URL is copied to your clipboard.
Close the dialog.
To access the wiki repo, paste the copied URL into the browser.