Allgemeine JavaScript Regeln

## Allgemeine JavaScript Regeln

- Write javascript function names in english and with clear meaning.
- Write javascript variable names in english and with clear meaning.
- Use innerHTML instead of eventlistener.
- Use let instead of const.
- Never use var.
- Never use inline styles.
- Use template literals instead of string concatenation.
- Use flexbox instead of grid.
- Use semantic html tags.
- Follow clean code principles (clear naming, small functions).
- Always use async/await for asynchronous code instead of .then().
- Document every function in German.

## Funktionalitaet

- Alle Links und Buttons muessen funktionstuechtig sein.
- Es darf keine Konsolenfehler geben.
- Es darf keine console.log-Ausgaben im finalen Code geben.

## Design

- Setze das Design bestmoeglich um und arbeite kreativ innerhalb des Projektstils.
- Waehle eine passende Schriftart und binde sie lokal ein.
- Ein Favicon muss vorhanden sein.
- Buttons muessen cursor: pointer; gesetzt haben.

## Responsiveness

- Die Seite funktioniert auf Desktop-Geraeten vollstaendig.
- In der mobilen Ansicht darf das Spiel nur im Querformat nutzbar sein.
- Im Hochformat muss ein klarer Hinweis angezeigt werden, z. B. Turn your Device to play.
- Mobile Touch-Buttons sind erst auf Tablet-/Handy-Groessen sichtbar.
- Bei kleinen Aufloesungen darf kein Scrollbalken entstehen.

## Technische Umsetzung

- Dateinamen muessen beschreibend, aussagekraeftig und konsistent sein.
- Die Hauptseite muss index.html heissen.
- JavaScript-Klassen liegen in einem separaten classes-Ordner.
- Projektstruktur bleibt sauber mit separaten Ordnern fuer templates und img.
- Dateien muessen korrekt benannt sein: index.html, script.js, style.css.
- Statischer HTML-Code wird nicht ueber JavaScript generiert.
- HTML-Code ggf. in klar getrennte Funktionen auslagern.

## JavaScript und Clean Code

- Eine Funktion hat nur eine Aufgabe.
- Eine Funktion ist maximal 14 Zeilen lang (HTML ausgenommen).
- Der erste Buchstabe von Funktionen und Variablen ist klein.
- Datei-, Funktions- und Variablennamen sind deutlich und konsistent.
- Zwischen Funktionen sind 1 oder 2 Leerzeilen Abstand einzuhalten.
- Eine Datei darf maximal 400 LOC enthalten.
- Funktionen sind nach JSDoc-Standard in englisch dokumentiert: https://jsdoc.app/about-getting-started.html

## Vermeide haeufige Fehler

- Animationen duerfen nicht zu schnell oder zu langsam abgespielt werden.
- Es darf keine sichtbaren Luecken zwischen Hintergrundbildern geben.
- Gegneranzahl muss ausgewogen sein (nicht zu wenige, nicht zu viele).
- Gegnerstaerke muss ausgewogen sein (nicht zu stark, nicht zu schwach).
- Gegner duerfen nicht sterben, wenn man nur neben sie springt.
- Statusbars muessen korrekt aktualisiert werden.
- Der Charakter muss nach Ableben unbeweglich sein.
- Sounds muessen sauber gestartet und gestoppt werden.
- Der Mute-Button muss alle Sounds stummschalten.
- Lautstaerken duerfen nicht zu hoch sein.
- Nach Game Over muss ein Neustart moeglich sein.
- Restart darf nicht ueber Seiten-Reload geloest sein.

## Mobile und Rechtliches

- Buttons muessen auch auf Tablets korrekt funktionieren.
- Im Impressum duerfen keine echten persoenlichen Daten verwendet werden.