tag:forum.selfhtml.org,2005:/self Struktir Javascript-Referenz – Meta-Forum (read only) 2010-03-19T18:55:04Z https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435401#m1435401 Kai345 kai345@knrs.de http://knrs.de 2010-03-18T01:36:08Z 2010-03-18T01:36:08Z Struktir Javascript-Referenz <p>[latex]Mae  govannen![/latex]</p> <p>Momentan beginnt jemand, die Javascript-Objektreferenz mehr oder weniger 1:1 ins Wiki zu übertragen. Da ich gerade diesen Bereich eigentlich immer schon (in mehreren Beziehungen) sehr suboptimal aufgeteilt und beschrieben fand, würde ich es begrüßen, wenn wir uns _vorher_ ein paar Gedanken machen, wie gerade dieser Bereich verbessert werden könnte. Ansonsten würde es bedeuten, daß alle Arbeit, die jetzt gemacht wird, unter Umständen doppelt gemacht oder komplett umgebaut werden muß.</p> <p>Ich sprach es im "ist SelftHTML tot"-Thread bereits einmal an, daß ich es z.B. schön finden würde, wenn einheitlich für jede Methode die Parameterübergabe und Rückgabe und für Eigenschaften der Rückgabe-Typ<br> nach einem Schema ähnlich dem, wie es z.B. auf php.net (<a href="http://www.php.net/manual/de/function.explode.php" rel="nofollow noopener noreferrer">Beispiel</a>) verwendet wird (vielleicht etwas gestraffter, die einzelnen  Parameter nur kurz anreißen um einen schnellen Überblick zu haben und im folgenden text genauer beschreiben), aufgebaut würde.</p> <p>Also:<br> Syntaxübersicht<br> Liste der Parameter mit Beschreibung<br> Beschreibung eventueller Rückgabewerte<br> Hinweise & text & beispiel(e)</p> <p>Ein entsprechendes Template dazu?</p> <p>Was soll mit Methoden/Eigenschaften geschehen, die deprecated sind? Weiterhin unter dem entsprechenden Objekt aufzählen (und z.B. mit entsprechender Hintergrundfarbe hinterlegen oder lieber einen eigenen Bereich "veraltete methoden/Eigenschaften"</p> <p>Weiteres im Laufe des Tages.</p> <p>Ihr könnt ja schon mal losdiskutieren :)</p> <p>Cü,</p> <p>Kai</p> <div class="signature">-- <br> Deutsches Liedgut international:<br> In early rope to mountain we pull<br> <a href="http://selfhtml.knrs.de/#h_stylesheet" rel="nofollow noopener noreferrer">Foren-Stylesheet</a> <a href="http://knrs.de/" rel="nofollow noopener noreferrer">Site</a> <a href="http://selfhtml.knrs.de/" rel="nofollow noopener noreferrer">Selfzeug</a> <a href="http://js.knrs.de/lookup/" rel="nofollow noopener noreferrer">JS-Lookup</a><br> SelfCode: sh:( fo:| ch:? rl:( br:< n4:( ie:{ mo:| va:) js:| de:> zu:) fl:( ss:| ls:? </div> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435408#m1435408 Vinzenz Mai vinzenzmai@web.de 2010-03-18T07:53:38Z 2010-03-18T07:53:38Z Struktir Javascript-Referenz <p>Hallo Kai,</p> <blockquote> <p>Momentan beginnt jemand, die Javascript-Objektreferenz mehr oder weniger 1:1 ins Wiki zu übertragen.</p> </blockquote> <p>vom Grundsatz her ist es erfreulich, dass sich was tut. Das sollte man nicht verhindern und auch nicht ausbremsen.</p> <blockquote> <p>Da ich gerade diesen Bereich eigentlich immer schon (in mehreren Beziehungen) sehr suboptimal aufgeteilt und beschrieben fand,</p> </blockquote> <p>Ich stimme Dir zu.</p> <blockquote> <p>Ansonsten würde es bedeuten, daß alle Arbeit, die jetzt gemacht wird, unter Umständen doppelt gemacht oder komplett umgebaut werden muß.</p> </blockquote> <p>Es gibt Schlimmeres. Ganz bestimmt wird es nicht die einzige derartige Baustelle sein. Hier sehe ich jedoch den Vorteil des Wikis: Es passiert etwas und man kann es sehen. Man kann es verbessern. Schön, dann machen wir's, wenn es nötig ist.</p> <blockquote> <p>wenn einheitlich für jede Methode die Parameterübergabe und Rückgabe und für Eigenschaften der Rückgabe-Typ</p> </blockquote> <p>nach einem Schema ähnlich dem, wie es z.B. auf php.net (<a href="http://www.php.net/manual/de/function.explode.php" rel="nofollow noopener noreferrer">Beispiel</a>) verwendet wird (vielleicht etwas gestraffter, die einzelnen  Parameter nur kurz anreißen um einen schnellen Überblick zu haben und im folgenden text genauer beschreiben), aufgebaut würde.</p> <p>das halte ich für eine gute Idee.</p> <blockquote> <p>Also:<br> Syntaxübersicht<br> Liste der Parameter mit Beschreibung<br> Beschreibung eventueller Rückgabewerte<br> Hinweise & text & beispiel(e)</p> <p>Ein entsprechendes Template dazu?</p> </blockquote> <p>Solange keines da ist, wie wäre es mit der Methode, einfach mit gutem Beispiel und vorhandenen Möglichkeiten vorangehen?</p> <blockquote> <p>Was soll mit Methoden/Eigenschaften geschehen, die deprecated sind? Weiterhin unter dem entsprechenden Objekt aufzählen (und z.B. mit entsprechender Hintergrundfarbe hinterlegen oder lieber einen eigenen Bereich "veraltete methoden/Eigenschaften"</p> </blockquote> <p>was sich bewähren wird. Lassen wir uns überraschen.</p> <p>Freundliche Grüße</p> <p>Vinzenz</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435404#m1435404 LX 2010-03-18T10:14:21Z 2010-03-18T10:14:21Z Struktir Javascript-Referenz <p>Ich würde, um die Übersichtlichkeit der Referenz zu erhöhen, so etwas wie ein <a href="http://tinyjs.sf.net/cheat-sheet.html" rel="nofollow noopener noreferrer">Cheat Sheet</a> verwenden (also eine Auflistung der Objekte, Methoden und Eigenschaften, die einerseits auf Detailbeschreibungen verlinken und andererseits einen nützlichen Tooltip haben).</p> <p>Gruß, LX</p> <div class="signature">-- <br> RFC 1925, Satz 6a: Es ist immer möglich, einen weiteren Umweg einzufügen.<br> RFC 1925, Satz 11a: Siehe Regel 6a<br> </div> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435402#m1435402 Edgar Ehritt 2010-03-19T18:09:30Z 2010-03-19T18:09:30Z Struktur Javascript-Referenz <p>Hallo,</p> <p>die Gelegenheit möchte ich hier nutzen, um ein generelles Anliegen für die Struktur der Javascript-Referenz loszuwerden.</p> <blockquote> <p>Momentan beginnt jemand, die Javascript-Objektreferenz mehr oder weniger 1:1 ins Wiki zu übertragen.</p> </blockquote> <p>Sieht man sich die <a href="https://developer.mozilla.org/en/Core_JavaScript_1.5_Reference" rel="nofollow noopener noreferrer">Javascript-Referenz 1.5</a> an, gliedert diese sich (ohne den mozilla-eigenen Kram) in folgende Punkte:</p> <pre><code class="block language-wiki"> 1. Global Objects 1. Standard global objects (By type) 2. Basic Data types 3. Static 4. Errors 5. Standard global objects (Alphabetical) 2. Global Properties 3. Global Functions 4. Functions and function scope 5. Statements 6. Operators 7. Comments 8. E4X (extension) </code></pre> <p>Meiner Meinung nach macht es Sinn, sich an den Standard mit der Gliederung anzupassen, und nicht in die spärliche Aufteilung SELFHTMLs zurück zu fallen.</p> <p>Gruß aus Berlin!<br> eddi</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435403#m1435403 Vinzenz Mai vinzenzmai@web.de 2010-03-19T18:55:04Z 2010-03-19T18:55:04Z Struktur Javascript-Referenz <p>Hallo Eddie,</p> <blockquote> <p>Meiner Meinung nach macht es Sinn, sich an den Standard mit der Gliederung anzupassen, und nicht in die spärliche Aufteilung SELFHTMLs zurück zu fallen.</p> </blockquote> <p>ich befürworte Deinen Vorschlag.</p> <p>Freundliche Grüße</p> <p>Vinzenz</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435405#m1435405 Vinzenz Mai vinzenzmai@web.de 2010-03-18T10:29:01Z 2010-03-18T10:29:01Z Struktur Javascript-Referenz <p>Hallo LX,</p> <blockquote> <p>Ich würde, um die Übersichtlichkeit der Referenz zu erhöhen, so etwas wie ein <a href="http://tinyjs.sf.net/cheat-sheet.html" rel="nofollow noopener noreferrer">Cheat Sheet</a> verwenden (also eine Auflistung der Objekte, Methoden und Eigenschaften, die einerseits auf Detailbeschreibungen verlinken und andererseits einen nützlichen Tooltip haben).</p> </blockquote> <p>Ich zweifle zwar nicht die Nützlichkeit einer solchen Darstellung an, _auf den ersten Blick_ finde ich jedoch *keine* für *mich* hilfreiche Information. Deswegen halte ich das nicht für eine gute Idee.</p> <p>Ich möchte mehr Fleisch. Von Anfang an. Nicht weiterklicken, nicht erst Tooltip gucken. Kais Vorschlag, sich an der PHP-Doku zu orientieren halte ich für geeigneter und vor allem auch einsteigerfreundlicher.</p> <p>Freundliche Grüße</p> <p>Vinzenz</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435406#m1435406 LX 2010-03-19T10:28:50Z 2010-03-19T10:28:50Z Struktur Javascript-Referenz <p>Hi, Vinzenz!</p> <p>Für Anfänger und Fortgeschrittene ist die PHP-Doku mit Sicherheit ein sehr positives Beispiel, an dem man sich orientieren kann. Ich habe aber festgestellt, dass solche Cheat Sheets bei der täglichen Arbeit die Fortgeschrittenen und Profis durchaus unterstützen kann. Natürlich ist das keine eigenständige Dokumentation, aber in vielen Situationen eine schnellere Möglichkeit der Gedächtnisstütze.</p> <p>Ich werde auf jeden Fall früher oder später so etwas für JavaScript bauen. Ob wir es ins Wiki integrieren oder überhaupt nutzen, ist eine ganz andere Frage.</p> <p>Gruß, LX</p> <div class="signature">-- <br> RFC 1925, Satz 2: Egal, wie fest man schiebt, ganz gleich, wie hoch die Priorität ist, man kann die Lichtgeschwindigkeit nicht erhöhen. </div> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435407#m1435407 Vinzenz Mai vinzenzmai@web.de 2010-03-19T10:51:16Z 2010-03-19T10:51:16Z Struktur Javascript-Referenz <p>Hallo LX,</p> <blockquote> <p>Ich habe aber festgestellt, dass solche Cheat Sheets bei der täglichen Arbeit die Fortgeschrittenen und Profis durchaus unterstützen kann. Natürlich ist das keine eigenständige Dokumentation, aber in vielen Situationen eine schnellere Möglichkeit der Gedächtnisstütze.</p> </blockquote> <p>deswegen schrieb ich ja:</p> <blockquote> <blockquote> <p>"Ich zweifle [...] nicht die Nützlichkeit einer solchen Darstellung an [...]"</p> </blockquote> </blockquote> <blockquote> <p>Ich werde auf jeden Fall früher oder später so etwas für JavaScript bauen. Ob wir es ins Wiki integrieren oder überhaupt nutzen, ist eine ganz andere Frage.</p> </blockquote> <p>ich meine: sicher, gern. Warum nicht einen Abschnitt: "Cheat Sheets"?</p> <p>Freundliche Grüße</p> <p>Vinzenz</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435409#m1435409 Kai345 kai345@knrs.de http://knrs.de 2010-03-18T14:57:58Z 2010-03-18T14:57:58Z Struktir Javascript-Referenz <p>[latex]Mae  govannen![/latex]</p> <blockquote> <blockquote> <p>Ansonsten würde es bedeuten, daß alle Arbeit, die jetzt gemacht wird, unter Umständen doppelt gemacht oder komplett umgebaut werden muß.</p> </blockquote> <p>Es gibt Schlimmeres. Ganz bestimmt wird es nicht die einzige derartige Baustelle sein. Hier sehe ich jedoch den Vorteil des Wikis: Es passiert etwas und man kann es sehen. Man kann es verbessern. Schön, dann machen wir's, wenn es nötig ist.</p> </blockquote> <p>Ich halte - und deshalb eröffnete ich auch diesen Thread - es für wesentlich mehr Arbeit, die bereits ins Wiki übertragene Doku nachträglich wieder (evtl. komplett) umzuwerfen, zumal, wenn es so kommt, die ganze Arbeit der Person, die das jetzt überträgt, merh oder weniger hinfällig werden könnte. Gut, bei einem Wiki muß man damit ohnehin sicher rechnen, aber noch ist relativ wenig übertragen und man kann noch schadenminimierend einwirken.</p> <p>Zum Beispiel wäre abzuklären, ob die Doku wie bisher aufgebaut wird, d.h. eine Seite pro Objekt und auf dieser Seite alle Eigenschaften und Methoden oder ob man es dahingehend abändert, daß jede Eigenschaft/Methode eine eigene Seite bekommt und die Objektseite php.net-mäßig als eine Übersicht mit Kurzbeschreibung ausgelegt wird</p> <p>URL-mäßig würde sich nicht sehr viel ändern:</p> <p>[...]/Objektreferenz/window/location#href</p> <p>vs</p> <p>[...]/Objektreferenz/window/location/href</p> <blockquote> <blockquote> <p>Also:<br> Syntaxübersicht<br> Liste der Parameter mit Beschreibung<br> Beschreibung eventueller Rückgabewerte<br> Hinweise & text & beispiel(e)</p> <p>Ein entsprechendes Template dazu?</p> </blockquote> <p>Solange keines da ist, wie wäre es mit der Methode, einfach mit gutem Beispiel und vorhandenen Möglichkeiten vorangehen?</p> </blockquote> <p>Genau da liegt das Problem. Zum einen liegt der Wiki-Start in einer -für mich- äußerst ungünstigen Zeit, zum Anderen will ich durch diese Diskussion hier vermeiden, daß an [latex]X[/latex] Stellen im Wiki mit [latex]X[/latex] unterschiedlichen Konzepten zu bauen begonnen wird, die man dann nachträglich wieder aneinander angleichen muß.</p> <p>Eine Doku sollte in sich jedenfalls einigermaßen konsistent aufgebaut sein, daher halte ich es für sinnvoll, vorher darüber zu reden. Kostet schließlich nichts ;)</p> <p>Cü,</p> <p>Kai</p> <div class="signature">-- <br> Deutsches Liedgut international:<br> In early rope to mountain we pull<br> <a href="http://selfhtml.knrs.de/#h_stylesheet" rel="nofollow noopener noreferrer">Foren-Stylesheet</a> <a href="http://knrs.de/" rel="nofollow noopener noreferrer">Site</a> <a href="http://selfhtml.knrs.de/" rel="nofollow noopener noreferrer">Selfzeug</a> <a href="http://js.knrs.de/lookup/" rel="nofollow noopener noreferrer">JS-Lookup</a><br> SelfCode: sh:( fo:| ch:? rl:( br:< n4:( ie:{ mo:| va:) js:| de:> zu:) fl:( ss:| ls:? </div> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435410#m1435410 MathiasB 2010-03-18T15:36:43Z 2010-03-18T15:36:43Z Struktir Javascript-Referenz <p>Hallo Kai,</p> <p>vorweg: JavaScript ist (momentan) nicht meine Baustelle; dies sind nur mal meine allgemeinen Gedanken zum Thema.</p> <blockquote> <p>[Ich will] durch diese Diskussion hier vermeiden, daß an [latex]X[/latex] Stellen im Wiki mit [latex]X[/latex] unterschiedlichen Konzepten zu bauen begonnen wird, die man dann nachträglich wieder aneinander angleichen muß.</p> </blockquote> <p>Ich kann das absolut verstehen und finde es auch sehr freundlich, dass du nicht später die Arbeit von anderen Leuten löschen willst.<br> Andererseits: Ich persönlich glaube, man kann sich vorher noch so viele Gedanken über die "beste" Struktur machen, aber welcher Ansatz wirklich der sinnvollste ist, merkt man erst, wenn man's bis zu einem gewissen Grad ausprobiert hat. Egal, wie "offensichtlich" es anfangs auch erscheinen mag, dass der eine Ansatz eher "schlecht" und der andere ganz klar "besser" sei.<br> Ich rechne auch damit, dass vieles, was ich schreibe, später als unbrauchbar erkannt und eingestampft wird.</p> <p>Man muss als Autor damit fertigwerden, dass andere den eigenen Kram löschen, und man muss ebenso den Mut aufbringen, fehlgeschlagene Experimente von anderen Autoren umzuarbeiten oder ganz zu löschen. (Meine Meinung.)</p> <p>Viele Grüße<br> Mathias</p> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435411#m1435411 Kai345 kai345@knrs.de http://knrs.de 2010-03-18T15:53:40Z 2010-03-18T15:53:40Z Struktir Javascript-Referenz <p>[latex]Mae  govannen![/latex]</p> <blockquote> <p>Andererseits: Ich persönlich glaube, man kann sich vorher noch so viele Gedanken über die "beste" Struktur machen, aber welcher Ansatz wirklich der sinnvollste ist, merkt man erst, wenn man's bis zu einem gewissen Grad ausprobiert hat. Egal, wie "offensichtlich" es anfangs auch erscheinen mag, dass der eine Ansatz eher "schlecht" und der andere ganz klar "besser" sei.</p> </blockquote> <p>Das ist richtig. Man kann allerdings eventuell frühzeitig(er) eine Tendenz zu einem oder gegen einen bestimmten Ansatz erkennen bzw. mögliche Probleme oder Argumente die man nicht bedacht hat.</p> <blockquote> <p>Man muss als Autor damit fertigwerden, dass andere den eigenen Kram löschen, und man muss ebenso den Mut aufbringen, fehlgeschlagene Experimente von anderen Autoren umzuarbeiten oder ganz zu löschen. (Meine Meinung.)</p> </blockquote> <p>Mit dem zweitem Punkt hätte _ich_ ehrlich gesagt schon gewisse Probleme. Bin also nicht uneingeschränkt geeignet als Autor. Hm.</p> <p>Cü,</p> <p>Kai</p> <div class="signature">-- <br> Deutsches Liedgut international:<br> In early rope to mountain we pull<br> <a href="http://selfhtml.knrs.de/#h_stylesheet" rel="nofollow noopener noreferrer">Foren-Stylesheet</a> <a href="http://knrs.de/" rel="nofollow noopener noreferrer">Site</a> <a href="http://selfhtml.knrs.de/" rel="nofollow noopener noreferrer">Selfzeug</a> <a href="http://js.knrs.de/lookup/" rel="nofollow noopener noreferrer">JS-Lookup</a><br> SelfCode: sh:( fo:| ch:? rl:( br:< n4:( ie:{ mo:| va:) js:| de:> zu:) fl:( ss:| ls:? </div> https://forum.selfhtml.org/meta/2010/mar/18/struktir-javascript-referenz/1435412#m1435412 MathiasB 2010-03-18T16:05:07Z 2010-03-18T16:05:07Z Struktir Javascript-Referenz <p>Hallo Kai!</p> <blockquote> <p>Mit dem zweitem Punkt hätte _ich_ ehrlich gesagt schon gewisse Probleme. Bin also nicht uneingeschränkt geeignet als Autor. Hm.</p> </blockquote> <p>Autsch! Da hab ich mich ja wieder doof ausgedrückt. Mit "Da muss man als Autor den Mut aufbringen, ...", wollte ich nichts über die Voraussetzungen zur Eignung als Autor aussagen.</p> <p>Also sag ich es mal andersrum: Man *braucht* sich da eigentlich keine Sorgen drum zu machen. Ich sehe kein Problem darin, wenn mehrere Autoren parallel das gleiche Thema beackern und verschiedene Ansätze ausprobieren. (Kann ja auch jeder auf seinen eigenen Benutzerseiten machen.) Ich sehe das auch nicht als Ressourcenverschwendung, sondern als den nötigen Wildwuchs in einer kreativen Phase.</p> <p>Am Schluss vergleicht man dann, was am besten ist, oder lässt im Forum darüber diskutieren, und das Beste nimmt man dann halt. Man muss als Autor ja auch nicht die Drecksarbeit des Löschens persönlich machen; das überlässt man einfach dem Redaktionsteam. ;-)</p> <p>Viele Grüße<br> Mathias</p>