otars,

Заголовочные файлы в C# не нужны, так как скомпилированные сборки содержат всю информацию о типах внутри.

Заголовочные файлы в C++ нужны не для того, чтобы создавать читабельность и структуированность. Если не смогли освоить С++, то не надо пытаться сравнивать его с другими языками.

Начните с бейсика для начала.

Petro123- я лично убираю параметры что там есть и оставляю только коммент

Огромное упущение.


Petro123- потом при открытии файла Ctrl+M+O

Это прекрасно работает и без комментариев.


Petro123Кто то делает серфинг через дерево классов, но я никак не могу привыкнуть. Только сразу в простыни кода ориентируюсь.

Мы пишем полную документацию к коду, описываем также все параметры и возврат, делаем короткое и полное описание, вставляем примеры в комментарии, также описываем возможные исключения. Потом при сборке генерится документация и выкладываеся в вики автоматом. 100% покрытие кода (публичного) документацией — обязательное железное требование. Ещё ни разу не пожалели об этом. Колоссальный профит при командной разработке. Рекомендую.

Petro123Документация отдельная песня. Её делают при коробочных продуктах. Я писал об обозреваемости простыни кода.

Какая разница какой там продукт, коробочный или нет?

Petro123Вопрос риторический.

Вопрос ни разу не риторический. Чтобы понять, что конкретно твой GetDataSet делает, мне надо подробно изучить код этого метода. Понять, надо ли обрабатывать какие-то исключения, может ли он возвратить мне null, в каких условиях его можно использовать, как и когда его надо вызывать, а когда нельзя.

Ээх..

Алексей КХорошему коду комментарии не нужны.

Подобный инфантильный бред устал уже слышать.
Ну давай посмотрим на твой «хороший код»:




Ты прав, такой комментарий никому не нужен, потому что он не отвечает ни на один из следующих вопросов:

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

И почему-то в качестве «доказательств» утверждений про хороший код, почему-то обычно приводят самый тупой пример, который тоже ничего не доказывает.

Ладно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать

Алексей К,

Ну и поле вместо свойства.. Уже как бы намекает насколько этот код «хорош» ))

Алексей КЭто говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде.

зы: Мне немного жаль "твоих" программистов. :-)

Может пояснишь? Я свою позицию легко могу пояснить: свойства поддерживаются как контракт всеми современными библиотеками, поля нет, не всеми, потому что поля это не контракт. Свойства можно сделать виртуальными, сделать private/internal set, с полями не получится.

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

Алексей КЯ не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм.

Ну и в чём проблема, написать чёртов комментарий, даже если как тебе кажется всё довольно очевидно? Я вот честно тебе говорю, встречал чуваков, которые реально задавались вопросом: что это ещё за «последнее имя» такое? Многие люди уверены, что все остальные должны думать именно так как они.