|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Интересует вопрос,а что собственно можно использовать в `C#` как альтернативу заголовочным файлам(C++). Ведь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность. А вот как быть с `C#`? Мной лично к сожалению не найдено явных примеров,которые бы указывали что заголовочные файлы и `C#` могут взаимодействовать. Поиск по форуму пока не даёт результатов. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 16:12 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
otarsА вот как быть с `C#`? так же как и в Java - никак ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 16:15 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
otars, делаем так: - 3 раза символ / - автоматом появится комментарий - я лично убираю параметры что там есть и оставляю только коммент - заполняем строку чем хотим. Хоть заголовками)) - потом при открытии файла Ctrl+M+O и видим аналог твоих заголовочных. ЗЫ. Кто то делает серфинг через дерево классов, но я никак не могу привыкнуть. Только сразу в простыни кода ориентируюсь. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 16:20 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
otars, Заголовочные файлы в C# не нужны, так как скомпилированные сборки содержат всю информацию о типах внутри. Заголовочные файлы в C++ нужны не для того, чтобы создавать читабельность и структуированность. Если не смогли освоить С++, то не надо пытаться сравнивать его с другими языками. Начните с бейсика для начала. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 20:03 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123- я лично убираю параметры что там есть и оставляю только коммент Огромное упущение. Petro123- потом при открытии файла Ctrl+M+O Это прекрасно работает и без комментариев. Petro123Кто то делает серфинг через дерево классов, но я никак не могу привыкнуть. Только сразу в простыни кода ориентируюсь. Мы пишем полную документацию к коду, описываем также все параметры и возврат, делаем короткое и полное описание, вставляем примеры в комментарии, также описываем возможные исключения. Потом при сборке генерится документация и выкладываеся в вики автоматом. 100% покрытие кода (публичного) документацией — обязательное железное требование. Ещё ни разу не пожалели об этом. Колоссальный профит при командной разработке. Рекомендую. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 20:07 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttЭто прекрасно работает и без комментариев. Ты же за них ))) hVosttМы пишем полную документацию к коду, Документация отдельная песня. Её делают при коробочных продуктах. Я писал об обозреваемости простыни кода. ----- "Сложнее всего в мире достигнуть простоты. Это крайняя граница опыта, и последнее усилие гения" Г.Санд. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 21:40 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Документация отдельная песня. Её делают при коробочных продуктах. Я писал об обозреваемости простыни кода. Какая разница какой там продукт, коробочный или нет? ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 21:45 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttКакая разница какой там продукт, коробочный или нет? - в коробочном тебе приказано описывать параметры в 30 строк перед каждым методом - в не коробочном это решается в самой фирме корпоративными правилами. Нафига мне описывать параметр в SetParameters(Stream stream) DataSet GetDataSet(...... Вопрос риторический. ... |
|||
:
Нравится:
Не нравится:
|
|||
01.10.2017, 22:44 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Вопрос риторический. Вопрос ни разу не риторический. Чтобы понять, что конкретно твой GetDataSet делает, мне надо подробно изучить код этого метода. Понять, надо ли обрабатывать какие-то исключения, может ли он возвратить мне null, в каких условиях его можно использовать, как и когда его надо вызывать, а когда нельзя. Ээх.. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 02:50 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttКакая разница какой там продукт, коробочный или нет? - в коробочном тебе приказано описывать параметры в 30 строк перед каждым методом - в не коробочном это решается в самой фирме корпоративными правилами. Нафига мне описывать параметр в SetParameters(Stream stream) DataSet GetDataSet(...... Вопрос риторический. И вот открываешь код, написанный в 2010-м году тем, кто уже не работает в компании, и вспоминаешь его добрым словом ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:09 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
otarsВедь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность.И хвала авторам C# за то, что не стали тянуть этот маразм из C++. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:25 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVostt100% покрытие кода (публичного) документацией — обязательное железное требование. Код: c# 1. 2. 3. 4. 5.
Хорошему коду комментарии не нужны. Плохому коду комментарии вряд ли помогут. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:32 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Нафига мне описывать параметр в SetParameters(Stream stream) DataSet GetDataSet(......++ ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:36 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Вы с позиции начальства говорите), а я с позиции программиста). Код в коде должен быть понятен программисту, а не вам)). Есть вилка максималистов. На соседней ветке чел весь код увешал комметами. И есть те, кто вообще не ставит. Я посередине) Разумная достаточность. (С) Про обозреваемость кода: - кто при открытии кода лезет не в файл, а в обозреватель классов? - почему ide не группирует вместе public/private? - почему по умолчанию новый метод она ставит internal? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:39 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КotarsВедь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность.И хвала авторам C# за то, что не стали тянуть этот маразм из C++. Эти файлы вроде есть кстати, только генерируются и не видны. Выскакивают на F12 иногда. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:41 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAкод, написанный в 2010- Чаще достают оттуда короткие переменные, чтобы код понять. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 07:43 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КХорошему коду комментарии не нужны. Подобный инфантильный бред устал уже слышать. Ну давай посмотрим на твой «хороший код»: Код: c# 1. 2. 3. 4. 5.
Ты прав, такой комментарий никому не нужен, потому что он не отвечает ни на один из следующих вопросов: — на каком языке эта фамилия? — на каких языках может быть эта фамилия? — может ли вместо фамилии присутствовать только первая буква, если нет, то где можно определить инициалы? — где участвует это поле? — может ли оно быть пустым? — можно ли менять это поле напрямую где угодно? на что это влияет? И почему-то в качестве «доказательств» утверждений про хороший код, почему-то обычно приводят самый тупой пример, который тоже ничего не доказывает. Ладно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:24 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей К, Ну и поле вместо свойства.. Уже как бы намекает насколько этот код «хорош» )) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:25 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Алексей Кпропущено... И хвала авторам C# за то, что не стали тянуть этот маразм из C++. Эти файлы вроде есть кстати, только генерируются и не видны. Выскакивают на F12 иногда.Генерируются по данным рефлекшена. Тут главное, что вручную их писать не надо. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:39 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttЛадно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:42 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КhVosttЛадно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм. И в чём же маразм, если комментарии действительно полезные? :) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:46 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttНу и поле вместо свойства.. Уже как бы намекает насколько этот код «хорош» ))Это говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде. зы: Мне немного жаль "твоих" программистов. :-) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:47 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей Кпропущено... Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах , это маразм. И в чём же маразм, если комментарии действительно полезные? :)Ну мне добавить нечего. Вроде чётко и ясно обозначил свою позицию. Выделю навсякий. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:49 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КЭто говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде. зы: Мне немного жаль "твоих" программистов. :-) Может пояснишь? Я свою позицию легко могу пояснить: свойства поддерживаются как контракт всеми современными библиотеками, поля нет, не всеми, потому что поля это не контракт. Свойства можно сделать виртуальными, сделать private/internal set, с полями не получится. Использовать поля только приватными членами или только в структурах, это не религия, а обоснованное решение, с которым солидарно абсолютное большинство разработчиков. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:51 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КЯ не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм. Ну и в чём проблема, написать чёртов комментарий, даже если как тебе кажется всё довольно очевидно? Я вот честно тебе говорю, встречал чуваков, которые реально задавались вопросом: что это ещё за «последнее имя» такое? Многие люди уверены, что все остальные должны думать именно так как они. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:53 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:53 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КНу мне добавить нечего. Вроде чётко и ясно обозначил свою позицию. Выделю навсякий. Ты забыл добавить, очевидных для кого ? Для тебя? :) А если весь свой код ты считаешь очевидным и хорошим, то зачем комментарии? Это стандартная и со временем прогрессирующая болезнь программистов-одиночек. Эээх.. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 08:55 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Господа максималисты, начальники. Вы не ответили на вопрос. Вы серфинг по файлу делаете через что? Если через окно в ide обозреватель, тогд понятно. Я смотрю не через него, а сам файл глазками. И комментарии ещё пока не контракты. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:04 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttТы забыл добавить, очевидных для кого ? Для тебя? :) Заставить писать много ума не надо. Найти разумную границу, надо ума поболее. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:09 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Господа максималисты, начальники. Вы не ответили на вопрос. Вы серфинг по файлу делаете через что? Если через окно в ide обозреватель, тогд понятно. Я смотрю не через него, а сам файл глазками. И комментарии ещё пока не контракты. Сёрфинг по файлу? Да по разному: Ctrl + F12 (ReSharper), Ctrl + M + O, в Sublime, в FAR, в Notepad++, в Visual Studio Code... ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:43 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttТы забыл добавить, очевидных для кого ? Для тебя? :) Заставить писать много ума не надо. Найти разумную границу, надо ума поболее. Ну ну, и в итоге комментарии не пишутся совсем :) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:44 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123, Самый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера. Ctrl+M+O, Navigate To, Go To... И так далее. Обозревать контракты лучше в генерируемой вики-документации, где всё красиво, и может показать тебе в чём отличия, например, прошлой версии от текущей, или любой выбранной от любой другой с полнотекстовым поиском. И да, кстати. Даже взять этот упоротый пример от Алексея про «LastName» и как ему почему-то кажется бесполезный комментарий «Фамилия», человек в поиске по "Фамилия" найдёт все классы, где упоминается эта фамилия, а унылый говно «хороший» код Алексея пролетает как фанера над Парижем. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:45 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttТы забыл добавить, очевидных для кого ? Для тебя? :) Заставить писать много ума не надо. Найти разумную границу, надо ума поболее. Какая разумная граница? В чём проблема написать чёртов комментарий, если ты знаешь что пишешь. Если сам не знаешь, то комментарии конечно будут лишь в тягость.. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:47 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttАлексей КЭто говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде. зы: Мне немного жаль "твоих" программистов. :-) Может пояснишь? Я свою позицию легко могу пояснить: свойства поддерживаются как контракт всеми современными библиотеками, поля нет, не всеми, потому что поля это не контракт. Свойства можно сделать виртуальными, сделать private/internal set, с полями не получится.Есть масса случаев, когда поле при необходимости безболезненно преобразуется в свойство. Краткость описания полей привлекает всех нормальных людей. Этот вопрос уже обсуждался, не пойму, к чему ты его поднял. hVosttИспользовать поля только приватными членами или только в структурах, это не религия, а обоснованное решение, с которым солидарно абсолютное большинство разработчиков.Миллионы леммингов не могут ошибаться. С другой стороны, какие к ним могут быть претензии, их так воспитали. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:48 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttНу и в чём проблема, написать чёртов комментарий, даже если как тебе кажется всё довольно очевидно?Ну я же выше писал, что он банально мешает. Не говоря уже о бесполезно потраченном времени на его написание. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:49 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAPetro123пропущено... Заставить писать много ума не надо. Найти разумную границу, надо ума поболее. Ну ну, и в итоге комментарии не пишутся совсем :) )))) не. Я за такое ругаю. Мне бы подошла студия, где они автоматом скрываются и не мешают. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:51 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttсёрфингспс. Попробую ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:52 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КЕсть масса случаев, когда поле при необходимости безболезненно преобразуется в свойство. Краткость описания полей привлекает всех нормальных людей. Этот вопрос уже обсуждался, не пойму, к чему ты его поднял. Алексей КМиллионы леммингов не могут ошибаться. С другой стороны, какие к ним могут быть претензии, их так воспитали. Убойный аргумент: «всех нормальных людей» особенно хорошо контрастирует с «леммингами» ))) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 09:55 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? Вот вот. У меня методы размер с экран и треть отдать под описание что я делал? )) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:00 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
В обшем, пусть будет автоскрытие, формат json, и кнопка Убрать из проекта. ))) Это будет в VS2018 ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:04 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
частенько комментирую чужой код и делаю + теги документации, так как проекты все большие, комментариев 0 и разобраться в этом говнокоде без комментариев нормально невозможно. Тем более, что когда система уже работает нужно четко понимать, что и где меняешь :( а ко многим проектам которые мне достались, даже хоть какой то документации нет :( Первое чему нужно учиться в программировании, писать код лаконично и понятно, код должен быть хорошо прокомментирован, не каждый "шаг", а основная информация максимально коротко. И имена нужно нормальные давать используя чёткую терминологию. Вот чего бы хотелось от того кода, с которым приходится работать, после того, как берешь чужой проект и если не хочешь, чтоб тебя поминали лихим словом ) после увольнения :) заголовочные файлы не нужны, всю информацию, про которую пишет автор, можно получить по F12 (переход на реализацию), включая текст документации и другие метаданные ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:05 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:09 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КskyANAАлексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить. Зачем тебе весь класс? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:14 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей Кпропущено... Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить. Зачем тебе весь класс? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:15 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Алексей КskyANAпропущено... Зачем тебе весь класс? Дай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:18 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAДай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так? Алексей не только писать комменты не любит, но и читать ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:19 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttСамый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера. Ctrl+M+O, Navigate To, Go To... И так далее. Тьфу на тебя, нету у меня решарпера))))) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:23 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей Кпропущено... Дай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так?Ну дай хотя бы публичный контракт класса. Может мне повезёт, и я пойму всё из контракта, не заглядывая вовнутрь. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:23 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttСамый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера. Ctrl+M+O, Navigate To, Go To... И так далее. Тьфу на тебя, нету у меня решарпера)))))Покликай правой кнопкой мыши и посмотри комбинации клавиш. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 10:29 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAPetro123пропущено... Тьфу на тебя, нету у меня решарпера)))))Покликай правой кнопкой мыши и посмотри комбинации клавиш. Алексей К, тебе ответил. Обозреватель структуры WPF появился в 2015upd3. Почти тоже самое но не то есть в WinForms. Даже в ворде Это есть ))))) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 11:02 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123skyANAпропущено... Покликай правой кнопкой мыши и посмотри комбинации клавиш. Алексей К, тебе ответил. Обозреватель структуры WPF появился в 2015upd3. Почти тоже самое но не то есть в WinForms. Даже в ворде Это есть ))))) ? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 11:30 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANA? Word меню, 5 режимов просмотра документа. Аналогия понятна? У нас только один. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 11:47 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAАлексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? Встает вопрос. Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств? А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было )) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 12:02 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Вы с позиции начальства говорите), а я с позиции программиста). Код в коде должен быть понятен программисту, а не вам)). Есть вилка максималистов. На соседней ветке чел весь код увешал комметами. И есть те, кто вообще не ставит. Я посередине) Разумная достаточность. (С) Про обозреваемость кода: - кто при открытии кода лезет не в файл, а в обозреватель классов? - почему ide не группирует вместе public/private? - почему по умолчанию новый метод она ставит internal? группа "Звери" ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 13:10 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttПотом при сборке генерится документация и выкладываеся в вики автоматом Чем генерируете? Я пробовал SandCastle, но его выходной формат мне не понравился. Разбираться с настройкой своего формата не захотелось. Petro123У меня методы размер с экран и треть отдать под описание что я делал? А что, сворачивание не работает? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 13:54 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Arm79, Работает, но хочется большего. Целиком на документ Свернуть грёбаные комменты и показать только при клике мышкой. Я 95 проц.времени код пишу, а не комменты читаю. При свёрт и развёрт они вместе с кодом мешаются. А в своём коде мне 1 строки достаточно. Память не дырявая. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 14:19 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код." (МакКоннелл) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 14:42 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Arm79, Кроме того подпроцедуры только появились? Т.е. она у меня используется только один раз, а выглядит как полноценный коммент). "Скажет перфекционист" ))) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 14:46 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
schi, D) ленивый )) ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 14:47 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123Arm79, Работает, но хочется большего. Целиком на документ Свернуть грёбаные комменты и показать только при клике мышкой. Я 95 проц.времени код пишу, а не комменты читаю. При свёрт и развёрт они вместе с кодом мешаются. А в своём коде мне 1 строки достаточно. Память не дырявая. Я с вами не соглашусь. Подход vHostt правильный. В summary писать необходимое описание, включая описание параметров, примеры вызовов и иные моменты. Да, видимость кода может это и понизит (хотя по мне это незначительный фактор, ведь всегда можно свернуть, и свертывание сохраняется), зато всегда можно снегерировать актуальную документацию. Этот момент разработчики упускают. А поддержка доки в актуальном состоянии в ручном режиме - это очень трудная задача. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 15:17 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Arm79Чем генерируете? Я пробовал SandCastle, но его выходной формат мне не понравился. Разбираться с настройкой своего формата не захотелось. Собственный самописный генератор. Чёт тухловато на просторах на эту тему. SandCastle загнулся, остальное поделки так себе, даже DocFX фигня. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 15:50 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Arm79хотя по мне это незначительный фактор, ведь всегда можно свернуть, и свертывание сохраняется И всё? Это решение вопроса? Попробуйте C+M,P и потом C+M, L. Главное чтобы вам потом документацию и акт подписывать. Не нужно решать проблемы тонера в принтере и документации за счёт программиста. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 15:54 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Arm79, Свертываемость кода должна быть независимой от комментов не только прицелом мышки. Тогда всем будет хорошо. ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 15:57 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
AddxskyANAАлексей К, вот как понятнее, так: Код: c# 1. 2. 3.
или так: Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23.
? Встает вопрос. Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств? А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было )) Могли бы и погуглить AutoIndentWriter . Неужели зайдя на страницу по ссылке у Вас складывается впечатление, что информация избыточна? ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 20:33 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
schi"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код." (МакКоннелл) +1 ... |
|||
:
Нравится:
Не нравится:
|
|||
02.10.2017, 20:34 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAschi"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код." (МакКоннелл) +1 F) сами нихрена не понимают что должен делать их код и как его правильно использовать, поэтому ничего написать внятного не в состоянии а потом смеются над картинками про комментарии типа «это мост», ведь это им так близко ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 13:25 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
skyANAAddxпропущено... Встает вопрос. Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств? А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было )) Могли бы и погуглить AutoIndentWriter . Неужели зайдя на страницу по ссылке у Вас складывается впечатление, что информация избыточна? Нет, конечно. Я бы и от пары анекдотов не отказался) Если серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ... Либо ты будешь заниматься только этим вместо разработки, либо сроки вырастут в несколько раз. Чудес не бывает. Впрочем, есть понятие публичной документации. Но у меня то же MSDN никак не проассоциируется с "комментариями к коду". ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 16:41 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
AddxЕсли серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ... Для каждого публичного метода, представляющего контракт. Также есть <inheritdoc />, который снижает болевой порог у людей, которым лень описывать одно и тоже. ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:41 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
AddxЕсли серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ... А я требовал? Вроде как я задал вопрос: "И в чём же маразм, если комментарии действительно полезные?". И привёл кусок кода для иллюстрации. ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:43 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
AddxЛибо ты будешь заниматься только этим вместо разработки, либо сроки вырастут в несколько раз. Чудес не бывает. Без всякой демагогии скажу, что это абсолютная неправда. Создаешь новый публичный тип, сразу пишешь к нему доку, это помогает не только для сопровождения, но и для разработки, когда формируешь свои мысли текстом, организуешь сам процесс в голове. Можешь отвлечься и вернуться к коду, не копаясь в памяти, или тут же передать реализацию другому человеку, это очень хорошо связано с TDD, который тоже ругают «гении от мысли» :) ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:43 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Addx, Уже второй год покрываем код докой, и никакой просадки по срокам из-за комментариев не замечено. Зато замечено, что количество тупой коммуникации по типу «а для чего вот этот класс?? а для чего этот метод?? а где найти работу вот с этим??» снизилось практически до нуля. Бывает, что достаточно сказать название типа или метода, и этого достаточно, всё остальное там написано в комментах. Также выяснилось, что очень удобно искать код по русским комментариям, так иногда можно забыть название типа, свойства или метода, особенно если не ты его писал. ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:46 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVostt, Еще есть технический писатель и кондишен. Это снижает болевой порог и повышает ПРОИЗВОДИТЕЛЬНОСТЬ труда. Счас актуальна эффективность). ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:48 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку, А также Руководство пользователя, и юнит тесты. ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:51 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVostt, Еще есть технический писатель и кондишен. Это снижает болевой порог и повышает ПРОИЗВОДИТЕЛЬНОСТЬ труда. Счас актуальна эффективность). Ну есть тех. писатель, но у него много другой работы :) ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:57 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку, А также Руководство пользователя, и юнит тесты. Руководство пользователя, это не к разработчикам :) Тем более, мы стараемся писать такие системы, где пользователю будет предложено выполнить его задачи при входе, без талмуда, зайди туда, щёлкни сюда, ещё раз щёлкни, «провались» и т.д. Такого нет :) ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 17:59 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Petro123hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку, А также Руководство пользователя, и юнит тесты. А ещё reliability, UX и немодерируемое тестирование :) ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 18:19 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Отсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно. ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 18:24 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
hVosttпровались )))) LOL ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 18:37 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
LRОтсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно. )) я всегда предуреждаю: "райзе мин нет". ... |
|||
:
Нравится:
Не нравится:
|
|||
03.10.2017, 18:40 |
|
Заголовочные файлы и С#
|
|||
---|---|---|---|
#18+
Вот наткнулся в исходниках System.Random на такой комментарий Код: c# 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13.
Хотя, на самом деле, диапазон заполняемых значений [0..0xff]. А здесь это весьма принципиально. Это к тому, что лучше уж отсутствие комментария, чем присутствие неправильного/вводящего в заблуждение. ... |
|||
:
Нравится:
Не нравится:
|
|||
06.11.2017, 10:40 |
|
|
start [/forum/topic.php?all=1&fid=20&tid=1399635]: |
0ms |
get settings: |
7ms |
get forum list: |
13ms |
check forum access: |
3ms |
check topic access: |
3ms |
track hit: |
37ms |
get topic data: |
10ms |
get forum data: |
3ms |
get page messages: |
90ms |
get tp. blocked users: |
1ms |
others: | 299ms |
total: | 466ms |
0 / 0 |