Handbuch für Benutzer

Hab mal ein bisschen geschaut und mir ist aufgefallen, dass es eigentlich keine Handbücher für die Benutzer gibt.
Also die grundliegenden Dinge wie:
Wie pflege ich Content ein?
Wie lade ich was hoch?
Wie macht man Links?
Wie macht man Downloads?
Wie verknüpfe ich andere Seiten?
Wie funktionieren die News, Gästebücher, Foren ect.

Klar gibts im Backend ein ONLINE Handbuch und auch zu den meisten EXTENSIONS vernünftige Erklärungen, aber die meisten richten die sich ja an uns Programmierer :-)

Ich habe da nun schon einiges für Kunden selbst erstellt und frage mich, ob ihr das nicht auch schon so gemacht habt.

Vielleicht könnte man ja mal unter einer eigenen Rubrik sowas zur Verfügung stellen. Vielleicht einzelne Module(Content, News, Bilder, Downloads, ect) als PDF Files oder gar als OpenOffice File, damit man noch seine persönliche Note einbringen kann :-)

Klar, dass T3 so viele Möglichkeiten hat, dass man nicht alles pauschalisieren kann, aber so StandardContent sollte doch zu vereinheitlichen sein.
Zumindest so, dass man nicht bei NULL anfangen muß.

Vielleicht gibts da schon einen Pool (ich hab ihn nicht gefunden #paralyzed# ) und wenn nicht, was haltet ihr davon sowas mal einzurichten?

Also ich wäre auf jeden Fall dafür zu haben. Ich überlege sogar das zu schreiben und eventuell rauszubringen, also als bestellbares Buch.

Hier gibt es einige ganz gute Infos für Redakteure finde ich:
http://www.admin-wissen.de/tutorials/eigene-tutorials/webentwicklung/typo3-workshop/

Grüße

Christian

http://typo3.org/documentation/document-library/tutorials/doc_tut_quickstart_de/current/

aber sicher mal überarbeitenswert. also downloaden, überabreiten, online stellen!

typo3 - inspiring people to share

georg

Jupp, das geht ja schon in die richtige Richtung.
Mein Gedanke war aber sogar noch einen Schritt weiter, nämlich so :-)

Es gibt ein Dokument (z.B. OpenOffice), welches ein austauschbares Logo und Adressfeld enthält, damit eben jeder sein eigenes "Design" bekommt und der Kunde dann auch weiß von wem er das Dokument hat.
Eine Einführung zum Thema CMS und TYPO ganz allgemein gehalten, damit es jeder verwenden kann.
Das wäre die Basis!!!!!!

Danach ein Inhaltsverzeichnis zu den Grundfunktionen von Typo.
Und zwar widerum so geschrieben, dass man es ohne viel Umstand auf seine eigenen Programmierungen anwenden kann.
Dann könnten die verschiedenen Extensions in Zukunft dazu kommen, aber diese Dokumente kann man eben irgendwo downloaden und je nach Bedarf in das Bedienungsanleitungskonzept einfliesen lassen.
Es gilt also erstmal ne Struktur zu finden und dann euch Alle einzeln dazu zu bringen Inhalte beizutragen.
Ich möchte das nicht machen, um meine Seite zu puschen oder Traffic zu erzeugen.
Deshalb ja auch die Frage wohin mit diesen einzelnen Docs?
Vielleicht kann man ja hier innerhalb von typo3.net sowas anlegen.
Das müsste dann ne Unterseite geben, aus der man sich dann das zusammenstellen kann, was für den Kunden nötig ist.
ein kleines Konzept könnte dann so aussehen

BE Dokumentationen
Webmodul Seite
Neue Seite anlegen, löschen, verstecken (eigenes Dok)
Seiteneigenschaften erklärt (eigenes Dok)
Standardcontent einpflegen (eigenes Dok)
Typ nur Text(eigenes Dok)
Typ Text/Bild(eigenes Dok)
Bilder hochladen (eigenes Dok)
Mediaobjekte hochladen (eigenes Dok)
u.s.w. !!!!!!!!!!!

