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

On Mon, 21 Apr 2003, Beda Künzle wrote:

> 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:

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
>
>

-- 
nam...christian stocker    adr...pflanzschulstr. 31, ch-8004 zurich
pho...+41 43 317 9984      www...http://blog.bitflux.ch
mob...+41 76 561 8860      [email protected]
wor...+41  1 240 5670      gpg...0x5CE1DECB