Die Dokumentation muss besser werden. Wie können WIR helfen?

[Bernhard Geyer]

Zitat von Insider2004:

Gar nix!!! Die Dokumentation war perfekt und vollständig. In Delphi 7. Dann hat ein "Experte" bei Borland alles kaputt gemacht.

Wird wohl daran liegen das das hlp-Format abgekündigt war und das damalige Authoring-Tool nur HLP-Konnte und auch nicht weiterentwickelt wurde. Es musste also was gemacht werden. Das das Ergebnis lange nicht gepasst hat ist was anderes ...

[himitsu]

Es muß ja nicht direkt editierbar sein.

Ein Link, wo man für diesen Eintrag seine Änderungsvorschläge hinschicken kann, würde ja auch schon reichen.

http://docwiki.embarcadero.com/Libra...kInheritsClass
In der Onlineversion gibt es dafür ja scheinbar einen entsprechenden Tab. (da grade nicht eingeloggt, konnte ich nicht erkennen, ob man da wirklich was schreiben kann)
Wie das in der lokalen Hilfe aussieht, weiß ich grade nicht, da ich so schnell keine nichtvorhadene Seite fand.


Das Problem ist nur, daß es
A) Scheinbar keine Liste der Fehlenden Einträge gibt, wo man mal nachsehen könnte, ob es bei einem Thema was (nicht) gibt, wozu man eventuell was schreiben könnte.
B) Ich meistens auf soeiner Seite lande, wenn ich nachsehen will, was das eigentlich ist/macht ... und da ich das ja nicht weiß, kann ich demnach auch nicht helfen.

[Der schöne Günther]

Und wer wird dann abgestellt, die eingereichten Vorschläge

• zu sichten
• zu bewerten
• auszusortieren
• über anstehende Änderungen zu entscheiden
• die Änderungen tatsächlich einzupflegen
• die Änderungen in die anderen Sprachen (DE, FR, JA) zu übersetzen?

Da bei Embarcadero sicherlich niemand dafür abgestellt wird kam mir ja der "Die Community wird es schon richten"-Gedanke

Über die Sprache habe ich mir ehrlich gesagt keine Gedanken gemacht: Man muss ja lobenswerterweise erwähnen, dass bei Embarcadero die Artikel immer direkt in allen Sprachen gleich vorliegen. Das werden die sicher nicht ändern wollen.

[p80286]

Zitat von Bernhard Geyer:

Zitat von Insider2004:

Gar nix!!! Die Dokumentation war perfekt und vollständig. In Delphi 7. Dann hat ein "Experte" bei Borland alles kaputt gemacht.

Wird wohl daran liegen das das hlp-Format abgekündigt war und das damalige Authoring-Tool nur HLP-Konnte und auch nicht weiterentwickelt wurde. Es musste also was gemacht werden. Das das Ergebnis lange nicht gepasst hat ist was anderes ...

Das kann doch nicht Dein Ernst sein. So dusselig kann doch ein Profi nicht sein, daß er sich auf ein Format festlegt und sobald es nicht mehr unterstützt wird ist alles perdu?

Es sollte doch wohl machbar sein ohne großen Aufwand, die 7er Doku zu recyclen.

Gruß
K-H

[Bernhard Geyer]

Zitat von p80286:

Zitat von Bernhard Geyer:

Zitat von Insider2004:

Gar nix!!! Die Dokumentation war perfekt und vollständig. In Delphi 7. Dann hat ein "Experte" bei Borland alles kaputt gemacht.

Wird wohl daran liegen das das hlp-Format abgekündigt war und das damalige Authoring-Tool nur HLP-Konnte und auch nicht weiterentwickelt wurde. Es musste also was gemacht werden. Das das Ergebnis lange nicht gepasst hat ist was anderes ...

Das kann doch nicht Dein Ernst sein. So dusselig kann doch ein Profi nicht sein, daß er sich auf ein Format festlegt und sobald es nicht mehr unterstützt wird ist alles perdu?

Es sollte doch wohl machbar sein ohne großen Aufwand, die 7er Doku zu recyclen.

