Neben einen gut strukturierten TypoScript in einem Template ist es hilfreich mit "vernüftigen" Kommentaren die Lesbarkeit zu erhöhen.

TypoScript bietet die Möglichkeit von ein- und mehrzeiligen Kommentaren.

Einzeiliger Kommentar

Kurze Kommentare können mit den Zeichen # und // eingeleitet werden, ein schließendes Zeichen ist nicht nötig.
Der Kommentar muss immer in einer extra Zeile beginnen.

Richtige Schreibweise

1. // Kommentar beginnt in einer extra Zeile
2.  
3. # Kommentar beginnt in einer Zeile

Falsche Schreibweise

1. // Kommentar geht über
2. zwei Zeilen
3.  
4. # Kommentar geht über
5. zwei Zeilen
6.  
7. TS # Kommentar beginnt nicht in einer extra Zeile
8.  
9. TS // Kommentar beginnt nicht in einer extra Zeile
10.  
11. # Nach dem Kommentar folgt eine TS-Anweisung 10 = COA
12.  
13.  
14. // Nach dem Kommentar folgt eine TS-Anweisung 10 = COA
15.  

Mehrzeiliger Kommentar

Ein mehrzeiliger Kommentar wird mit /* geöffnet und mit */ wieder geschlossen. Es ist unbedingt darauf zu achten, die öffnenden und schließenden Zeichen in einer extra Zeile stehen. Auch darf weder vor dem öffnenden oder nach dem schließenden Zeichen TypoScript stehen.

Richtige Schreibweise

1. /*
2. Schließende Zeichen in einer extra Zeile
3. */
4.  
5. /* Schließende Zeichen in einer extra Zeile
6. */

Falsche Schreibweise

1. /* Schließende Zeichen müssen in einer extra Zeile stehen */
2.  
3. /*
4. Schließende Zeichen müssen in einer extra Zeile stehen */
5.  
6. TS /* Öffnene Zeichen müssen in einer extra Zeile stehen
7. */
8.  
9.