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

[Der schöne Günther]

Man kann sich sicher drüber streiten: Sollen im Jahr 2014 noch Hinweise, dass eine Funktion erst ab einem Pentium mit 90 MHz zur Verfügung steht, weiterhin bestehen bleiben?

Aber handfeste Fehler gehören nicht in eine Dokumentation. Ich möchte nicht alles aufzählen was mir über den Weg gelaufen ist. Aber absolute Falschaussagen sind zur Genüge vorhanden. Fehlerhafte Schritt-für-Schritt Anleitungen wie Vorlagenbibliotheken erstellen (die es dementsprechend auch ins neue Produkt AppMethod schaffen), ganz zu schweigen von "Embarcadero Technologies verfügt zurzeit über keine zusätzlichen Informationen. Bitte unterstützen Sie uns bei der Dokumentation dieses Themas, indem Sie Ihre Kommentare auf der Diskussionsseite eingeben."

Also! *Händereib*

Was kann ich, als normaler Benutzer, hier tun? Das DocWiki ist, trotz "Wiki" im Namen, nicht editierbar. QC Reports taugen für die Überarbeitung der reinen Dokumentation wohl auch nicht.

Es ginge ja nicht nur um Fehlerbehebungen, sondern auch das komplette (Neu-)Verfassen von Artikeln. Ich persönlich wäre bereit, da einiges an Zeit zu investieren. Denn das käme nicht nur mir zu Gute, sondern auch einer Menge anderen Benutzern, ebenso wie Embarcadero.

Und ich spreche noch nicht mal von der technischen Umsetzung in Form unseres Freundes dexplore.exe

Schlagen bei mir nur grade die Hormone über oder sieht jemand das ähnlich? Ich bin nur so ratlos, wo und wie man ansetzen kann.

[Insider2004]

Delphi ist kein Open Source Projekt. Du willst kostenlos arbeiten und auch noch Kohle dafür bezahlen?

[Der schöne Günther]

Ich bringe sogar Essen und gutes Wetter mit.

Ich formuliere anders: Was muss man anstupsen, damit sich von Embarcadero aus was ändert? Wenn man einen unserer MVPs dazu bringen könnte, sich mit Überzeugung hinzustellen und zu sagen

Zitat:

Macht euer DocWiki editierbar. Wenigstens für eine geschlossene Gruppe. Die Manpower ist da

- Warum denn nicht?

[Stevie]

Zitat von Der schöne Günther:

Was muss man anstupsen, damit sich von Embarcadero aus was ändert?

Möglicherweise ihn.

[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 ...

[Furtbichler]

Zitat von Insider2004:

Delphi ist kein Open Source Projekt. Du willst kostenlos arbeiten und auch noch Kohle dafür bezahlen?

[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.

[Uwe Raabe]

Zitat von Insider2004:

Delphi ist kein Open Source Projekt. Du willst kostenlos arbeiten und auch noch Kohle dafür bezahlen?

Ist vielleicht effizienter als endloses Rumgemeckere - außer man steht auf Meckern.

[Furtbichler]

Zitat von Uwe Raabe:

Zitat von Insider2004:

Delphi ist kein Open Source Projekt. Du willst kostenlos arbeiten und auch noch Kohle dafür bezahlen?

Ist vielleicht effizienter als endloses Rumgemeckere - außer man steht auf Meckern.

Er hat aber Recht. Dieses eine Mal hat er nicht ganz Unrecht.