dedlfix: Referenzen:JavaScript/Operatoren

Beitrag lesen

Hi!

Die Frage ist nur: Wie tief soll das Thema eigentlich behandelt werden, d.h. wer ist hauptsächlich die Zielgruppe?

Was soll es am Ende werden? Für Anfänger sind eher Tutorials als Einstiegsliteratur geeignet. Da kann man bei nicht ganz so wichtigen Dingen auch oberflächlich bleiben und auf weiterführende Stellen verweisen. Im Bereich Doku ist alles Wissenswerte in üblicherweise einigermaßen kompakter Form zu finden, und wenn man bestimmte Dinge tiefergreifend erklären möchte, kann man einen Fachartikel schreiben. Drei Bereiche - und wie findet man all diese Stellen? Dafür kann man Kategorien setzen und Verlinkungen einbauen.

Je mehr man sich damit befasst, umso mehr geht's aber ans Eingemachte, und man kann schlecht das Eine erklären ohne auch das Andere zu beleuchten, z.B. wenn man etwas behauptet, von dem man weiß, dass es auch Ausnahmen gibt, was aber wieder zu weit führen würde usw.

Wenn das "Andere" etwas allgemeines ist, kannst du es ja zumindest in einen eigenen Absatz oder auch eine eigene Seite auslagern und von den "Einen" Stellen darauf verweisen.

Immer nur schreiben "meistens" ist es so, "in der Regel" so usw. kann's ja auch nicht sein. Da fühlt sich ein Anfänger eher verschaukelt, der eine genaue Auskunft haben will...

Kurz erwähnen und zu einer erläuternden Stelle verweisen sollte dem Informationsbedürfnis Genüge tun.

Also wie umfangreich darf so ein Artikel werden?

Es gibt ja mindestens zwei Wege: einfach drauflos tippen oder erstmal eine Struktur überlegen. Bei ersterem fließt die Energie sofort in einen sichtbaren Text, aber man kommt mitunter später an einen Punkt, an dem man feststellt, dass man dies oder jenes noch erklären muss und dass das anderswo besser aufgehoben ist, usw. usf. Sich zunächst eine Struktur auszudenken, ist erst einmal schwere theoretische Arbeit ohne viel Sichtbares. Aber bei diesem Brainstorming und Zusammentragen der Punkte, die man besprechen will, möglichst mit einer stichpunktartigen Liste all dessen, was man sagen will und nicht vergessen darf, kann man erst einmal Ordnung in seine Gedanken bringen.

Wieviel Fachwissen, Fachbegriffe, Fremdworte usw. darf man beim Leser voraussetzen? Darf man z.B. einfach vom "booleschen Wert" reden oder von "unären Operatoren" oder muss man alles für Hauptschüler ohne jede Fremdsprachenkenntnis erklären?

Fachbegriffe zu verwenden ist wichtig, denn damit kommt man später immer wieder in Berührung. Wichtig ist aber auch deren Erklärung. Wenn der Begriff zum Thema gehört, sollte man ihn irgendwie mit erklären. Wenn er eher nebensächlich ist, kann man zum Glossar verweisen oder einer anderen Stelle, an der er erläutert wird.

Im bestehenden Artikel sieht es nämlich ein bisschen so aus. Ist das vielleicht gerade das Markenzeichen von SelfHTML?

Getreu dem Motto: Die Energie des Verstehens.

Habe erst zwei Abschnitte etwa fertig. Wer Zeit und Lust hat, kann sie ja mal durchlesen und Kritik anbringen. Ich würde auch gerne wissen, ob ich in dem Stil weitermachen soll/kann, oder ob es zu ausführlich, zu knapp, zu verständlich, zu unverständlich, zu falsch, zu bunt oder sonst was ist...

Mir ist aufgefallen, dass du viele Begriffe verlinkst, die Links aber ins Nichts zeigen und noch dazu ins Nichts des globalen Namensraums. Es ist jedenfalls nicht gewünscht, dort die Artikel dazu anzulegen, da wir kein Lexikon wie die Wikipedia sind, bei der das sinnvoll ist. Ich nehme mal an, dass du damit einfach nur die Stellen kennzeichnest, die später mal verlinkt werden sollen. Bei einigen Begriffen (wie Variable) kannst du ja schon jetzt ins Glossar verweisen. Bei anderen ist sicher die JavaScript-Referenz sinnvoll. Bitte vergiss nicht, vor dem Kopieren/Verschieben an den späteren Platz, diese Verweise anzupassen, sonst hat man als Administrator nur jede Menge Aufräumarbeiten, wenn dann jemand anfängt, die Links mit Leben zu erfüllen.

Zum fachlichen Inhalt kann ich nichts weiter sagen, weil ich grad nicht die Ressourcen habe, mich damit zu beschäftigen. Ich werkle unsichtbar im Hintergrund beziehungsweise mit Testinstallationen an Verbesserungen des Wiki-Unterbaus.

Lo!