Большой проект, как не запутаться?

[Utkin]

Это разве коменты?

Вот мои коменты:

// Возвращает код оценки параметра метода
// 0 - OK
// 1 - параметр начинается с цифры
// 2 - параметр совпадает с именем служебной переменной
// 3 - содержит недопустимые символы
// 4 - является пустой строкой
function TValentina.CheckParamMet      (Stroka: String): Integer;
begin

    // Инициализация
    result:=0;

    // Совпадает с именем служебной переменной?
    if Stroka=SLVariab then
    begin

        // передаем результат
        result:=2;
        Exit;
    end;

    // Пустая строка?
    if Stroka='' then
    begin

        // передаем результат
        result:=4;
        Exit;
    end;

    // Начинается с цифры?
    if InSet('0 1 2 3 4 5 6 7 8 9', ' ', Stroka[1])='да' then
    begin

        // передаем результат
        result:=1;
        Exit;
    end;

    // Содержит недопустимые символы
    if InSet('( ) - + = / * '' ? > < ; , . : [ ] # !', ' ', Stroka[1])='да' then
    begin

        // передаем результат
        result:=3;
        Exit;
    end;
end;
///////////////////////////////////////////////////////////////////////////////////////////////////////////

[Marsel737]

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

Вот к примеру кусок кода посложнее и коментов побольше:

if Image[Number].Height= 90 then
  begin
    //Берем размеры
    IHeight:= Image[Number].Height;
    IWidth:= Image[Number].Width;
    Ileft:= Image[Number].Left;
    ITop:= Image[Number].Top;
    //Загрузка большой картинки
    frmBook.ImageNumberInitialization;
    if t=0 then Exit;
    //Изменени размеров
    Image[Number].Left:=8;
    Image[Number].Top:=40;
    Image[Number].Height:= 576;
    Image[Number].Width:=665;
    //Скрытие картинок
    for i:=1 to 9 do
    begin
      if i<>Number then Image[i].Visible:=false;
    end;
    //Лэйблы недоступны
    for i:=1 to 21 do
    begin
      LabelCaption[i].Enabled:=false;
    end;
    //Скрытие мемо
    rzmemBook.Visible:=false;
    Exit;
  end;

[GenniY]

Я предпочитаю также использовать простой бумажный блокнот. Вписываю туда то что нужно сделать. А также некие пояснения и расшифровки того что использую в программе (например, по каким критериям вы создаёте запрос к базам и почему именно так). Этот блокнот в конечном итоге потом выступает как лог, видно что делалось и в какой последовательности.

[russian-stalker]

Ну для этого во многих компиляторах есть так называемый To-Do List, такой есть в том числе и в делфи

[GenniY]

To-Do List Конечно неплохо, но не так удобно.
А что делать если у нас в проэкте несколько программ?
Если вы работаете не один, а в команде или в организации, то довольно часто нужно обращаться в другие отделы
(ну хотя бы для установление неких привилегий к базам для себя или для роли другого пользователя). Отводим блок в
блокноте какие таблицы, например, нужно назначить. В процессе разработки блок пополняем, при
этом если нужно, можем РИСОВАТЬ ДИАГРАММЫ, и уже потом обращаемся к другим специалистам.
Основной акцент хочу поставить на том, что в простом блокноте можно:
- быстро и удобно сделать заметку в виде вашей удобной "закарлючки";
- выделить блок, который имеет сравнительно высшую важность;
- рисовать быстро для себя диаграммы, блок-схемы, проводить взаимосвязь между блоками, частями коментов в виде стрелок;
- быстрый доступ к информации без компа;

Да вообще после совещания с командой или с начальником у тебя же в этом блокноте остается
вся инфа о изменения и дополнениях — ты ничего не упустишь. И при ОТЧЁТЕ у тебя всегда под рукой
ДНЕВНИК твоей работы.

[Alex Cones]

Перед началом создания программы запасаюсь листами А4 и черным маркером (мне им почему-то рисовать удобней). И в начале рисую квадратики в которых пишу названия модулей (Ex: UNTCore, UNTLoad, UNTIntr etc.), затем стрелочки кого к кому подключать, после беру папку и запихиваю туда этот лист, беру второй. Вопреки привычке некоторых - блок-схемы не уважаю и пользуюсь ими очень редко (наверно потому, что иногда трудно преобразить блок-схему в код). Беру второй лист и рисую на нем схематично форму, на которой контролы, сразу же определяю координаты для каждого контрола (если необходимо - черной ручкой, мелкими цифрами), затем от каждого контрола стрелка с указание что он должен делать. Пихаю лист в папку и т.д.

[russian-stalker]

У меня алгоритмы появляются в ходе решения.

[dr.Chas]

Как и многие пишу в блокноте то что нада сделать, когда сделал ставлю плюсик напротив (а не удаляю). Ну и некоторые части программы отлаживаю отдельно, а потом только переношу в программу.

[Neeter]

Я начинаю проект сидя перед монитором, с открытой на нем средой. Сижу, обдумываю, что же сделать вначале, как спроектировать главную форму. Когда она более-менее хорошо выглядит, начинаю писать функции, которые мне приходят в голову. Постепенно главная форма обзаводится новыми элементами, проект пополняется другими формами, интерфейс которых, я точно так же продумываю.

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

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

На счет комментариев. В основном я описываю разнообразные переменные и независимые процедуры и функции. И только если знаю, что через неделю забуду для чего они нужны. В сложно-читаемом коде описываю только самые сложные места и больше разделяю пробелами на группы.

Функции, связанные с импортом/экспортом; сохранением в реестр, Ini-файлы, базы данных или другие структурированные файлы; парсингом; графикой я располагаю в других модулях.

Многие уже говорили про отладку каких-либо функций в других проектах, и последующий их перенос в главный проект. У меня точно так же.

Если программа - база данных, то все ф-ии, с ней связанные, я располагаю в DataModule.

Если на определенную тему много функций, то можно создать и DLL.

Ну вот вроде и все, хотя в процессе описания, в голову приходили и другие мысли по этому поводу, но тут же забывались.

[Levsha100]

Я стараюсь перейти на профессиональный уровень- сначала составляю ТЗ, потом объектную модель, потом продумываю взаимодействия объектов/наследования, потом продумываю необходимые типы переменных и начинаю их кодить, потом уже классы... Конечно, комменты пишу(стараюсь ) на каждом шагу.
Вот пример моего кода:

/************************************************************************/
	/*                      Load circuit from file                          */
	/*1)Open file                                                           */
	/*2)Check type                                                          */
	/*3)Check version                                                       */
	/*4)Parse                                                               */
	/*    Read type                                                         */
	/*    Set array length                                                  */
	/*----SetSize                                                           */
	/*----SetPosition                                                       */
	/*----SetBodyColor                                                      */
	/*----SetContourColor                                                   */
	/*----SetIn1                                                            */
	/*----SetIn2                                                            */
	/*----SetOut1                                                           */
	/************************************************************************/
	/************************************************************************/
	/*                       begin logging                                  */
	/************************************************************************/
	logger.Open("Circuitlogger.txt");
	logger.Write("begin load circuit from file");

Стараюсь писать так, что бы можно было легко читать программу как сказку...