CODEWITHSUNDEEP
azure-devopswikiazure-devops-wiki
Paul Stoner
Paul Stoner

Reputation: 1512

Is it possible to hide pages from an Azure DevOps Wiki?

I have been tasked with documenting how we are going to use Azure DevOps. This is something new to our team.

I am working on a wiki for the vaious How Tos, guides, standards, etc.

I want to force users to read pages in a certain order. But I don't necessarily want them to go directly to a page in the tree.

Here is my structure

enter image description here

So for Repos, if the reader needs to migrate an existing git repo to Azure DevOps, I want to the read

  1. Create a New DevOps Repo
  2. Change Local Repositories to Azure DevOps
  3. Push Existing Git Repository to Azure DevOps

But I don't want those pages visible in the tree. I will have another page with links to these pages.

Is this even possible? My research has yielded little in the way of help.

Upvotes: 4

Views: 5426

Answers (4)

Ranch Camal
Ranch Camal

Reputation: 570

According to the following link from Microsoft, answer is NO :

https://learn.microsoft.com/en-us/azure/devops/project/wiki/manage-readme-wiki-permissions?view=azure-devops#faq

enter image description here

Upvotes: 0

Dennis
Dennis

Reputation: 1784

Yes, it's quite possible. Since Wikis supports links (even relative links). You can set up Next and Previous links in each page to force people reading the documents in a certain order.

The files can easily be hidden by starting the file name with a dot as in .HideMe.md.

The Tree structure can also be replaced alltogether if you add an .order file per folder.

Read more about DevOps Wiki at MS Docs - Wiki files and file structure

Upvotes: 1

ScottWelker
ScottWelker

Reputation: 2084

In brief I'd say no. You can't do all you've outlined using Azure DevOps Wiki. I believe I heard these needs:

  1. Hide pages from an Azure DevOps Wiki. Yes. We could do this a number of ways, e.g., clone the underlying Git repository and work/edit locally until you are ready to share it. Not really what you are looking for. You could also futz with permissions but, again, not really what you're looking for.
  2. Force users to read pages in a specific order. No. I don't believe this can be done. It's contrary to Wiki Design Principles.
  3. Dynamically hide and later dynamically show a page(s) in the right-hand menu. No. I don't believe this can be done. It's contrary to Wiki Design Principles.

Azure DevOps Wiki could be made to meet some of these needs but I know of no way to stitch them together as you've outlined.

It sounds like you want to create a tightly orchestrated computer-based-training course (CBT). Wiki isn't the right tool for that. Wiki is more about open, loosely-structured, collaborative knowledge sharing.

Upvotes: 1

Kenny
Kenny

Reputation: 109

Files and folders starting with a '.' are now ignored...

https://developercommunity.visualstudio.com/idea/366488/hide-folders-in-wiki-like-pages.html

Upvotes: 7

Related Questions