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

[Nersgatt]

Mir würde auch eine (optionale) Offline-Lösung mehr gefallen, als eine reine Onlinelösung.
Wobei das Wiki, was Sebastian ansprach, ja ein Sammelbecken/Zentralpunkt sein kann, woraus dann eine Offlinemöglichkeit generiert wird.

[mkinzler]

Die Bereitstellung eines Wikis wäre kein Problem. Es ist nur die Frage, ob EMBT uns erlaubt Ihren Content (Inhalt Hilfe/Onlinedoku) dort einzufügen (um ihn dort Korrekturen/Ergänzungen zu erlauben)

[Satyr]

Ich habe mal irgendwo hier im Forum gelesen das es hier Leute mit Kontakt zu Emba gibt. Hat man da schon mal versucht Emba anzusprechen? Vielleicht haben die auch Ideen wie eine Art Zusammenarbeit in dem Bereich aussehen könnte.

[bernau]

Ja, hier lesen Leute von Emba mit. Deshalb finde ich es auch gut, daß "Der schöne Günther" diesen Thread eröffnet hat.

[Daniel]

Meiner Ansicht nach können wir nur "ergänzend" arbeiten - wir können nicht einfach ein eigenes Wiki aufziehen, dessen Basis die Delphi-Hilfe darstellt.

Entweder geht man gleich in das Original-Wiki, dann muss man seine Inhalte jedoch in brauchbarem Englisch beisteuern oder wir basteln und selbst etwas, mit dem wir in der DP arbeiten können und dies als Teil der Referenz verwenden. Von hier aus ist der Weg in das offizielle Wiki nicht ausgeschlossen: Ich habe passende Kontakte in die Staaten und könnte auf diesem Weg auch versuchen, ausgewählte Inhalte von uns zu denen transferieren zu lassen.

Wenn es das Ziel sein soll, dass die erarbeiteten Inhalte in das DocWiki gelangen, dann müssen wir uns von Anfang an auf eine inhaltliche und sprachliche Form (auch auf Deutsch) verständigen, die das überhaupt zulässt. Wobei ich mir aktuell noch nicht im Klaren bin, wie eine technische Realisierung überhaupt aussehen könnte. Lediglich ein Wiki auf einen Webspace zu klatschen scheint mir noch nicht genug an Integration und Unterstützung.

Der Ansatz, lokal in der DP zu beginnen, hätte den Charme, dass Erfolge unmittelbar sicht- und greifbar werden, wenn die Inhalte in die Online-Referenz integriert werden.

[Satyr]

Zitat von Daniel:

Wenn es das Ziel sein soll, dass die erarbeiteten Inhalte in das DocWiki gelangen, dann müssen wir uns von Anfang an auf eine inhaltliche und sprachliche Form (auch auf Deutsch) verständigen, die das überhaupt zulässt. Wobei ich mir aktuell noch nicht im Klaren bin, wie eine technische Realisierung überhaupt aussehen könnte. Lediglich ein Wiki auf einen Webspace zu klatschen scheint mir noch nicht genug an Integration und Unterstützung.

Wäre es theoretisch möglich das jemand ein kleines Plugin für Delphi bastelt, das von dort aus mit diesem Wiki kommunizieren kann? Also eine Art zweite, integrierte, Hilfe?
Ich frage weil ich mit sowas keine Erfahrung habe aber weiß wie gut sich GExperts & Co. integrieren können.

[Nersgatt]

Zitat von Daniel:

Wenn es das Ziel sein soll, dass die erarbeiteten Inhalte in das DocWiki gelangen, dann müssen wir uns von Anfang an auf eine inhaltliche und sprachliche Form (auch auf Deutsch) verständigen, die das überhaupt zulässt.

Auch muss vorher geklärt werden, unter welcher Lizenz Beiträge in dem Wiki stünden, damit das rechtlich überhaupt übernommen werden darf.

[Daniel]

Zitat von Nersgatt:

Auch muss vorher geklärt werden, unter welcher Lizenz Beiträge in dem Wiki stünden, damit das rechtlich überhaupt übernommen werden darf.

Das ist ein guter Hinweis - das gesamte Projekt müsste so gestaltet sein, dass alle Inhalte mit dem (einzigen) Ziel eingestellt werden, am Ende in der offiziellen Hilfe zu landen. Alles andere ergäbe keinen Sinn. Aber natürlich muss das vorher so kommuniziert werden, dass dies jedem Beteiligten klar ist.

[Nersgatt]

Zitat von Daniel:

Zitat von Nersgatt:

Auch muss vorher geklärt werden, unter welcher Lizenz Beiträge in dem Wiki stünden, damit das rechtlich überhaupt übernommen werden darf.

Das ist ein guter Hinweis - das gesamte Projekt müsste so gestaltet sein, dass alle Inhalte mit dem (einzigen) Ziel eingestellt werden, am Ende in der offiziellen Hilfe zu landen. Alles andere ergäbe keinen Sinn. Aber natürlich muss das vorher so kommuniziert werden, dass dies jedem Beteiligten klar ist.

Genau so!

[Perlsau]

Zitat von Daniel:

Das ist ein guter Hinweis - das gesamte Projekt müsste so gestaltet sein, dass alle Inhalte mit dem (einzigen) Ziel eingestellt werden, am Ende in der offiziellen Hilfe zu landen. Alles andere ergäbe keinen Sinn.

Zwar kann ich mich jetzt wirklich nicht als Embarcardero-Insider bezeichnen, doch habe ich im Lauf der Jahre den Eindruck gewonnen, daß Embarcardero nicht unbedingt daran interessiert ist, von außen kommende Verbesserungen ihrer Produkte integrieren zu wollen. Das beste Beispiel ist wohl das Fixpack, das weiterhin von Herrn Hausladen aktuell gehalten wird, weil die Entwickler bei Emba die darin enthaltenen Verbesserungen offenbar nicht in ihr Produkt einzubauen bereit sind. Die sparen sich Arbeitszeit und lassen den guten Mann weiterhin umsonst ausbessern, was eigentlich ihre Aufgabe wäre.

Dasselbe könnte auch mit Ergänzungen der Online-Hilfe geschehen. Daher könnte es schon Sinn machen, das genannte Ziel nicht dermaßen einzuschränken, sondern auch die Möglichkeit offen zu lassen, eine Ersatz-Online-Hilfe zu entwickeln, die man anstelle der offiziellen OH einbinden kann. Auch da müßte man natürlich auch erst Emba um Erlaubnis bitten, da ja auch unter Emba-Copyright stehende Inhalte übernommen werden müßten.