Webmodul Anzeige erklärt (eigenes Dok)
Webmodul Liste erklärt (eigenes Dok)
u.s.w.!!!!!!

Je nach dem, was man dann für seinen Kunden benötigt, kann man sich dann die entsprechenden Einzelteile zusammenstellen und in einem neuen OPENOFFICE Dokument zusammenführen und dann als personalisiertes eigenes Dokument seinen Kunden (als PDF o.ä.) anbieten.
Ich denke, wenn jeder seinen kleinen Teil dazu beiträgt, dann ist da ganz schnell was zusammengetragen, was uns als Dienstleister eine Menge Arbeit ersparen kann.
Wenn das hier auf Zuspruch stösst, dann mache ich gerne ne Vorarbeit und organisiere das ein bisserl :-).
Ich kann auch gerne bei mir auf ner Subseite eine Struktur aufbauen, um die Organisation zu überblicken (wer macht was wann :-), aber die eigentlichen Dokument gehören schon in dieses Forum :-) finde ich.

ja klingt gut!

dann fang einfach mal an!

georg

Schon dabei :-)
Muß das für einen Kunden machen und dachte es wäre ne gute Idee hier mal ein kleines Projekt draus zu machen :-).
Ich layoute gerade die Startseite und die pauschalen Einführungsseiten. Danach mache ich auf jeden Fall noch die Standardfunktionen. Alles weitere ergibt sich hoffentlich dann von allein und ich hoffe auch, dass es ein paar Mitstreitern dann auch was bringt. Ich mache das, weil ich sehr von diesem Forum überzeugt bin und auch sehr davon profitiere.
Ohne dieses Forum wäre Typo3 nicht das was es ist ;-)
(und ich hätte schon keine Haare und keine Fingernägel mehr :p )

Hi, ich bin der Autor von dem Typo3 Tutorial auf www.admin-wissen.de und wollte mich auch mal zu Wort melden. Ich habe z.b. die Dokus zu einzelnen Extensions aus genau dem Grund gemacht, weil man nicht zu allem eine Dokumentation im Zusammenhang findet.

Wenn du willst kannst du meine Doku von admin-wissen.de gerne nutzen, auch an Kunden weitergeben, solange du die Quelle nennst. Meine Idee war auch mal eine Art OpenBook zu machen. Dieses könnte man mit Typo3 selber generieren, ähnlich wie das T3N die Zeitung generiert und über das Typo3 Backend könnten mehrere Autoren Kapitel beisteuern, theoretisch soganr mehrsprachig. Eine Onlineversion könnte es z.b. als Website, PDF etc geben was Typo3 so her gibt und man könnte eine kostengünstige Printausgabe generieren.

Da ich im Moment aber sehr eigespannt bin wegen Diplomarbeit und co. hab ich keine Zeit dafür, es sein denn eine Firma im Rhein Main Gebiet schreibt sowas als Diplomarbeit aus *wink mit dem zaunpfahl*

grüsse

Timo

Hallo Timo,
schön das du das auch liest :-)
Ich hab mir deine Seite angeschaut und finde, dass es dort alles sehr gut zusammengeschrieben ist. Auch deine gesamte Seite ist bestimmt eine Bereicherung für viele hier im Forum.

Ich wollte aber hier erreichen, dass es eben etwas für jeden hier gibt, was komplett ohne Verweise und Copyrights ect. auskommen kann.

