Benutzt ihr die "Embarcadero-Partnerprodukte"?

[himitsu]

Wobei Emba das DocInsight nicht entfernt hat (mal nicht deren Schuld), sondern Devjet hat darum gebeten das nicht mehr mit auszuliefern.

[mquadrat]

Naja, DocInsight sollte man IMHO gar nicht brauchen. Einfach so wie bei allen Java / .NET / xy IDEs die Kommentar-Stubs automatisch erzeugen. Bei DevJet kann ich das schon verstehen. die dürften nicht mehr so viel verkauft haben, wobei es jetzt ja recht viele nachkaufen werden. Sollte also in Summe wieder passen.

[himitsu]

Du meinst so wie in der OH, wo auch nur alles automatisch erzeugt wird und dann gefühlt jeder zweite Eintrag so lautet wie "Das ist das Property Text der Klasse TEdit" ala "hier steht nix, was man nicht vorher auch schon wusste" ?

Und nein, ich hab das genutzt (und nutze es immernoch), um den Code zu Dokumentieren (integrierte Hilfe) und vorallem damit die Hilfe (z.B. Parameterbeschreibung) dort steht, wo sie wichtig ist, also im HelpInsight, welches alternativ vom DocInsight gefüttert wird. (ansonsten von der RTTI)

[mkinzler]

Wenn man mehr in die Kommentare schreibt, landet auch automatisch mehr in der Doku.

[Dejan Vu]

Zitat:

Zitat von himitsu (Beitrag 1273916)

Du meinst so wie in der OH, wo auch nur alles automatisch erzeugt wird und dann gefühlt jeder zweite Eintrag so lautet wie "Das ist das Property Text der Klasse TEdit" ala "hier steht nix, was man nicht vorher auch schon wusste" ?

Eine Dokumentation, die existiert, aber leer ist, ist viel mehr als eine Dokumentation die gar nicht existiert. Denn eine existierende Doku lässt sich sukzessive füllen (Pfadfinderart: Jeden Tag ein bischen). Mach das mal mit einer nicht existierenden Doku... ;-)

[himitsu]

Ja, ich mach die Doku halt gleich mit beim Schreiben des Codes und würde es garantiert vergessen, wenn ich dann nachher irgendwo anders das nochmal dokumentieren muß.

Vorallem bei der Entwicklung von Klassen ist es so praktischer für mich, da ich gleich seh wo die Doku fehlt, ich mach die Doku dann, wenn ich es noch weiß und bei Änderungen wird das gleich mit angepasst.



Wenn ich bei neuen Property, von denen ich garnicht weiß was die überhaupt machen woll, in die OH guck und dann das "NIX" seh, ist es dennoch nervir.
Und der Spruch "Hilf uns beim Füllen der Hilfe" in den "NIX"-Einträgen ist auch sinnlos, denn wenn ich wüsste was das ist, dann hätt ich da nicht reingeguckt. :stupid:

[Stevie]

Auch DocInsight generiert eine "komplette" (im Sinne von alle Typen und Member sind enthalten nur ohne definierten Text) Hilfe.
D.h. du bekommst son Skelett Doku ohne jemals irgendwo einen einzigen xmldoc Eintrag gemacht zu haben.

[p80286]

Zitat:

Zitat von jaenicke (Beitrag 1273706)

IcoFX ;-)
Kann noch viel mehr ohne dass es was die Funktionalität des alten Bildeditors angeht komplizierter wäre.

Danke, ist mir auf der CT-Seite über den Weg gelaufen. Mal schauen was das WE so hergibt.

@DejanVu @Stevie
Eure Argumentation, ist die des Entwicklers, mir als Kunden/Benutzer ist das herzlich egal. Fehlt etwas dann hat man's erst mal vergessen, gibt es aber einen Eintrag mit einer "Nix-Information", dann bezweifele ich, ob es bei meinem Softwarelieferanten überhaupt so etwas wie Qualitätskontrolle gibt.
(die originalaussage wurde durch die Zensur gestrichen)

Gruß
K-H