Skip to content

Added note to include 1 file in parent folder so that contents inside subfolder show up in wiki. #14327

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 25, 2025
Merged

Added note to include 1 file in parent folder so that contents inside subfolder show up in wiki. #14327

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cd39655
added note to include 1 file in parent folder so that contents inside…
sanjeev40084 Sep 25, 2025
3c4afb3
Revise added note, markdown for code
chcomley Sep 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 16 additions & 2 deletions docs/project/wiki/wiki-file-structure.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ ms.topic: concept-article
ms.author: chcomley
ms.reviewer: gopinach
author: chcomley
ms.date: 05/29/2025
ms.date: 09/25/2025
#customer intent: As an Azure DevOps developer, I want to understand the wiki file and folder structure in the Git repository, so I can follow the naming and location conventions.
---

Expand Down Expand Up @@ -48,6 +48,20 @@ The file name for each wiki page corresponds to the wiki page title. In the file

The _.order_ file defines the wiki page sequence. Git looks for this file in each folder to identify the sequence to present files at that location. The default page sequence is alphabetical order (A to Z) by file name.

> [!IMPORTANT]
> When a parent folder contains only subfolders and no files of its own, the wiki displays the parent folder as blank—even if the subfolders include markdown files. To ensure visibility of markdown files within subfolders, always place at least one file (such as a `.order` file or any other file with content) in the parent folder.
>
>```
>|- parent-folder
>|-- sub-folder1
>| |-- file1.md
>| |-- file2.md
>|-- sub-folder2
>| |-- file3.md
>| |-- file4.md
>|-- .order
>```

### Define custom page sequence

When a folder doesn't have an _.order_ file, Git uses the default alphabetical sequence.
Expand Down Expand Up @@ -89,4 +103,4 @@ If a folder has a custom sequence, you can revert the sort method to alphabetica

- [Set up wiki vs. publish code as wiki](provisioned-vs-published-wiki.md)
- [Create a wiki for your team project](wiki-create-repo.md)
- [Publish a Git repository to a wiki](publish-repo-to-wiki.md)
- [Publish a Git repository to a wiki](publish-repo-to-wiki.md)