Уже год пилю конфу под меняющиеся прихоти руководства.
Поэтому бывает что периодически редактирую один и тот же модуль.
В результате получается что-то типа


Переменная = Вычислить(выврвы+йцуйцу/куц*йцуцй);

//начало 01.01.2014: добавлено условие
Если ххх Тогда
   ууу
//начало 25.12.2013: добавлена процедура по подсчету дней
Срок = СдвинутьДниНаСрок(Сегодня, Срок);
Если Срок = а тогда
   б = в;
КонецЕсли;
//конец 25.12.2013

Документы.Этот.ПолучитьФорму.открытьМодально();
ЭлементыФормы.Таблица.Обновить();

КонецЕсли;

//конец 01.01.2014

Т.е. с одной стороны получаю загромождение кода своими же комментами, с другой стороны - без комментов поди потом вспомни чего и зачем менял.

Как найти золотую середину?

комментарии для лохов!

Тру старое, что не нужно. Переделываю комментарии.

Хранилище? -нет, не слышал

(0) Самое простое - веди журнал разработки.
Если хочешь посложнее, тогда используй какую-нибудь систему контроля версий (можно встроенную 1Совскую).

(4) Журнал в txt веду. Уже неудобно искать. Про встроенную систему контроля где почитать?

(3) Про хранилище лишь слышал что много версий конфы можно хранить, а вот на счет комментов к ним?

(5) тоже можно, когда в хранилище изменения ложишь, комент к ним пишешь

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

(0) Загромождение? Ты еще загромождений не видел!

(8) как-то так)))

Процедура НаправитьНаДоработкуНажатие(Элемент = неопределено, ВызовПриВизировании)
    
    //начало блока: ххх, 04.12.2013
    Если ВызовПриВизировании = истина
        //добавлено. ххх, 27.06.2014: добавил еще условие
        ИЛИ мТекущийСтатус = _СлужебныеПеременные.ПолучитьЗначениеСлужебнойПеременной(ПланыВидовХарактеристик._СлужебныеПеременные.СтатусЗаявкиНаДоработке) Тогда
                                                  
        Сообщить("Сначала введите комментарий");
        ДобавитьКомментНажатие(,Ложь);
        
        //начало блока: ххх, 20.01.2014: укажем дату в РС
        Запись = РегистрыСведений._СрокНаДоработку.СоздатьМенеджерЗаписи();
        Запись.Объект = этотобъект.ссылка;
        
        //начало блока: ххх, 13.02.2014
        //от ууу 1 день на доработку
        Дней = ?((ПараметрыСеанса.ТекущийПользователь = справочники.Пользователи.НайтиПоКоду("ууу") или
                    ПараметрыСеанса.ТекущийПользователь = справочники.Пользователи.НайтиПоНаименованию("ууу"))
                                                                                                                ,1
                                                                                                                ,3);
        //конец блока: ххх, 13.02.2014
        
        Запись.Дата = Бит_визирование.СдвинутьСрокРабочиеДни(ТекущаяДата(), Дней);
        Запись.Записать();
        //конец блока: ххх, 20.01.2014
        
        //Изменен ххх, 27.06.2014: перенес блок внутрь условия, (001
        //добавил: ххх, 19.11.2013
        документы.бит_ЗаявкаНаРасходованиеСредств.ПолучитьФорму("ФормаВыбораАдресата", ЭтаФорма, ЭтаФорма).ОткрытьМодально();
        
        ЗаблокироватьКнопкиДоработки();
        этаформа.ПерепискаПоСогласованию.Обновить();//добавлено: ххх, 11.11.2013
        //конец блока. ххх, 27.06.2014, 001)
        
    //добавлено. ххх, 27.06.2014:    
    Иначе Предупреждение("Заявка не ""На доработке"". Используйте визу",60);
        
    КонецЕсли;
    //конец блока: ххх, 04.12.2013
    
            
КонецПроцедуры


СППР 8-)

(5) Встроенная система управления версиями - это и есть хранилище.

(9) у меня так же, только + подробное объяснение, что за условие и зачем нужно, 2-3 строчки

поменять руководство