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

[Der schöne Günther]

Oh, es geht weiter. Schön dass es sich nach der Internet-Kneipenschlägerei wieder beruhigt hat-

Die Verwertungsrechte der Nutzerbeiträge sind ja jetzt schon jetzt im DocWiki geklärt:

Zitat:

Bitte beachte, dass alle Beiträge zu RAD Studio API Documentation von anderen Mitwirkenden bearbeitet, geändert oder gelöscht werden können. Reiche hier keine Texte ein, falls du nicht willst, dass diese ohne Einschränkung geändert werden können.

Du bestätigst hiermit auch, dass du diese Texte selbst geschrieben hast oder diese von einer gemeinfreien Quelle kopiert hast (weitere Einzelheiten unter RAD Studio API Documentation:Urheberrechte). ÜBERTRAGE OHNE GENEHMIGUNG KEINE URHEBERRECHTLICH GESCHÜTZTEN INHALTE!

Mein großes Fragezeichen (das habe ich anfangs nicht bedacht) ist die Sprache:
Bislang liegt die Dokumentation entweder nicht oder gleich in allen vier Sprachen vor (EN, DE, FR, JA). Ich habe keinen Ansatz wie man verfahren könnte, dass sich das nicht ändert. Embarcadero wird (verständlicherweise) vermeiden wollen, dass sich verschiedene Sprachversionen inhaltlich nicht exakt gleichen.


Auch: Es gibt ja im Endeffekt eine Vielzahl an RAD Studio DocWikis: XE3, XE4, XE5, ...
Wie löst Embarcadero das technisch? Würde es ausreichen, den XE4-Artikel zu TIntegerHelper zu ändern damit sich das auf XE4-XE6 auswirkt?

Zitat von sh17:

<OT>Ist Furtbichler jetzt raus aus dem Rennen (der DP) </OP>

Finde ich wirklich enttäuschend. Fachlich konnte ich bei ihm trotz oft krassen Formulierungen nur staunen, aber so tumb und provokant eine verbale Messerstecherei anzuzetteln und dann mit fliegenden Schößen zu verschwinden? Ich behalte ihn trotzdem als eine Art Reich-Ranicki des Software Engineering in Erinnerung.

[bernau]

Wie mquadrat schon schrieb: Die Nutzerkommentare im PHP.net sind echt ne feine Sache. Würde schon was bringen, wenn man so was in das DocWiki von Emba bringen konnte. Anhand der Nutzerkommentare kann man auch sehr gut die Dringlichkeit sehen.

[Stevie]

Zitat von Smut:

Unabhängig meiner persönlichen Meinung zu dem Thema im Ganzen:
Die Doku muss in (allen?) den 4 Sprachen konsistent sein... man stelle sich vor, was sonst passieren würde. DE + English gut, FR fehlanzeige

Meine Meinung: wenn nur Englisch vorhanden ist, ist das besser, als wenn gar nix vorhanden ist.
Auch wenn man des englischen nicht mächtig ist, können die diversen Übersetzungstools gute Arbeit leisten, damit man versteht, was gemeint ist (ziehe MSDN, wo viele Einträge maschinell übersetzt sind)

Zitat von Smut:

aus welchem Film hab ich das

Die Unbestechlichen

[p80286]

Zitat von Daniel:

.... dann muss man seine Inhalte jedoch in brauchbarem Englisch ....

Zitat von Stevie:

....können die diversen Übersetzungstools gute Arbeit leisten, damit man versteht, was gemeint ist (ziehe MSDN, wo viele Einträge maschinell übersetzt sind)

Wie die Übersetzung vom Englischen ins Deutsche ist weiß ich nicht, umgekehrt ist das grauslig und sinnentstellend.

Aber dann bliebe vllt. auch für mich etwas zu tun

Gruß
K-H

[BUG]

Auf den Wikiseiten könnte man auch auf bekannte Fehler und QC-Einträge hinweisen. Außerdem fände ich eine Angabe sinnvoll, ab welcher Version ein bestimmtes Feature oder Attribut vorhanden ist.


Nun zu etwas völlig anderem:

Internationalisierung macht alles komplizierter. Solange nicht genug Inhalte und Helfer da sind, ist es wohl vermutlich das Beste, sich erst einmal auf Deutsch (evtl. + Englisch) zu beschränken. Wenn man sich schon am Anfang in diese Richtung zu viele Gedanken macht, kommt man vom Hundersten ins Tausende und es wird nie etwas.

Wenn das Wiki auf deutsch floriert, kann man sich immer noch Sorgen um die Übersetzungen machen.

[sh17]

Zitat von Der schöne Günther:

Zitat von sh17:

<OT>Ist Furtbichler jetzt raus aus dem Rennen (der DP) </OP>

Finde ich wirklich enttäuschend. Fachlich konnte ich bei ihm trotz oft krassen Formulierungen nur staunen, aber so tumb und provokant eine verbale Messerstecherei anzuzetteln und dann mit fliegenden Schößen zu verschwinden? Ich behalte ihn trotzdem als eine Art Reich-Ranicki des Software Engineering in Erinnerung.

Ja, finde ich auch Schade, habe seine Beiträge immer gern gelesen.

[OlafSt]

Zitat von BUG:

Wenn das Wiki auf deutsch floriert, kann man sich immer noch Sorgen um die Übersetzungen machen.

Tatsächlich ist es so, das die Übersetzer dann schon von ganz aleine kommen. Nur muß die Sache erstmal in Fahrt gekommen sein.

[mquadrat]

Denkt ihr da jetzt nicht ein bisschen zu groß? Die Grunddoku sollte IMHO Leuten überlassen werden, die dafür bezahlt werden. Denn nur dann kann ich auch etwas fordern. Wenn jemand, der das in seiner Freizeit macht, keine Lust mehr hat, hat er keine Lust mehr. Angefangenes wird nicht zu Ende gebracht, Beispiele werden nicht aktualisiert, etc etc. Dazu kommt, dass meiner Meinung nach die Hemmschwelle einen ganzen Artikel zu schreiben oder zu redigieren deutlich höher ist, als "mal eben" einen Kommentar mit einem nützlichen Hinweis zu hinterlassen. Optimal fände ich eine zweigeteilte Seite: oben das Original-DokWiki und untendrunter Kommentare. Unter Umständen ließe sich das sogar über die DP Forensoftware abbilden (jede Wiki Seite -> ein Thema im Unsere-Hilfe-soll-schöner-werden-Bereich). Von mir aus kann man die einzelnen Kommentare dann noch mit +1 -1 bewerten. Was runtergewertet wird, wird irgendwann rausgenommen. Die Top-Kommentare kriegen ein Sternchen und Emba könnte diese dann in die Hilfe integrieren, da sie ja scheinbar vielen genutzt haben.

Ziel der Übung: Ein kleines, schnell aufgebautes System mit direktem Nutzen. Möglichst niedrige Hemmschwelle zum Mitmachen. Ich fürchte, wenn man das zu groß aufzieht, dann wird es scheitern.

[bernau]

Zitat von mquadrat:

Ziel der Übung: Ein kleines, schnell aufgebautes System mit direktem Nutzen. Möglichst niedrige Hemmschwelle zum Mitmachen. Ich fürchte, wenn man das zu groß aufzieht, dann wird es scheitern.