---
title: "Wikis"
source: Microsoft Code-With Engineering Playbook
source_url: https://github.com/microsoft/code-with-engineering-playbook
licence: CC-BY-4.0
domain: engineering
subdomain: microsoft-code-with-playbook
date_added: 2026-04-25
---

# Wikis

Use a **team project wiki** to share information with other team members. When you provision a wiki from scratch, a new **Git repository** stores your [Markdown](./languages.md#markdown) files, images, attachments, and sequence of pages. This wiki supports **collaborative editing** of its content and structure.

In Azure DevOps, you have the following **options for maintaining wiki content**:

- Provision a wiki for your team project. This option supports only one wiki for the team project.
- Publish Markdown files defined in a Git repository to a wiki. With this option, you can maintain several versioned wikis to support your content needs.

More information:

- [About Wikis, READMEs, and Markdown](https://learn.microsoft.com/en-us/azure/devops/project/wiki/about-readme-wiki?view=azure-devops).
- [Provisioned wikis vs. published code as a wiki](https://learn.microsoft.com/en-us/azure/devops/project/wiki/provisioned-vs-published-wiki?view=azure-devops).
- [Create a Wiki for your project](https://learn.microsoft.com/en-us/azure/devops/project/wiki/wiki-create-repo?view=azure-devops&tabs=browser).
- [Manage wikis](https://learn.microsoft.com/en-us/azure/devops/project/wiki/manage-wikis?view=azure-devops).

## Wikis vs. Digital Notebooks (e.g., OneNote)

When you work on a project, you may decide to document relevant details or record important decisions about the project in a digital notebook. Tools like [OneNote](https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app) allows you to easily organize, navigate and search your notes. You can provide type, highlighting, or ink annotations to your notes. These notes can easily be shared and created together with others. Still, Wikis greatly facilitate the process of [establishing and managing documentation](../best-practices/establish-and-manage.md) by allowing us to source control the documentation.
