Я подумал бы над целевой аудиторией контекста.
Человек, использующий ЕДТ и так все знает, ему кучу подсказок на каждом слове.
Ведущие разрабы будут иногда подсматривать, но они могут и на итс заглянуть сами.
А вот 1С:балбесы - им бы все дать почитать. Но... сами они искать материал не будут, и даже сомнений что они делают неверно у них нет.
Мне видится, что подобные странички нужны чтобы ревьюер кода сунул под нос 1с:балбеса ссылку с примером: плохо - хорошо.
Кобинация красный крестик + зеленая галка - идеальны ))