8.х Хороший стиль

Заглянувшим доброго времени суток.

Ребята, воник вопрос: есть ли какой-то свод правил написания "хорошего" 1С кода? И если да, то где бы посмотреть детали?

Ситуация: я тут что-то писал-писал и наконец написал, и потом поехал в командировку. Возвращаюсь (не было где-то неделю), и обнаруживаю, что на определенные места своей же писанины смотрю как баран на новые ворота Утрирую конечно, но все-же..
Причем подозреваю, что если со стороны придет человек поддерживать эту систему после меня, то ему будет совсем туго, ибо объем этой бадяги давно перерос обработки, которые можно склепать за пару вечеров (
Пример:

Код:

 ...
If (strHeader = Header) And (numTailMark <> 0) Then
numEndID	= Find(strTail,Char(10));
strRklID	= Left(strTail,numEndID-1);

If Find(strRkl,strCodeMark) = 0 Then
newRow  = rklVT.Add();
newRow.dbID = strRklID;
newRow.flag = flagNOcode;
Goto ~quit;
EndIf;

numRklTailStart = Find(strRkl,strTailMark);
numRklBodyStart = Find(strRkl,strBodyMark);
strRklBody  = Mid(strRkl,numRklBodyStart,numRklTailStart-numRklBodyStart);

While Find(strRklBody,strCodeMark) > 0 Do
numCode   = Find(strRklBody,strCodeMark)-4;
Code   = Number(Mid(strRklBody,numCode,4));
strPriceRow  = Mid(strRklBody,numCode+37,9);
strRklBody  = Mid(strRklBody,numCode+37);
Summ   = Number(StrReplace(strRklBody,"*",""));

isCodeExist  = rklVT.Find(Code,"Code");
If isCodeExist  = Undefined Then
newRow   = rklVT.Add();
newRow.Code  = Code;
newRow.Summ  = Summ;
Else
index = rklVT.IndexOf(rklVT.Find(Code,"Code"));
rklVT[index].Summ = rklVT[index].Summ+Summ;
EndIf;  
EndDo;
newRow   = rklVT.Add();
...

Итак, как улучшать? Писать комменты - раз! Что еще?
Или, повторюсь, может это подробно разжевано?

Долго вас следующий 1С-ник будет вспоминать "добрым" словом
Оно то конечно есть вариант конструкций языка на английском, но больше принято писать по-русски.

А по существу - на ИТС есть статьи по системе стандартов и методик при разработке конфигураций, в том числе и соглашение при написании кода. Там покопайтесь.

Не знал, что на итсах об этом пишут. Точнее вообще их в руки не брал.
Спасибо, попробую пошурудить наших бухгелтеров. Может оно у нас есть...

+
Кстати заметил интересную деталь.. в начале своей мега-1с, в ковычках, карьеры писал как-то все поросту и было понятно с первого взгляда что, куда и зачем.

С недавнего времени стиль сам собой стал меняться (например стал чаще использовать Если), и сразу возросло время отладки (( Хотя скорость написания существенно выросла, и перестал отладчиком заглядывать после каждой строки. Сразу одну-две требуемых функций не глядя.

1) Если через год глядя в свой код вам хочеться в нем что то исправить - это ХОРОШО. Значит вы УЧИТЕСЬ, значит вы РАСТЕТЕ.
2) Писать в 1С на ангельском - дурной тон. Сильно дурной. Дурной до уровня визы "расстрелять"!
3) Для правильного написания кода вовсе необязательно читать ИТС. Хороший тон написания, он один для большинства языков программирования, был расскрыт в своих книгах еще классиками, и преподавался в соответсвующих курсах при профильном обучении как минимум еще в середине 90ых! (во многих вузах, и еще раньше - в середине-конце 80ых)

Вообще конечно лучше всего писать на русской версии языка (хотя я сам как разработчик на делфи больше привык к английской интерпретации языка),
но все же русский код более читабельный, так же рекомендовал бы Вам давать осмысленные имена переменных (проще воспринимается логика кода когда читаешь

Код:

достать из холодильника сосиску 

чем )

Код:

если а=И тогда
с= ХренЗнаетЧто

И конечно же Оставляйте коментарии к коду..... Вам и самому потом будет проще разобраться со своим кодом, да и вашим последователям тоже=))

Все-таки 1Сники народ странный... это я не о присутствующих, а в целом

Сколько в начале не лазил по инету, все как один твердили, что пофиг на каком языке писать ("пиши на каком удобней"). Я когда-то слегка касался бейсика (в школе конечно), и потому писать стал тоже на английском, рассчитывая, что почти любой ИТшник худо-бедно владеет инглишем.. ан нет. Теперь выясняется что "все не так ребята".

Лишний раз убеждаюсь: когда начинаешь новое дело, надо не лазить по форумам, а найти одного спеца и подолбить его в асю. Форумы уже потом, когда основа ясна. Печалька...

зы
Вань, спасибо, я тут листаю твой документ. Должно помочь.

В общем начал потихоньку менять названия процедур/переменных на русские без сокращений, да пописывать коменты. Ситуация тяжелая, но не безнадежная.

Всем спасибо! Решено!

+
кстати о переменных от себя добавлю. Трудно оценить пока степень полезности, но мне понравилось в начале имени переменной делать пометку о её типе.
Например:
strXXX или sXXX где XXX какое-то название означает что тип этой переменной ХХХ строка. a(arr) массив, n(num) число и тд.

Ребят, еще вопрос насчет дальнейшей перспективы.
На сколько я понимаю начиная с 8ки пошли управляемые приложения, а до нее были обычные. И вроде так пишут, что 1С планирует совершенно все переводить на этот новый стандарт.

Я например до настоящего момента работал только с обычными, но исходя из текущих реалий может имеет смысл начать грести в сторону управляемых? То есть не ждать когда гром грянет, а сейчас садиться и начинать разбираться/переписывать свои плюшки....
"Моя" правильно видит этот мир?

IMHO, правильно.
Соглашусь с 1cUserAndrew.
В ближайшее время обычные формы конечно же остануться. Тут бы с 7.7 все перешли, не говоря уже про управляемое приложение
Но с переходом к УФ я думаю в обозримом будущем столкнуться все. Насколько оно обозримо -1С его знает . Но начинать разбираться/переписывать лучше пораньше.