Tuleap: Umgang mit versionierter Wiki-Dokumentation

424
Djuro Drljaca

Meine Situation ist so:

Ich bewerte Tuleap v8.2 und würde gerne die Softwaredokumentation eines Projekts (zum Beispiel Architektur und Design) in einem Wiki haben (soweit ich es für richtig halte, dass es die PhpWiki-Engine verwendet). Ich hätte auch gerne Tracker für Architektur und Design (eine für jede und eine Hierarchie verknüpft), wo ich im Grunde nur einen Link zu einer bestimmten Wiki-Seite hinzufüge, die diesem Artefakt entspricht.

Ich habe bereits die Tracker eingerichtet, aber ich habe Probleme mit der Organisation der Wiki-Seiten (ich habe fast keine Erfahrungen mit Wikis). Das größte Problem ist die "Versionierung" der Dokumente. Soweit ich sehe, habe ich zwei Möglichkeiten:

1) Stellen Sie alle Verweise auf Wiki-Seiten mit einer bestimmten (Wiki) Version

2) die Wiki-Seiten so organisieren, dass sie in einer "Versionshierarchie" organisiert sind, wobei ich für jede Softwareversion / -version eine "Root-Wiki-Seite" hätte.

Das Problem mit Option 1) besteht darin, dass Sie für ein Release alle Artefakte in Architektur- und Design-Trackern durchlaufen und die Verweise auf Wiki-Seiten aktualisieren müssen, um eine Verknüpfung zu der jeweiligen (neuesten) Version herzustellen. Das könnte viel Arbeit sein ...

Das Problem, das ich bei Option 2 sehe, ist, dass ich keine Möglichkeit sehe, einen "Versionszweig" von Wiki-Seiten in einen neuen "Versionszweig" zu kopieren.

Ich denke die Option 1) wäre die bessere Lösung ...

Und es gibt auch andere Probleme beim Verlinken von Wiki-Seiten von einem Tracker:

  • Es scheint, dass das "Referenzsystem" nicht gut mit Wiki-Unterseiten spielt. Von dem, was ich gesehen habe, können Wiki-Unterseiten nur durch Verwenden eines "/" Trennzeichens im Namen der Wiki-Seite erstellt werden. Dies steht im Konflikt mit der Art und Weise, wie Parameter im "Bezugssystem" getrennt werden.

  • Es scheint auch, dass Sie nicht in der Lage sind, Wiki-Seiten zu verlinken, deren Namen Leerzeichen enthalten (und ich denke, andere Sonderzeichen).

Ich denke, die einzige Lösung (im Moment) ist, einfach die vollständige URL einer Wiki-Seite zu verwenden ...

Bearbeiten:

Meine Frage ist also: Wie kann ich Tuleaps Wiki in meinem Fall am besten nutzen und organisieren?

0
Was ist deine Frage? DavidPostill vor 9 Jahren 0
@ David: Ich habe den Beitrag mit einer expliziten Frage aktualisiert :) Djuro Drljaca vor 9 Jahren 0

0 Antworten auf die Frage