Hallo alle miteinander,
ich bin gerade dabei, mein erstes Javascript Tutorial zu schreiben. Was haltet Ihr davon? Es wäre schön, jetzt schon ein erstes Feedback von Euch zu bekommen.
Malleus\' Javascript Tutorials: Das Wörterlabyrinth
Danke
Frank
xafford 
malleus „Antwort“
Okay, konkret fangen wir mal beim ersten Punkt an, dem Entfernen der Semikolon bei Try-Catch-Blöcken (setzt die überhaupt jemand von sich aus?):
Du hast in den unteren Gegenüberstellungen eine Vorher-Nahher-Situation dargestellt (siehe Verkürzung von Argumenten), bei diesem Beispiel aber zwei Fäle des "Vorher" dargestellt. Dies ist nicht stringent (nicht schlimm, aber eben nicht stringent).
Dann das Beispiel der verkürzten Funktionsargumente (hier sind die Semikolon übrigens da ;o)), die Argumente sind verkürzt, die Funktionsnamen nicht.
Btw gibt es Plugins, die dies automatisch effektiver machen (1st Page 2000, source compressor), aber dies nur am Rande.
Ich muß gestehen, daß ich nicht weiter die Beispiele analysiert habe, aber das mit dem "nicht nachvollziehbar" bezog sich nicht auf den Inhalt, sondern den Aufbau, wie gesagt, einmal Vorher-Nachher Gegenüberstellung, einmal Fallbeispiele.
Was Dokumentation-Tutorial angeht, so bin ich anderer Meinung als Du. Ein Tutorial soll normalerweise allgemeine Grundlagen einer Sprache erklären, die Beispiele sollen recht allgemeine Anwendungen darstellen und es soll übertragbar sein. Auf Grundlagen gehst Du jedoch nur am Rande ein, Du verwendest z.B. teilweise OOP (so weit man bei JS daon reden kann) gehst aber (zumindest so weit ich gesehen habe) nicht explizit darauf ein. Insofern ist es als Ttorial nur von Nutzen, wenn jemand eine sehr ähnliche Anwendung programmieren wollte. Das soll keine Kritik in der Form sein, daß dein "Tutorial" schlecht oder unnütz sei, nur ist es eben an sich kein Tutorial im Wortsinne.
Ansonsten aber gute Arbeit.
Btw.: Was in meinen Augen noch fehlt ist ein Überblick über den Gesamtcode, oder habe ich den Lin dazu übersehen?