Leider ist das in der Regel so, dass der Kunde ein Handbuch erwartet. Das Handbuch sollte aber immer personalisiert sein, weil eben jeder Kunde eine etwas andere Programmierung im BE hat. Meistens sind es gerade die EXTENSIONS oder auch die Struktur (Newscontainer, TEMPLATES, BAUMSTRUKTUR, ect). Wenn man nun das Ganze pauschalisiert, dann hat der Kunde das Gefühl nicht persönlich betreut zu werden, sondern ein 0815 Handbuch zu bekommen. Deswegen denke ich, dass man dort ansetzen muß. Das im Moment geplante HANDBUCH sollte (egal ob Rechte, Verweise, Urheberschutz) einfach nur als BASIS dienen, um daraus ein personalisiertes Handbuch zu machen. Da soll dann nicht stehen, wer das Buch oder die Teile davon erstellt hat, weil eben ein Kunde von Firma xy nicht lesen soll, dass es noch ne Firma yz gibt!
Wir alle hier arbeiten zusammen und entwickeln Lösungen, machen Pläne, forschen, rackern uns ab :-) aber letztlich stehen wir mit unserem Projekt alleine vorm Kunden. Kein Kunde von niemandem hier im Forum, bekommt den Hinweis:
Das Menu hab ich aber COPY/PASTE aus dem Forum gemacht, weil ich allein nicht hinbekommen hätte :-)
Nein, wir stehen da und sagen, "Na, alles Klar?? Schöne SEITE was? WAR MEINE ARBEIT!!!! .... und kein Wort über die Nöte und zahllosen Nächte in denen man hier im Forum evt. Hilfe bekommen hat.
Aber so ist das halt!!!! Dadurch wird TYPO3 immer mehr verbreitet und der Zuspruch wird immer größer :-)
Ein Handbuch (um wieder zum Thema zu kommen) sollte aber nicht Hinweise auf andere Firmen oder WEBSEITEN enthalten, weil ja dadurch eben dieses unpersönliche entsteht: Der Kunde denkt sich dann. "...der hat da was zusammenkopiert :-)"
Bei EXTENSIONS ists was anderes: da gehe ich auch hin und sage meinem Kunden, dass es da was gibt und ichs gerne einsetze......(inkl. aller Hinweise auf den Entwickler), aber ein Handbuch sollte absolut neutral sein und dazu noch auf den Kunden zugeschnitten.
Was ich hoffe und noch weiter betreiben möchte ist, wer schonmal ein Handbuch geschrieben hat und nicht auf seine Urheberrechte pocht, der kann es gerne zum Downloaden hier anbieten. Ich werde mir die Arbeit machen und ein Dokumentenpool ausarbeiten, welcher dann von jedem hier genutzt werden kann ohne das der Kunde da was von anderen Firmen oder Links zu.... , oder sonstwas lesen muß.

Einfach nur ein absolut neutrales offenes Doc:
zum Einfügen eigener Logos
zum Einfügen eigener Screenshots
zum Ändern der Texte (wo es nötig ist)
uns so weiter......

lediglich um das Schreiben und Überlegen was da rein muß, das Layout, die Struktur ect. muß man sich dann keine Sorgen mehr machen, weil das schon im DOK drin ist.

So denke ichs mir zumindest :-)

PS: Ist eigentlich wie das TYPO3 selbst ;-)
Auf der BASIS von TYPO3

....sieht jede Website anders aus!!! (Zitat "MEINE NICHT")

*Zitat (Leben des Brian, copyright by ........ :-) )

OK du hast recht. Das bei einem Kunden das nicht stehen soll sehe ich ein. Ich hätte auch keinerlei Problem damit.

Von daher könnte man den Text auch unter eine offene Lizenz stellen. Wenn sich mehrere Leute daran beteiligen kann auch etwas echt gescheites dabei rum kommen. Das währe für mich auch eine Möglichkeit einen Beitrag für die Community zu leisten.

Ich fände es nur blöd etwas freizugeben und zu sehen das es jeder nutzt aber andere nichts beitragen. Es währe also schön wenn sich andere finden die auch etwas Beitragen. Was ich z.b. noch schreiben wollte ist, wie man eine Community zusammen mit Login, CHC Forum etc. anlegt hab ich dann aber zeitlich nie geschaft.

