Merge pull request #7986 from GitHubber17/wiki-421753-d

Freshness: Azure DevOps - Wiki

Author: v-regandowner

docs/project/wiki/includes/open-wiki-hub.md

@@ -1,24 +1,25 @@
 ---
 ms.topic: include
+ms.date: 06/02/2025
 ---
 
 ## Open the Wiki  
 
-You can open and view a wiki page for your project.
+You can open and view the wiki page for your team project from Azure DevOps in the browser or use the Azure DevOps CLI.
 
 #### [Browser](#tab/browser) 
 
-Connect to your project using a [supported web browser](/azure/devops/server/compatibility#supported-browsers) and choose **Wiki**.
+Connect to your project by using a [supported web browser](/azure/devops/server/compatibility#supported-browsers) and select **Wiki**:
 
-:::image type="content" source="../media/open-wiki-vert-brn.png" alt-text="Screenshot showing highlighted Wiki menu selection.":::
+:::image type="content" source="../media/open-wiki-overview-page.png" border="false" alt-text="Screenshot of a wiki open in the browser and showing the wiki overview page." lightbox="../media/open-wiki-overview-page.png":::
 
-If you need to switch your team project, choose :::image type="icon" source="../../../media/icons/project-icon.png" border="false"::: **Azure DevOps** to [browse all team projects and teams](../../navigation/work-across-projects.md).
+If you need to switch your team project, select :::image type="icon" source="../../../media/icons/project-icon.png"::: **Azure DevOps** to [browse all team projects and teams](../../navigation/work-across-projects.md).
 
 #### [Azure DevOps CLI](#tab/azure-devops-cli)
 
 ::: moniker range="azure-devops"
 
-You can view and open a wiki page defined for a project using the `az devops wiki show` command. To get started, see [Get started with Azure DevOps CLI](../../../cli/index.md).
+You can view and open a wiki page for a project by using the `az devops wiki show` command: 
 
 > [!div class="tabbedCodeSnippets"]
 ```azurecli
@@ -28,25 +29,33 @@ az devops wiki show --wiki
                       [--subscription]
 ```
 
-### Parameters
+For more information, see [Get started with the Azure DevOps CLI](../../../cli/index.md).
 
-- **--wiki**: Required. Name or ID of the wiki.
-- **--open**: Optional. Open the wiki page in your web browser.
-- **--project -p**: Optional. Name or ID of the project.
-- **--subscription**: Optional. Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
+### Basic parameters
 
-### Example
+The following parameters are available for the `wiki show` command:
 
-Open a wiki named 'myprojectwiki'.
+| Parameter        | Required | Description |
+|------------------|:--------:|-------------|
+| `--wiki`         | Yes      | The name or ID of the wiki. |
+| `--open`         | No       | Open the wiki page in your web browser. |
+| `--project -p`   | No       | The name or ID of the project. |
+| `--subscription` | No       | The name or ID of the subscription. You can configure the default subscription with the `az account set -s NAME_OR_ID` command. |
+
+For more information, see the Azure DevOps CLI [command reference](/cli/azure/devops/wiki#az-devops-wiki-show).
+
+### Example: View the project wiki
+
+The following example shows how to open a wiki named "MyProjectwiki":
 
 > [!div class="tabbedCodeSnippets"]
 ```azurecli
-az devops wiki show --wiki myprojectwiki --open
+az devops wiki show --wiki MyProjectwiki --open
 ```
 
 ## View a wiki page
 
-To get the content of a page via the Azure DevOps CLI, enter the `az devops wiki show` command. 
+You can view the content of a specific page by using the Azure DevOps CLI `az devops wiki show` command:
 
 > [!div class="tabbedCodeSnippets"]
 ```azurecli
@@ -59,22 +68,25 @@ az devops wiki page show --path
                          [--version]
 ```
 
-### Parameters
+### More parameters
+
+The following table lists [more parameters](#basic-parameters) for the `wiki show` command when you want to view a specific page:
+
+| Parameter           | Required | Description |
+|---------------------|:--------:|-------------|
+| `--path`            | Yes      | The fully qualified path for the wiki page. |
+| `--include-content` | No       | Show the full page content along with the page metadata. |
+| `--version -v`      | No       | The version of the wiki page, which corresponds to the `ETag` entity tag value. |
 
-- **--path**: Required. Path of the wiki page.
-- **--wiki**: Required. Name or ID of the wiki.
-- **--include-content**: Optional. Include content of the page.
-- **--open**: Optional. Open the wiki page in your web browser.
-- **--project -p**: Optional. Name or ID of the project.
-- **--version -v**: Optional. Version (ETag) of the wiki page.
+For more information, see the Azure DevOps CLI [command reference](/cli/azure/devops/wiki#az-devops-wiki-show).
 
-### Example
+### Example: View a specific page
 
-Get wiki page content with path 'my wiki' in a wiki named 'myprojectwiki'.
+The following example shows how to get content for the "Get Started" page of the "MyProjectwiki" wiki:
 
 > [!div class="tabbedCodeSnippets"]
 ```azurecli
-az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"
+az devops wiki page show --path 'Get Started' --wiki 'MyProjectwiki' --content "Hello World"
 ```
 
 ::: moniker-end

docs/project/wiki/includes/wiki-prereqs-create-repository.md

@@ -1,10 +1,10 @@
 ---
 ms.topic: include
+ms.date: 05/30/2025
 ---
 
-
 | 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, including [Stakeholders](../../../organizations/security/get-started-stakeholder.md), can view the wiki. |
-| **Permissions** | - To add or edit wiki pages: Member of the **Contributors** group.<br> - To publish code as wiki: **Create Repository** permission. By default, this permission is set for members of the [Project Administrators group](../../../repos/git/set-git-repository-permissions.md).|
-| **Access levels** | At least **Basic** access. |
+|----------|--------------|
+| **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](../../../organizations/security/get-started-stakeholder.md). |
+| **Permissions**    | - To add or edit wiki pages: Member of the **Contributors** group. <br> - To publish code as wiki: **Create Repository** permission. By default, this permission is set for members of the [Project Administrators group](../../../repos/git/set-git-repository-permissions.md). |
+| **Access levels**  | At least **Basic** access. |

docs/project/wiki/media/open-wiki-overview-page.png

@@ -47,7 +47,7 @@ For more information, see [Provisioned vs. published code as wiki](provisioned-v
 1. Sign in to your project (```https://dev.azure.com/{Your_Organization}/{Your_Project}```) and select **Overview** > **Wiki**.
 
    > [!div class="mx-imgBorder"]  
-   > ![Screenshot showing selection of wiki tab.](media/open-wiki-vert-brn.png)
+   > ![Screenshot showing selection of wiki tab.](media/open-wiki-overview-page.png)
 
 If you need to switch projects, select :::image type="icon" source="../../media/icons/project-icon.png" border="false"::: **Azure DevOps** to [browse all projects](../navigation/work-across-projects.md).  
 

docs/project/wiki/media/open-wiki-vert-brn.png

@@ -1,84 +1,94 @@
 ---
-title: Create a project wiki to share information
+title: Create Project Wiki to Share Information
 titleSuffix: Azure DevOps
-description: Share information with your team and increase collaboration using a built-in team project wiki in Azure DevOps.
+description: Share information with your team and increase collaboration by using a built-in team project wiki in Azure DevOps.
 ms.subservice: azure-devops-wiki
 ms.custom: wiki, devx-track-azurecli, devdivchpfy22
 ms.topic: how-to
 ms.author: chcomley
 author: chcomley
 ms.reviewer: gopinach
 monikerRange: '<= azure-devops'
-ms.date: 01/05/2024
+ms.date: 06/02/2025
+#customer intent: As a developer, I want to work with the built-in project wiki in Azure DevOps, so I can share information with my team and support collaboration. 
 ---
 
 # Create a wiki for your project
 
 [!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)] 
 
-In this article, learn how to open a wiki and create a Git repo for your wiki. Every team project has a wiki. Use the wiki to share information with your team to understand and contribute to your project.
+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. 
 
-Each team project 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. Create a Git repository to store your wiki Markdown files, or [publish existing Markdown files from a Git repository](publish-repo-to-wiki.md) to a wiki.
-
-<a id="prereq">  </a>
+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](publish-repo-to-wiki.md) to a wiki.
 
 ## Prerequisites
 
 [!INCLUDE [wiki-prereqs-create-repository](includes/wiki-prereqs-create-repository.md)]
 
+<!-- Section: Open the Wiki -->
 [!INCLUDE [temp](includes/open-wiki-hub.md)]
 
 ## Create a wiki Git repository
 
-#### [Browser](#tab/browser) 
+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.
 
-Create a new Git repository that stores all your wiki pages and related artifacts. From the wiki landing page, select **Create Project wiki**. Even if you use TFVC for source control, you can create a wiki with a Git repository.
+### [Browser](#tab/browser) 
 
-::: moniker range="<=azure-devops"
+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.
 
-> [!div class="mx-imgBorder"]  
-> ![Screenshot of Create wiki, Git repo for your wiki or publish existing repo Markdown files.](media/wiki/create-wiki-or-publish-create-option.png)
-::: moniker-end
+:::image type="content" source="media/wiki/create-wiki-or-publish-create-option.png" border="false" alt-text="Screenshot that shows how to select the Create project wiki or Publish code as wiki option in Azure DevOps." lightbox="media/wiki/create-wiki-or-publish-create-option.png":::
 
-If you don't have access to create a wiki Git repository or if you don't have access to any of the existing wikis, the following message appears.
+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:
 
-> [!div class="mx-imgBorder"]  
-> ![Screenshot of Insufficient permissions to create a wiki repository.](media/wiki/wiki-security-no-contributor.png)
+:::image type="content" source="media/wiki/wiki-security-no-contributor.png" alt-text="Screenshot of the message for users with insufficient permissions to create a wiki Git repository.":::
 
-Your administrator can create the wiki Git repository or you can request that they elevate your permissions. Stakeholders can't create a wiki, as they have no permissions to work in **Repos** or **Code**.
+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 wiki Git repo is referred as `TeamProjectName.wiki`. For example, if your team project is `foobar` then the wiki repo is labeled `foobar.wiki`.
+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`.
 
-> [!NOTE]
-> If you want to create more wikis, then you must [publish code as a wiki](publish-repo-to-wiki.md). You can set up multiple wiki repos within a single project.
+> [!TIP]
+> You can create multiple wikis for a single project by [publishing your code as a wiki](publish-repo-to-wiki.md).
 
-### How can I go to the Git repository?
+#### Access your wiki repo
 
-The *TeamProjectName.wiki* doesn't appear in the drop-down menu of repositories from **Repos** or **Code**. It also isn't in the list provided from the **Project Settings > Repositories** or **Project Settings > Version Control** pages.  
-However, you can get to it from the following URL:
+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.
 
-::: moniker range="azure-devops"
-`https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>` 
-::: moniker-end
+1. Create the URL for the **Repos** > **Files** page. In the following URL, substitute your server, organization, project, and wiki name for any `<Placeholder>` portions:
 
-::: moniker range=" < azure-devops"
-`https://<Server_Name>/Default_Collection/<Team_Project_Name>/_git/<Wiki_Name>` 
-::: moniker-end
+   ::: moniker range="azure-devops"
 
-Select **Clone Wiki** from the ellipsis near the wiki picker to access the wiki URL.
+   `https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>` 
 
-:::image type="content" source="media/wiki/clone-wiki.png" alt-text="Screenshot of Clone wiki action."::: 
+   ::: moniker-end
+   ::: moniker range=" < azure-devops"
 
-The URL of the wiki Git repository is exposed. Copy and paste it into your web browser to access the underlying Git repo.
+   `https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>`
 
-#### [Azure DevOps CLI](#tab/azure-devops-cli) 
+   ::: moniker-end
 
-::: moniker range="azure-devops"
+1. Paste the URL into a browser and open the **Files** page for your wiki.
 
-You can create a wiki with the [az devops wiki create](/cli/azure/devops/wiki#ext-azure-devops-az-devops-wiki-create) command. To get started, see [Get started with Azure DevOps CLI](../../cli/index.md).
+1. On the **Repos** > **Files** page, locate your wiki repo name and select **More options** (**...**) > **Clone**. 
 
-> [!NOTE]
-> To create more than one wiki, you must [publish code as a wiki](./publish-repo-to-wiki.md#publish-a-git-repository-to-a-wiki). You can set up multiple wiki repos within a single project.
+   :::image type="content" source="media/wiki/wiki-repo-files-select-clone.png" border="false" alt-text="Screenshot that shows how to open the Repos Files page for your wiki repo and then select the Clone option." lightbox="media/wiki/wiki-repo-files-select-clone.png"::: 
+
+   The **Clone** option opens a dialog that includes the URL for your wiki repo.
+
+1. In the dialog, select **HTTP** and then select the **Copy** icon (double page):
+
+   :::image type="content" source="media/wiki/clone-wiki-repo-files.png" alt-text="Screenshot that shows how to access the wiki repo URL by selecting the HTTP option and the Copy icon.":::
+
+   The URL is copied to your clipboard.
+
+   Close the dialog.
+
+1. To access the wiki repo, paste the copied URL into the browser.
+
+### [Azure DevOps CLI](#tab/azure-devops-cli) 
+
+::: moniker range="azure-devops"
+
+You can create a wiki with the [az devops wiki create](/cli/azure/devops/wiki#ext-azure-devops-az-devops-wiki-create) command:
 
 ```azurecli 
 az devops wiki create [--mapped-path]
@@ -90,19 +100,28 @@ az devops wiki create [--mapped-path]
                       [--version]
 ``` 
 
-#### Parameters 
+For more information, see [Get started with Azure DevOps CLI](../../cli/index.md).
+
+> [!NOTE]
+> If you want to create more than one wiki, you need to [publish your project code as a wiki](./publish-repo-to-wiki.md#publish-a-git-repository-to-a-wiki). You can set up multiple wiki repos for a single project.
+
+#### Parameters
+
+The following parameters are available for the `wiki create` command. The `type` parameter specifies the type of wiki to create: Project wiki (`projectwiki`) or Publish code as wiki (`codewiki`). 
 
-- **mapped-path**: (Required for the **codewiki** type). Mapped path of the new wiki. For example, you can specify `/` to publish from the root of the repository. 
-- **name**: (Required for the **codewiki** type). Name of the new wiki. If you don't specify a name for type **projectwiki**, then the new wiki gets named `TeamProjectName.wiki`.
-- **org**: Azure DevOps organization URL. You can configure the default organization using `az devops configure -d organization=ORG_URL`. Required if not configured as default or picked up using `git config`. Example: `--org https://dev.azure.com/MyOrganizationName/`.
-- **project**: Name or ID of the project. You can configure the default project using `az devops configure -d project=NAME_OR_ID`. Required if not configured as default or picked up using `git config`.
-- **repository**: (Required for the **codewiki** type). Name or ID of the repository to publish the wiki from.
-- **type**: Type of wiki to create. The accepted values are **projectwiki** (default) and **codewiki**.
-- **version**: (Required for the **codewiki** type). Repository branch name to publish the code wiki from.
+| Parameter     | Required | Description |
+|---------------|----------|-------------|
+| `mapped-path` | Yes (`codewiki`) | The mapped path for the wiki. You can specify backslash (`/`) to publish from the root of the wiki repo. |
+| `name`        | Yes (`codewiki`) | The name for the wiki. For the `projectwiki` type, when no name is specified, the wiki name is `TeamProjectName.wiki`. |
+| `org`         | Maybe          | The Azure DevOps organization URL. You can configure the default organization with the `az devops configure -d organization=ORG_URL` command. <br> **Note**: When the organization isn't configured by default or picked up by using the `git config` command, the parameter is **Required**. Example: `--org https://dev.azure.com/<OrganizationName>/`. |
+| `project`     | Maybe          | The name or ID of the project. You can configure the default project by using the `az devops configure -d project=NAME_OR_ID` command. <br> **Note**: When the project isn't configured by default or picked up by using the `git config` command, the parameter is **Required**. |
+| `repository`  | Yes (`codewiki`) | The name or ID of the Git repository to publish the wiki from. |
+| `type`        | No             | The type of wiki to create: Project wiki (`projectwiki`) or Publish code as wiki (`codewiki`). The default is `projectwiki`. |
+| `version`     | Yes (`codewiki`) | The Git repo branch name to publish the code wiki from. |
 
-#### Example 
+#### Example: Create a project wiki
 
-The following command creates a wiki named "Fabrikam Fiber" and shows the output in table format.
+The following command creates a project wiki named "Fabrikam Fiber" and shows the output in table format:
 
 ```azurecli 
 az devops wiki create --name "Fabrikam Fiber" --output table
@@ -119,7 +138,7 @@ ID                                    Name                 Type
 
 * * * 
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Add and edit wiki pages](add-edit-wiki.md)