!!!Help!!! Anleitung schreiben

[simonschlumpf]

Hallo Forum und vorallem !!!Help!!! Entwickler (hab gehört ihr seid hier zuhause?).

Ich habe von meinem Chef die Aufgabe gefasst, eine Installationsanleitung für !!!Help!!! zu schreiben.

Habt ihr Präferenzen wie das gemacht werden soll? Ich würde es am liebsten in einem Wiki machen, damit die Kollaboration vereinfacht wird, aber soweit ich weiss gibt es kein !!!Help!!! Wiki.

Vorschläge?

Simon

[klaussal]

Ich denke, die Konfiguration ist für viele potentielle User etwas abschreckend.

Vielleicht ließe sich da eine Konfigurations-DB bauen, in der die passenden Haken oder Texte gesetzt werden und die dann die entsprechenden Konfig-Doks in !!HELP!! ausfüllt.

[simonschlumpf]

Hmm, bin eben selber kein Notes Entwickler, nur Anwender der !!!Help!!! installieren musste. Hab damit meine liebe Mühe gehabt und es nun endlich geschafft.

Ich glaube am einfachsten wäre eine Anleitung, die vom erstellen der DB mit dem Template bis zur Konfiguration und Fehlerbehandlung alles abdeckt, das ist auch mein Auftrag.

Die Frage ist nur, in welchem Medium das realisiert werden sollte und ob ihr da Vorlieben habt. Die Doku soll nämlich nicht primär für uns im Geschäft sein, sondern viel mehr einen Beitrag unsererseits, zu einem wirklich guten OS Produkt, zurück in die Community.

[eknori]

Danke für das Angebot zur Erstellung einer Installationsanleitung.

Am liebsten wäre mir eine Datenbank im Stil der Notes Hilfe.

[simonschlumpf]

Ja, das klingt sinnvoll!

Lässt sich so eine Noteshilfe DB einfach erstellen?

Gibts ein Template?

[eknori]

Gibts ein Template?

Ja, das gibt es. Vor kurzem war da noch ein Artikel auf PlanetLotus.org zu dem Thema.  Mal sehen, ob ich den noch finde

[blizzard]

Das war der gute alte Vlad @eknori

hier der link dazu:
http://samurai.alise.lv/lotus.nsf/dx/ibm-help-template-link

[m3]

Gabs nicht auch schon mal ein "überarbeitetes" Help-Template, welches sich im Web "hübscher" verhielt?

[simonschlumpf]

Okay, das sieht ja nicht soo schwer aus

Ich melde mich wenn sobald ich was habe.

Sollte ein Template mit verbesserter Webunterstützung auftauchen, hoffe ich auf Copy / Paste und werde "migrieren".

cheers

[blizzard]

Kleine Anregung von mir, um das Ganze vielleicht auch mit der Community zu lösen:

Wie wäre es, wenn jemand ein wiki aufsetzt und jeder, der Interesse hat zu den einzelnen Modulen/Abschnitten/Stichwörtern schreibt, was er darüber weiss.
Wenn das ernst genommen wird kann das erstens Spass machen und zweitens eine tolle Doku fast automatisch erstellt werden.

[eknori]

Matthias,

das mit dem Wiki hatten wir schon einmal; war nicht sonderlich erfolgreich.
Ich lasse mich aber gerne eines Besseren belehren.

Frage: Hosting? OK, könnte ich bei mir auf dem Server machen. Ist allerdings nur 6000er DSL.

[blizzard]

Naja, wenn er damit anfangen würde und das Wiki mit Leben füllt, und einige das dann praktisch als "Onlinehilfe" benutzen und zusätzlich noch ergänzen bzw. verbesseren wäre das schon was tolles.
Natürlich ist ein leeres Wiki nicht gerade nen Anreiz etwas reinzuschreiben, da geb ich dir Recht. Muss er entscheiden wie er anfangen möchte, war nur ein Vorschlag.

[simonschlumpf]

Hallo

Persönlich würde ich die Anleitung am liebsten in Form eines Wikis machen, wie blizzard sagt, würde das Wiki vermutlich am schnellsten angepasst und erweitert werden.

Das hosting würden wir übernehmen, auf einem hostpoint.ch "SH Server Standard". Die Wiki-Software die Hostpoint out-of-the-box anbietet, ist Mediawiki. Das kenne ich nicht, aber mir ist wichtig, das Die Daten im Wiki gut weitergegeben werden können. Schliesslich können wir nicht garantieren, wielange der Server noch besteht. (Es bestehen aber bei weitem noch keine Pläne den Server aufzugeben)

Das das Wiki einschläft ist natürlich möglich, allerdings werde ich schon einen Grundstock an Infos einpflegen, dann ist der Anfang etwas einfacher.

Wäre das eine zufriedenstellende Lösung?
Kennt jemand ein besseres Wiki als Mediawiki? (Speziell um Daten zu ex- und Importieren)
Spricht grundsätzlich etwas gegen die Wiki lösung?

[eknori]

Wäre das eine zufriedenstellende Lösung?

Ja, das hört sich gut an. Danke auch für das Hosting-Angebot

Mediawiki ist soweit OK ( auch wenn es nicht notes-basierend ist :-) ), kann dann auch mal woanders laufen, wo es PHP und MySQL gibt.

[MartinG]

DAs hört sich doch mal sehr gut an. Bin zeitlich im Moment sehr eng, würde aber auch versuchen ein wenig mitzuschreiben...

[simonschlumpf]

okay, dann nimmt das Ganze langsam Formen an

Ich werde das nicht von heut auf morgen machen, aber ich denke in 1-2 Wochen steht mindestens mal das Wiki.. Bin halt zeitlich auch etwas eingeschränkt..

Ich melde mich wenns los geht..

[eknori]

wir haben jetzt sogar einen Notes Server für ein Notes basiertes Wiki

[simonschlumpf]

na dann her damit   soll ich es auf dem machen?

[eknori]

Am Besten sollten wir uns mal mit Tim und Thomas im Sametime zu einem kurzen Chat treffen, um mal grundsätzlich die Vorgehensweise zu besprechen.
Evtl. am Wochenende?

[Thomas Schulte]

Ich bin am Samstag morgens dann online.