Ce document, qui s'étoffera au fur et à mesure, est là pour vous donner des préceptes qui, nous l'espérons, vous aideront à faire des scripts propres et lisibles.

Que ce soit en TCL ou dans n'importe quel autre langage, vous devez vous créer et respecter des conventions de nommage, que ce soit pour les variables ou les procédures.

• Un bon nom de variable doit permettre d'identifier rapidement son type¹⁾ et son utilité. Le nom doit être explicite tout en restant assez court.
• L'utilisation du CamelCase est aussi une excellente idée, mais prenez bien garde: sur les systèmes *nix, l'interpréteur est sensible à la casse et $sNick ne sera pas équivalent à $snick.
• Autant que faire se peut, utilisez le même nom de variable lorsqu'elle a la même utilité

Exemple de convention

• débuter la variable par un identifiant de type (s pour une chaîne de caractères (string), i pour un entier(integer), a pour un tableau (array), l pour une liste, …)
• décrire ce que contient la variable: nick pour un pseudonyme, channels pour une liste de canaux et channel pour un canal spécifique
• utiliser des variations sur le nom pour une meilleure description: nick sera le pseudonyme de la personne ayant déclenché la procédure, tnick (target nick) sera le pseudonyme de la cible, cnick (current nick) sera le pseudonyme en cours quand on parcourt une liste d'utilisateurs, … Ce qui nous donnera donc: <code tcl>set lfriends # liste des “amis” foreach cchannel [channels] { # canal actuellement vu foreach cnick [chanlist $cchannel] { # pseudo actuellement vu if {$nick eq $cnick || [lsearch lfriends $cnick]>=0 } { continue } append lfriends $cnick } }</code>