Tuleap: Как работать с версионной вики документацией

350
Djuro Drljaca

Моя ситуация такова:

Я оцениваю Tuleap v8.2, и я хотел бы иметь документацию по программному обеспечению проекта (например, архитектуру и дизайн) в вики (насколько я вижу, он использует движок PhpWiki). Я также хотел бы иметь трекеры для архитектуры и дизайна (по одному для каждого и связанные в иерархии), где я бы просто добавил ссылку на конкретную вики-страницу, соответствующую этому артефакту.

Я уже настроил трекеры, но у меня возникают проблемы с организацией страниц вики (у меня почти нет опыта работы с вики). Самая большая проблема связана с «версионированием» документов. Насколько я вижу, у меня есть 2 варианта:

1) сделать все ссылки на вики-страницы с определенной (вики) версией

2) организовать вики-страницы таким образом, чтобы они были организованы в «иерархию версий», где у меня была бы «корневая вики-страница» для каждого выпуска / версии программного обеспечения.

Проблемы, связанные с вариантом 1), заключаются в том, что для выпуска вам нужно будет просмотреть все артефакты в трекерах архитектуры и дизайна и обновить ссылки на вики-страницы для ссылки на конкретную (последнюю) версию. Это может быть много работы ...

Проблема, которую я вижу с вариантом 2), заключается в том, что я не вижу возможности скопировать «ветку версии» вики-страниц в новую «ветку версии».

Я думаю, вариант 1) будет лучшим решением ...

Есть и другие проблемы со ссылками на вики-страницы с трекера:

  • Похоже, что «справочная система» не очень хороша для вики-страниц. Из того, что я видел, вики-подстраницы могут быть созданы только с использованием разделителя "/" в имени вики-страницы, и это противоречит способу разделения параметров в "справочной системе".

  • Также кажется, что вы не можете ссылаться на вики-страницы, в имени которых есть пробелы (и, я думаю, другие специальные символы).

Я думаю, что единственное решение (на данный момент) это просто использовать полный URL-адрес вики-страницы ...

Редактировать:

Итак, мой вопрос ... каков наилучший способ использования и организации вики Tuleap в моем случае?

0
Какой у Вас вопрос? DavidPostill 8 лет назад 0
@ Давид: я обновил пост с явным вопросом :) Djuro Drljaca 8 лет назад 0

0 ответов на вопрос

Похожие вопросы