Weißt du das das das so einfach recyclebar gewesen sein müsste? Dazu müsste man wissen was eingesetzt wurde? Evtl. wurde ja schon Jahrelang an einem Fragilen HLP-Konstrukt herumgedoktert das einfach schon so kaputt war das es nur in Einzelarbeit in ein neues Format Wandelbar gewesen wäre.

[Stevie]

Ich hör immer Delphi 7 Hilfe war so toll, fehlt denn in der aktuellen Hilfe irgendwas, was in der Delphi 7 Hilfe noch drin war oder ist es nicht eher so, dass die neuen Features unzureichend dokumentiert sind.

Das ist eine ganz ehrliche Frage, ich hab nämlich schon seit Jahren die Delphi Hilfe nicht mehr installiert, was aber eher an dem Drecks Document Explorer liegt. Und wenn ich sie denn mal brauche reicht mir nen Browser, dass ich es im docwiki nachschauen kann.

Zitat von Furtbichler:

Stevie, [...]. Los, zeigt, was ihr könnt (außer meckern)
Wir destruktiven Meckerer warten dann und profitieren von eurer Arbeit. Danke im Voraus

Lass mich kurz überlegen, ich entwickle aktiv an 2 Open Source Bibliotheken (deren Dokumentation derzeit übrigens zu wünschen übrig lässt, welch Zufall), trage zu einem weiteren halben Duzend mehr oder weniger regelmäßig bei, trage regelmäßig Bugs im QC ein, bin in diversen Delphi Communities aktiv und spreche auf Delphi Konferenzen um nur mal einige Dinge zu nennen - ich bin mir sicher, ihr profitiert schon mehr oder weniger von meiner Arbeit.

P.S. Das war meine Dosis Überheblichkeit für heute

[Perlsau]

Zitat von Stevie:

Lass mich kurz überlegen, ich entwickle aktiv an 2 Open Source Bibliotheken (deren Dokumentation derzeit übrigens zu wünschen übrig lässt, welch Zufall), trage zu einem weiteren halben Duzend mehr oder weniger regelmäßig bei, trage regelmäßig Bugs im QC ein, bin in diversen Delphi Communities aktiv und spreche auf Delphi Konferenzen um nur mal einige Dinge zu nennen - ich bin mir sicher, ihr profitiert schon mehr oder weniger von meiner Arbeit.

Du mußt ja viel Zeit haben, wenn du das alles ohne Bezahlung machen kannst. Ich könnte mir das nicht leisten. Wäre es anders, würde ich dennoch von niemandem erwarten, ebenfalls ohne Bezahlung zu arbeiten, nur weil ich gerade nichts besseres zu tun habe.

[Stevie]

Zitat von Perlsau:

Du mußt ja viel Zeit haben, wenn du das alles ohne Bezahlung machen kannst. Ich könnte mir das nicht leisten. Wäre es anders, würde ich dennoch von niemandem erwarten, ebenfalls ohne Bezahlung zu arbeiten, nur weil ich gerade nichts besseres zu tun habe.

Einerseits hab ich damals als ich eins meiner Hobbies zum Beruf gemacht habe, nicht aufgehört es mein Hobby sein zu lassen und andererseits sind einige von den Dingen, die ich entwickelt habe aus einer Idee bei meiner Arbeit entstanden und haben sich bzw wurden weiter entwickelt. Und da man seine eigene Software am besten auch selbst benutzt (dogfooding), ist das für beide Seiten eine Win-Win Situation.

[Perlsau]

Und wozu erzählst du das alles hier? Einfach so oder doch als Argument, daß alle anderen doch bitte auch zur Verbesserung der Delphi-Online-Hilfe beizutragen hätten?

[Uwe Raabe]

Zitat von Bernhard Geyer:

Weißt du das das das so einfach recyclebar gewesen sein müsste? Dazu müsste man wissen was eingesetzt wurde? Evtl. wurde ja schon Jahrelang an einem Fragilen HLP-Konstrukt herumgedoktert das einfach schon so kaputt war das es nur in Einzelarbeit in ein neues Format Wandelbar gewesen wäre.

Dieser alte Post von Dee Elling beschreibt ansatzweise, was da wohl passiert ist: Old Help and New