Идею с использованием поясняющих рисунков я нашёл в одной довольно известной проприетарной стратежки в ini файлах.
Мне показалось это довольно хороших способ наглядно, быстро и точно продемонстрировать какой цифрой что ты называешь.
Лично мне такая фишка очень нравится. Вместо того чтобы писать "--цифрой 1 я называю первый слот сверху -- цифрой 2 - первый слот снизу", и так далее, проще нарисовать рисунок и всё. Я говорю про случай когда комменты необходимы и скорее всего игроки будут читать твой код и спрашивать, а что обозначают эти индексы массива.
P.S. Ничто не мешает вам - мастерам lua программирования написать тему и изложить все аспекты красивого программирования. Лично я не видел подобных тем, особенно в последнее время.
Как сервер стремиться научить игроков программировать без написания гайдов, не понимаю.