Re: [dokusite] How-To's und/oder Tutorials

Beda Künzle <[email protected]> Mon, 21 Apr 2003 16:05:29 +0200
Newsgroups gmane.comp.cms.bitflux.general.german
Message-ID <[email protected]>
> > Unterschied ist im Prinzip klar und zwar so wie von Roger zitiert.
> > Wird aber leider nicht immer sauber getrennt.
> >
> > How-To = Unmittelbar nachvollziehbare step-by-step Anweisung
> > Tuts   = Konzeptueller Approach,
> >          oft mit embedded How-To's illustriert
> 
> Ist mir schon auch klar, dass es nicht das gleiche ist, aber wenn ich nach
> infos zu nem programm suche, ist's mir meistens egal, ob's ein tutorial
> oder ein howto ist ;) Hauptsache es hat überhaupt was.
>
> bei nbwz.bitflux.ch muss ich wohl zuerst alle hauptpunkte durchsuchen, um
> zu sehen, was es so alles gibt:


Bei nbwz.bitflux.ch ist ein zusätzliches tutorial aus meiner
humble-sicht vermutlich tatsächlich ein overkill, da der user primär
wohl howto's sucht und weniger einen "cursus"

Ev. umfrage starten (v.a. auch in der engl.-bitflux-Liste) ?
gruss
beda


> Einführungen, HOWTOs, Tutorials, Benutzerdokumentation, Technische
> Dokumentation, FAQ
> 
> Wo genau soll ich da anfangen, wenn ich mit BX CMS in den
> Kontakt komme? Vor allem am anfang, wenn wir eh nicht so wahnsinnig viel
> haben, ist das overkill ;)
> 
> Vielleicht sollte man auch den umgekehrten Weg nehmen und oben die
> Hauptthemen hinschreiben und dann nach den versch. Dokumentationen
> trennen. Also z.B. :
> 
> CMS / Popoon / Editor / allg. zu. XML,XSLT / usw..
> 
> und erst dann unterteilen nach Art der Doku.
> 
> So wie's jetzt ist, braucht's IMHo ne verdammt gute Suchmaschine ;)
> 
> chregu
> 
>  >
> > Gruss zum Osterhazy
> > beda
> >
> > > How-To's and Tutorials Unterschied
> > >
> > > Kürzlich hatten wir eine Diskussion betreffend http://nbwz.bitflux.ch.
> > > Brauchts How-To's und Tutorials. Dazumal dachten wir man könnte eines der
> > > beiden streichen.
> > >
> > > Nun habe ich folgendes gefunden:
> > >
> > > http://xml.apache.org/forrest/community/howto/v10/howto-v10.html#Write+the+Overview
> > >
> > > The goal of a How-To is to help the reader to accomplish a specific task with
> > > clear and consise instructions. While tutorials may contain How-To-like
> > > instructions and content, they also include additional background and
> > > conceptual content to help teach their readers higher order concepts along the
> > > way. How-Tos are concerned about filling an immediate, short-term need.
> > > Tutorials often provide long-term knowledge which can be applied across a range
> > > of needs.
> > >
> > > Nun?
> > > Gruss
> > > Roger