Aber mal eine andere Frage, was haltet ihr davon sowas in Typo3 selber zu verwalten? So könnten mehrere Autoren dazu beitragen und es währe eine Extension denkbar mit der man sich ein Handbuch mit den eigenen Kapiteln, nach eigenem Geschmack generiert.

mrmiagi1984 schrieb

Ich fände es nur blöd etwas freizugeben und zu sehen das es jeder nutzt aber andere nichts beitragen. Es währe also schön wenn sich andere finden die auch etwas Beitragen.

natürlich ist das schön, aber trenn dich leider von der Vorstellung! Tu es aus eigener Überzeugung aber warte nicht auf die anderen!

mrmiagi1984 schrieb

Aber mal eine andere Frage, was haltet ihr davon sowas in Typo3 selber zu verwalten? So könnten mehrere Autoren dazu beitragen und es währe eine Extension denkbar mit der man sich ein Handbuch mit den eigenen Kapiteln, nach eigenem Geschmack generiert.

da halte ich openoffice für besser... einfach weils schneller geht, feiner ist und man nicht für alles typo3 nehmen *muss* 😉

georg

Von mir aus kann mein Workshop dazu genutzt werden. Das ganze habe ich halt nur in Typo3 selber geschrieben.

Wenn sich jemand die Arbeit macht es zu konvertieren. Ich habe das ganze auch noch in einer ähnlichen Form zur Version 3.7 von Typo3 im OpenOffice Format. Gibts auf Wunsch per EMail. Ich hätte dann gerne auch eine Kopie des Dokuments um es selber auch zum Download anzubieten.

Ich kann nur selber zur Zeit nicht viel Zeit investieren weil ich sie einfach nicht habe.

Jetzt noch was nebenbei was euch nicht betrifft was mich aber störrt ist dieser Mitnehmer Mentatität. Ich habe vor ca. 2 Wochen hier im Forum nach einem Nebenjob gefragt, weil ich zur Zeit ein Praktikum mache(Vollzeit selbstverständlich), bei dem ich fast nicht bezahlt werde. Dann bekommt man Angebot für 6,8€ oder so pro Stunde irgendwelchen Behörden irgendwelche Websites zu erstellen, sowas empfinde ich einfach als Frechheit.

Hab mal unter http://www.treyez.de/typo3-dokumente.zip ein ZIP File hochgeladen mit der alten Version der Doku und dem ersten Teil des Workshops, sowie einer Präsentation die ich mal gehalten habe. Also bedient euch. Wenn noch jemand den Rest des Workshops übernimmt (Der 2. Fortgeschrittene Teil) ist es schon recht umfangreich.

Wer etwas daran macht, möge mir eine Kopie zukommen lassen (timo-schmidt@gmx.net), bin mal gespannt...

Hallo Leute,

ich bin heute mal dazu gekommen erstmal alle in ein OO Dokument zu packe. Da sind noch fehler drinne und es ist auch noch nicht gut strukturiert. Aber es währe schonmal schön ein konstruktives Feedback zu bekommen.

Wer Bock hat kann ein weitere Kapitel schreiben. Was ich ganz schön finden würde währe z.b. die Einrichtung einer Commununity mit Forum oder sowas. Oder eine detallierte Erklärung von OptionSplit oder oder oder.

Was eine Feine Sache währe, wäre wenn jemand ein Macro Skripten kann mit dem man z.b. eine Url eintragen kann für die Kundenwebsite die dann überall im Dokument eingbaut wird.

Die Url http://www.treyez.de/typo3communitybook.odt.

Abhängig vom Feedback werde ich das ganze Erweitern oder eventuell mich an eine Extension setzen die ein solche Dokument aus Typo3 direkt generiert, um die Inhalte online mit mehreren Autoren Koordinieren zu können.

Super 😃
Ich habe eine Umschlagseite und eine personalisierte Version fertig.
Also eine mit der Einführung direkt an den Kunden formulierte Version.
Ich werde Sie auch in den nächsten 2 Tagen (nach Korrektur u.s.w.) zum Download anbieten. Dann dürfte auch schon die Contenterstellung fertig sein.
Dann gibts schon eine Menge für die Community 🙂

