powered by simpleCommunicator - 2.0.51     © 2025 Programmizd 02
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / Заголовочные файлы и С#
6 сообщений из 81, страница 4 из 4
Заголовочные файлы и С#
    #39530443
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку,
А также Руководство пользователя, и юнит тесты.
А ещё reliability, UX и немодерируемое тестирование :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530449
Фотография LR
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Отсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530453
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttпровались
)))) LOL
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530456
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
LRОтсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.
)) я всегда предуреждаю: "райзе мин нет".
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39548276
Фотография LR
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Вот наткнулся в исходниках System.Random на такой комментарий
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
/*==================================NextBytes===================================
      **Action:  Fills the byte array with random bytes [0..0x7f].  The entire array is filled.
      **Returns:Void
      **Arugments:  buffer -- the array to be filled.
      **Exceptions: None
      ==============================================================================*/
      public virtual void NextBytes(byte [] buffer){
        if (buffer==null) throw new ArgumentNullException("buffer");
        Contract.EndContractBlock();
        for (int i=0; i<buffer.Length; i++) {
          buffer[i]=(byte)(InternalSample()%(Byte.MaxValue+1)); 
        }
      }


Хотя, на самом деле, диапазон заполняемых значений [0..0xff]. А здесь это весьма принципиально.
Это к тому, что лучше уж отсутствие комментария, чем присутствие неправильного/вводящего в заблуждение.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39548295
Roman Mejtes
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
LR,

Я видел в WPF сборку комментарий на ~50 строк, в нём была какая то диаграмма :) посмеялся знатно
...
Рейтинг: 0 / 0
6 сообщений из 81, страница 4 из 4
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / Заголовочные файлы и С#
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]