#azure-devops #wiki
#azure-devops #Вики #azure-devops-wiki
Вопрос:
Мне было поручено документировать, как мы собираемся использовать Azure DevOps. Это что-то новое для нашей команды.
Я работаю над вики для различных инструкций, руководств, стандартов и т. Д.
Я хочу заставить пользователей читать страницы в определенном порядке. Но я не обязательно хочу, чтобы они переходили непосредственно на страницу в дереве.
Вот моя структура
Итак, для репозиториев, если читателю необходимо перенести существующий репозиторий git в Azure DevOps, я хочу прочитать
- Создайте новое репозиторий DevOps
- Измените локальные репозитории на Azure DevOps
- Перенесите существующий репозиторий Git в Azure DevOps
Но я не хочу, чтобы эти страницы были видны в дереве. У меня будет другая страница со ссылками на эти страницы.
Возможно ли это вообще? Мои исследования мало что дали в плане помощи.
Ответ №1:
Файлы и папки, начинающиеся с ‘.’, теперь игнорируются…
https://developercommunity.visualstudio.com/idea/366488/hide-folders-in-wiki-like-pages.html
Ответ №2:
Короче говоря, я бы сказал, что нет. Вы не можете сделать все, что вы описали, используя Azure DevOps Wiki. Я полагаю, что слышал эти потребности:
- Скрыть страницы из Azure DevOps Wiki. Да. Мы могли бы сделать это несколькими способами, например, клонировать базовый репозиторий Git и работать / редактировать локально, пока вы не будете готовы поделиться им. Не совсем то, что вы ищете. Вы также можете использовать разрешения, но, опять же, это не совсем то, что вы ищете.
- Заставлять пользователей читать страницы в определенном порядке. Нет. Я не верю, что это можно сделать. Это противоречит принципам проектирования Вики.
- Динамически скрывать, а затем динамически отображать страницы в правом меню. Нет. Я не верю, что это можно сделать. Это противоречит принципам проектирования Вики.
Azure DevOps Wiki может быть создана для удовлетворения некоторых из этих потребностей, но я не знаю способа соединить их вместе, как вы описали.
Похоже, вы хотите создать жестко организованный компьютерный учебный курс (CBT).Wiki не является подходящим инструментом для этого. Wiki — это больше открытый, слабо структурированный совместный обмен знаниями.
Комментарии:
1. Спасибо за подтверждение. Очень признателен. На ваш взгляд, нам нужны оба. Документация, которую я пишу, будет использоваться как для обучения, так и для справки. Спасибо
2. В таких случаях, как ваш, у меня были положительные результаты с использованием Wiki для составления желаемой документации — вроде обработки вики-страниц как «исходного кода» — а затем создания / преобразования этой документации в желаемый формат (CBT в вашем случае). Могут быть полезны такие инструменты, как Padoc (и другие). pandoc.org/MANUAL.html
Ответ №3:
Да, это вполне возможно. Поскольку Wikis поддерживает ссылки (даже относительные ссылки). Вы можете настроить следующие и предыдущие ссылки на каждой странице, чтобы заставить людей читать документы в определенном порядке.
Файлы можно легко скрыть, начав имя файла с точки, например .HideMe.md
.
Древовидная структура также может быть заменена полностью, если вы добавите .order
файл в папку.
Подробнее о DevOps Wiki читайте в MS Docs — Файлы и структура файлов Wiki
Комментарии:
1. Спасибо за ваш вклад. Я приму это к сведению.
2. @Dennis Это умный взлом, который в основном соответствует первоначальному запросу. Креатив.