Добро пожаловать в форум, Guest  >>   Войти | Регистрация | Поиск | Правила | В избранное | Подписаться
Все форумы / WinForms, .Net Framework Новый топик    Ответить
Топик располагается на нескольких страницах: Ctrl  назад   1 2 3 [4]      все
 Re: Заголовочные файлы и С#  [new]
skyANA
Member

Откуда: Зеленоград
Сообщений: 22878
Petro123
hVostt
Создаешь новый публичный тип, сразу пишешь к нему доку,

А также Руководство пользователя, и юнит тесты.

А ещё reliability, UX и немодерируемое тестирование :)
3 окт 17, 18:19    [20839978]     Ответить | Цитировать Сообщить модератору
 Re: Заголовочные файлы и С#  [new]
LR
Member

Откуда: 8P8C
Сообщений: 2193
Отсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.
3 окт 17, 18:24    [20839992]     Ответить | Цитировать Сообщить модератору
 Re: Заголовочные файлы и С#  [new]
Petro123
Member

Откуда: Загрузочный сектор Москвы (AutoPOI.ru)
Сообщений: 30414
hVostt
провались

)))) LOL
3 окт 17, 18:37    [20840017]     Ответить | Цитировать Сообщить модератору
 Re: Заголовочные файлы и С#  [new]
Petro123
Member

Откуда: Загрузочный сектор Москвы (AutoPOI.ru)
Сообщений: 30414
LR
Отсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.

)) я всегда предуреждаю: "райзе мин нет".
3 окт 17, 18:40    [20840024]     Ответить | Цитировать Сообщить модератору
 Re: Заголовочные файлы и С#  [new]
LR
Member

Откуда: 8P8C
Сообщений: 2193
Вот наткнулся в исходниках System.Random на такой комментарий
/*==================================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]. А здесь это весьма принципиально.
Это к тому, что лучше уж отсутствие комментария, чем присутствие неправильного/вводящего в заблуждение.
6 ноя 17, 10:40    [20929589]     Ответить | Цитировать Сообщить модератору
 Re: Заголовочные файлы и С#  [new]
Roman Mejtes
Member

Откуда: г. Пермь
Сообщений: 2421
LR,

Я видел в WPF сборку комментарий на ~50 строк, в нём была какая то диаграмма :) посмеялся знатно
6 ноя 17, 11:27    [20929646]     Ответить | Цитировать Сообщить модератору
Топик располагается на нескольких страницах: Ctrl  назад   1 2 3 [4]      все
Все форумы / WinForms, .Net Framework Ответить