Andreas

mrmiagi1984 schrieb

Wer Bock hat kann ein weitere Kapitel schreiben. Was ich ganz schön finden würde währe z.b. die Einrichtung einer Commununity mit Forum oder sowas. Oder eine detallierte Erklärung von OptionSplit oder oder oder.

wäre auch gleich fein, das an den entsprechnden Stellen im offiziellen wiki einzupflegen, zB
http://wiki.typo3.org/index.php/De:TSref/typolink

georg

Hey Andre, wollen wir das ganze dann zusammenführen? Den Teil zu Bildern muss ich nochmal überarbeiten. Und den Rest auchnochmal korrekturlesen.

Ja, gerne!!! Das ist ja meine Intension :-)
Wir müssten uns nur auf eine Basis einigen. Ich werde mal meinen SEITENPFLEGE Teil und die Titelseite fertigmachen und dann können wir uns daraus alles zusammenholen, was benötigt wird.
Dann haben wir schonmal 3 Teile des Puzzels fertig.
TITEL, EINLEITUNG, CONTENT !!!!

Andreas

Alles klaro, freut mich das sich hier was bewegt. Muss jetzt arbeiten und danach noch weg, werde wohl morgen erst dazu kommen weiterzumachen.

Hallo,

also ich bin gerade zufällig über diese Diskussion gestolpert. Meiner Meinung nach macht es mehr Sinn, gerade für Endanwender mehr grafische Anleitungen zu erstellen. Ich schicke meinen Kunden beispielsweise mit WINK erstellte Videos zu, anhand derer sie sehen können, wie man das Bild im Seitenkopf austauscht etc. Zudem schicke ich es als PDF mit, welches sie sich dann entsprechend ausdrucken können.

Des Weiteren hat die Universität für Bodenkultur in Wien ein sehr gutes Handbuch herausgebracht, das ich meinen Kunden auch immer nahe lege zu lesen, sofern sie sich weiter einarbeiten wollen.

Beste,
Tim

Hallo nickno (Tim),
selbstverständlich sind Videos ne feine Sache, aber die Herstellung ist sehr aufwendig und werden (zumindest) von meinen Kunden bestimmt nicht bezahlt :-(.

Eigentlich gings mir nur darum, mal einen POOL zu entwickeln, aus dem sich jeder bedienen kann, um schnell ein Handbuch für seinen Kunden zu erstellen. Alle Dokus zu diesem Thema sind meist nicht direkt an den Benutzer gerichtet, sondern enthalten auch Themen, mit welchen sich ein Kunde nicht beschäftigen soll. Zudem sind meist die Einleitungen und Bilder einem anderen Ersteller zuzuordnen. Ich kann meinem Kunden aber kein Dokument in die Hand drücken, in dem steht, dass es von xyz erstellt wurde und andererseits möchte ich nicht diese Dokus einfach kopieren und als mein Werk ausgeben.
Streng nach dem Motto: Einer für Alle Alle für Einen möchte ich ein Handbuch herausbringen, welches eben als Basis dient und frei verwendbar ist.
Keinerlei Verweise und andere Erkennungsmerkmale von einem Ersteller.
Jeder kann sein eigenes Logo einbringen und muß sich dann nur noch um spezielle Anpassungen kümmern. Aber nicht nochmal alles zusammentippen.
Die Doku dient nicht als fertiges Weitergabeteil, sondern als Basis für eigene Erstellung.
Ich bin übrigens schon fertig, mußte nur erstmal die Version für meinen Kunden fertigmachen. Ich tippe das jetzt noch als Rohversion zusammen und stelle es mal ins Netz. Danach höre ich mir gerne Verbesserungsvorschläge an und schaue zu, dass es ganz fein wird :-)

Aber mal als Anregung, wo finde ich denn dieses Handbuch, dass du erwähntest?