Documentation insight vs Doc-O-Matic

[pHL]

Hallo Leute.

Da ich mich in nächster Zeit gerne für ein Source-Dokumentationstool entscheiden möchte hätte ich noch gerne ein paar Meinungen von euch.

In meiner engeren Auswahl sind nun "Documentation Insight (Enterprise)" und "Doc-O-Matic (Professional)". Einmal abgesehen vom Preis habe ich auf den ersten Blick folgende Unterschiede erkennen können.

Documentation Insight:

• + Integration in die IDE
• - Dokumentation nur im Source möglich

Doc-O-Matic:

• - Keine Integration in die IDE
• + Dokumentation kann in eigene Dateien ausgelagert werden

Hat jemand von euch Erfahrungswerte mit einem der beiden Tools bzw. kennt ihr Quellen wo die Unterschiede aufgezeigt werden?
Für Doc-O-Matic habe ich bis jetzt nur sehr wenig gefunden (leider auch keine Anleitung).

Danke im Vorraus
pHL

[himitsu]

Zitat von pHL:

Documentation Insight:

• - Dokumentation nur im Source möglich

Man überlegt schon (seit mindestens 2 Jahren), wie und ob die Dokumentationen, innerhalb der Units oder auch ganz da raus, verschoben werden können.

Aber ob/wann die das mal schaffen .........




Nja, zumindestens ist die Hilfe innerhalb der IDE nicht schlecht.
Du kannst Funktionen dokumentieren und bekommst beim Programmieren diese Infos direkt angezeigt.

[pHL]

Zitat von himitsu:

Nja, zumindestens ist die Hilfe innerhalb der IDE nicht schlecht.
Du kannst Funktionen dokumentieren und bekommst beim Programmieren diese Infos direkt angezeigt.

Das mit der direkten Info beim Programmieren ist natürlich sehr toll. Aber funktiniert das nicht mit allen XML-Kommentaren (welche man ja auch mit doc-o-matic) erstellen könnte?

[himitsu]

Aber die müssten dann wohl auch mit an der selben Stelle in der PAS liegen.
Und wenn man schon beim Programmieren ist, dann kann man von da aus diese Kommentare auch gleich bearbeiten.

Ich finde diese Kommentare mitten im Quellcode zwar immernoch störend, wenn man in dem Code rumstöbert, aber zumindestens wird es etwas besser, wenn man diese Kommentare in Regions einschließt und zusammenfaltet.


In wie weit das aber mit der Erzeugung einer externen Hilfe aussieht, kann ich allerdings nicht beurteilen.

[pHL]

Ohne den Regions wäre das ganze sowieso nicht tragbar

Zitat von himitsu:

In wie weit das aber mit der Erzeugung einer externen Hilfe aussieht, kann ich allerdings nicht beurteilen.

Danke für die Info. Das muss ich unbedingt noch testen. Ich kann mir aber nicht vorstellen dass es dann nicht mehr funktionieren sollte.

Aber so wie es aussieht sind die zwei Punkte in meinem Eingangspost wirklich der Hauptunterschied (von dem Preis abgesehen).

[Uwe Raabe]

Es läuft gerade eine offene Beta für die nächste Version von Documentation Insight. Wenn du bei Google+ bist, kannst du das über die DevJet Software Community verfolgen. Für einen Überblick zu neuen Features gibt es diesen Blog-Eintrag: http://www.devjetsoftware.com/produc...ion-insight-3/

Es ist aber in jedem Fall so, daß die integrierten Hints nur mit Doku im Quelltext gehen.

Ich habe übrigens beide Tools hier, arbeite aber für Quelltextdoku nur noch mit DI - das ist wesentlich bequemer.