Hello,

Und dann würde ich eine andere (einheitliche) Kastenfarbe für "Syntax" begrüßen. Beispiel und Syntaxdiagramm/-Beschreibung sind ja zwei verschiedene Dinge.

Definiere "Syntax".

Ok, nicht bis in die Tiefe. Sooo weit wwürde ich in der Regel nicht gehen:

Aber z. B. Funktionsaufrufe und Parameter, Rückgabewerte, soe wie bei PHP oder MySQL in den Manuals andeutungsweise schon durchgesetzt. Die Hervorhebung nur, damit man sieht, dass dieser Teil nicht zum Code gehört, sondern nur die allgemeine Verwendung aufzeigt.

Das könnte auch eine hinterlegte Fläche im Beispiel-Kasten sein. Aber wir sollten es alle möglichst gleich machen. Damit eben die Kritik der "wirren Seiten" gar nicht erst Berechtigung findet.

Liebe Grüße aus dem schönen Oberharz

Tom vom Berg