forum.opennet.ru

Форум Разговоры, обсуждение новостей
Вариант для распечатки		Пред. тема \| След. тема
Режим отображения отдельной подветви беседы		[ Отслеживать ]

Оглавление

Google представил инициативу по стимулированию написания док..., opennews (?), 11-Мрт-19, (0) [смотреть все]

Полезное начинание, редкость в наше время Но очень любопытно будет посмотреть н, EHLO (?), 23:23 , 11-Мрт-19, (1) +9 //

Не перевозбуждайтесь мордору проход закрыт To participate in Season of Docs as , myhand (ok), 10:16 , 12-Мрт-19, (13) +1 //

Тем не менее украинцы могут, думаю, и белорусы тоже Но я не отрицаю что это гадк, Ilya Indigo (ok), 11:15 , 12-Мрт-19, (14) +2 //

Почему-ж это гадко и подло Сделайте свой Гугл с гуглокодом и антихерассмент-ти, myhand (ok), 12:03 , 12-Мрт-19, (17) –3

Потому что он дискредитирует опенсорс ставя граждан одних стран выше других , Ilya Indigo (ok), 12:38 , 12-Мрт-19, (19) +4

Гугл лишь соблюдает закон , myhand (ok), 12:50 , 12-Мрт-19, (20) +3

О Что русскому хорошо, то немцу смерть авторство автора Модератор, прикрой ча, Аноним (-), 23:01 , 12-Мрт-19, (41) –2

Они тебе до сих пор не запрещают писать документацию И никого по этому принципу, Аноним (47), 16:31 , 13-Мрт-19, (47)

Вы натурально ничего не понимаете Кул-мегахацкиры из России не для того Трампа д, myhand (ok), 18:34 , 13-Мрт-19, (53)

Не слишком много ль господа исключительные _возможно_ заплатят за полгода суеты , Аноним (21), 12:52 , 12-Мрт-19, (21) +2 //

Тем, кого мама с папой не содержат - возможно пригодилась бы подобная денюшка за, myhand (ok), 13:23 , 12-Мрт-19, (24) –1

Поработать за _возможно_ заплатят Что-то ты то сам в очередь не рвёшся, а тольк, Аноним (21), 14:10 , 12-Мрт-19, (26) +1

Как бы нормальные условия в моей стране СпасибоПутинуЗаЭто Только в случае гуг, myhand (ok), 14:28 , 12-Мрт-19, (27)

Он уже и до Гугла добрался Кидок там сразу в условиях, в разбросе размера возна, Аноним (21), 14:54 , 12-Мрт-19, (30)

К счастью, нет, за Гугл вы не волновайтесь Что вам мешает уточнить до траты свое, myhand (ok), 15:05 , 12-Мрт-19, (32)

Да, тут пора волноваться за кого-то другого То ваш бог виноват, что Гугл _возмо, Аноним (36), 16:09 , 12-Мрт-19, (36)

Натурально, за весьма вероятно половозрелого гражданина, не овладевшего навыка, myhand (ok), 17:05 , 12-Мрт-19, (38)

Так укажи, что именно вызывает затруднения при прочтении, попробую перефразирова, Аноним (48), 16:36 , 13-Мрт-19, (48)

Боюсь, научить вас читать по интернету - я таки не смогу , myhand (ok), 18:38 , 13-Мрт-19, (54)
Зато сам научишься , Аноним (58), 10:06 , 14-Мрт-19, (58)

Россия не является страной, в отношении которой действует эмбарго США Санкции , bircoph (ok), 00:23 , 13-Мрт-19, (43) +4 //

Я рад, что вы убедились А теперь ссылку на список стран , чтобы не быть ну т, myhand (ok), 10:52 , 13-Мрт-19, (46) –2

Да, давай список стран , Аноним (48), 16:40 , 13-Мрт-19, (49)
Вот список стран, участвующих в этом году в Google Summer of Code https develo, bircoph (ok), 17:38 , 13-Мрт-19, (51) +1

Хорошо А теперь, внимание, вопрос где тут про организации Интересно, спасибо , myhand (ok), 19:07 , 13-Мрт-19, (55) –1

Доказывать исходный тезис проход закрыт следует его автору - то есть тебе В, Аноним (58), 10:12 , 14-Мрт-19, (59)

https developers google com season-of-docs terms program-rulesЧитайте п 4 Воо, myhand (ok), 11:06 , 14-Мрт-19, (61) –1

А какая разница Ограничения по странам для студентов и для организаций одинаков, bircoph (ok), 14:01 , 14-Мрт-19, (62)

Здравый смысл Не, не слышали Ну элементарно же Эмбарго - оно чтоб террориста, myhand (ok), 16:29 , 14-Мрт-19, (63)

Интересно что выйдет Но ещё интересней выяснить почему же у разрабов проектов т, Аноним (3), 23:57 , 11-Мрт-19, (3) +1 //

Лень и ограниченный словарный запас, Аноним (5), 00:40 , 12-Мрт-19, (5) –1
Во-первых, не увсех плохо, а во-вторых, может быть просто некогда Наваял что-то, YetAnotherOnanym (ok), 01:02 , 12-Мрт-19, (6) +2
Это как раз очевидно 1 код писать интересно, а документацию писать скучно и лен, KonstantinB (??), 01:56 , 12-Мрт-19, (7) +5 //

Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная, Аноним (10), 07:29 , 12-Мрт-19, (10) //

Ты путаешь тёплое с мягким Doxygen 8212 это техническая документация по API , bircoph (ok), 00:29 , 13-Мрт-19, (44)

Иначе говоря, в коде GIMP упомянутая операция никак не документирована , Аноним (48), 16:42 , 13-Мрт-19, (50)

Пользователь не разработчик по коду не сможет понять, как эту опцию использов, bircoph (ok), 17:40 , 13-Мрт-19, (52)

Так doxygen находит и формирует документацию Другое дело, если комментарии в ко, Аноним (58), 10:20 , 14-Мрт-19, (60)

почему плохо, не все знают про doxygen , еще_адын_ананим (?), 09:20 , 12-Мрт-19, (12)
СистемД пример заразителен, не , Аноним (-), 23:07 , 12-Мрт-19, (42)

посмотрел я этот markdown ну ничего сложного, но геморно будет набирать докумен, Анонимчжан (?), 00:12 , 12-Мрт-19, (4) –6 //

Если ты не знаешь что такое Markdown и не знаешь про редакторы то что ты тут воо, Анонич (?), 02:48 , 12-Мрт-19, (8) +2 //

я тут смотрю на тупеющее поколение, которое все больше и больше изобретает велос, аноним3 (?), 11:20 , 12-Мрт-19, (15) –3 //

Латех, Зануда (?), 12:57 , 12-Мрт-19, (22) +3

Ты, наверное, MSDN не видел Вот где плохо-то , Аноним (39), 19:38 , 12-Мрт-19, (39) +1

М-де , трурль (?), 03:36 , 12-Мрт-19, (9) +2 //

в зависимости от покупательской способности Гугла и далее по тексту , Аноним (10), 07:32 , 12-Мрт-19, (11)

Я даже сначала Гуголь похвалить хотел за уникальную инициативу, возможно даже по, Ilya Indigo (ok), 11:23 , 12-Мрт-19, (16) +2 //

Гугл так разпереживался, что не может вам здесь ответить Ушол, жрет галстух в , myhand (ok), 12:07 , 12-Мрт-19, (18) –4
Russia is not a country currently embargoed by the United States , Аноним 80_уровня (ok), 20:00 , 14-Мрт-19, (64)

Теперь будет не только индусский код, но и индусская документация , nobody (??), 13:15 , 12-Мрт-19, (23) +4 //

И всё это будет лежать в индусской системе контроля версий на gitahub com, burjui (ok), 03:14 , 14-Мрт-19, (57)

И здесь Гоогле Начинание, может и хорошее - но начинатели уже не вызывают довер, Аноним (31), 14:58 , 12-Мрт-19, (31) //

это начинание попахивает попыткой создать систему с хорошей документацией благо, анонзыы (?), 01:04 , 13-Мрт-19, (45)

Сообщения [Сортировка по времени | RSS]

7. "Google представил инициативу по стимулированию написания док..." +5 +/–

Сообщение от KonstantinB (??), 12-Мрт-19, 01:56

Это как раз очевидно:
1) код писать интересно, а документацию писать скучно и лениво - а тем более поддерживать ее в актуальном состоянии;
2) то, что разработчик в своем родном коде считает очевидным, далеко не всегда таковым является, особенно для менее опытных коллег.

Ответить | Правка | К родителю #3 | Наверх | Cообщить модератору

10. "Google представил инициативу по стимулированию написания док..." +/–

Сообщение от Аноним (10), 12-Мрт-19, 07:29

Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная часть кода.

Ответить | Правка | Наверх | Cообщить модератору

44. "Google представил инициативу по стимулированию написания док..." +/–

Сообщение от bircoph (ok), 13-Мрт-19, 00:29

Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API кода. Season of Docs же предназначен для пользовательской документации. Это два существенно различных вида документации. Например, doxygen никак не поможет пользователю GIMP узнать как создать альфа-канал и применить по нему фильтр.

Ответить | Правка | Наверх | Cообщить модератору

50. "Google представил инициативу по стимулированию написания док..." +/–

Сообщение от Аноним (48), 13-Мрт-19, 16:42

> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
> кода. Season of Docs же предназначен для пользовательской документации. Это два
> существенно различных вида документации. Например, doxygen никак не поможет пользователю
> GIMP узнать как создать альфа-канал и применить по нему фильтр.
Иначе говоря, в коде GIMP упомянутая операция никак не документирована.

Ответить | Правка | Наверх | Cообщить модератору

52. "Google представил инициативу по стимулированию написания док..." +/–

Сообщение от bircoph (ok), 13-Мрт-19, 17:40

>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
>> кода. Season of Docs же предназначен для пользовательской документации. Это два
>> существенно различных вида документации. Например, doxygen никак не поможет пользователю
>> GIMP узнать как создать альфа-канал и применить по нему фильтр.
> Иначе говоря, в коде GIMP упомянутая операция никак не документирована.
Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать. Да и вряд ли её вообще там найдёт.

Ответить | Правка | Наверх | Cообщить модератору

60. "Google представил инициативу по стимулированию написания док..." +/–

Сообщение от Аноним (58), 14-Мрт-19, 10:20

>>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
>>> кода. Season of Docs же предназначен для пользовательской документации. Это два
>>> существенно различных вида документации. Например, doxygen никак не поможет пользователю
>>> GIMP узнать как создать альфа-канал и применить по нему фильтр.
>> Иначе говоря, в коде GIMP упомянутая операция никак не документирована.
> Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать.
> Да и вряд ли её вообще там найдёт.
Так doxygen находит и формирует документацию. Другое дело, если комментарии в коде касаются лишь сигнатур функций, расшифровывая сокращённые имена и дублируя код, но не описывают доступным языком что же программа на самом деле делает, то да, в итоге пользователю читать оказывается нечего.

Ответить | Правка | Наверх | Cообщить модератору

Архив | Удалить

Рекомендовать для помещения в FAQ | Индекс форумов | Темы | Пред. тема | След. тема

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру


	7. "Google представил инициативу по стимулированию написания док..."	+5 +/–
	Сообщение от KonstantinB (??), 12-Мрт-19, 01:56
	Это как раз очевидно: 1) код писать интересно, а документацию писать скучно и лениво - а тем более поддерживать ее в актуальном состоянии; 2) то, что разработчик в своем родном коде считает очевидным, далеко не всегда таковым является, особенно для менее опытных коллег.
	Ответить \| Правка \| К родителю #3 \| Наверх \| Cообщить модератору


	10. "Google представил инициативу по стимулированию написания док..."	+/–
	Сообщение от Аноним (10), 12-Мрт-19, 07:29
	Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная часть кода.
	Ответить \| Правка \| Наверх \| Cообщить модератору


	44. "Google представил инициативу по стимулированию написания док..."	+/–
	Сообщение от bircoph (ok), 13-Мрт-19, 00:29
	Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API кода. Season of Docs же предназначен для пользовательской документации. Это два существенно различных вида документации. Например, doxygen никак не поможет пользователю GIMP узнать как создать альфа-канал и применить по нему фильтр.
	Ответить \| Правка \| Наверх \| Cообщить модератору


	50. "Google представил инициативу по стимулированию написания док..."	+/–
	Сообщение от Аноним (48), 13-Мрт-19, 16:42
	> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API > кода. Season of Docs же предназначен для пользовательской документации. Это два > существенно различных вида документации. Например, doxygen никак не поможет пользователю > GIMP узнать как создать альфа-канал и применить по нему фильтр. Иначе говоря, в коде GIMP упомянутая операция никак не документирована.
	Ответить \| Правка \| Наверх \| Cообщить модератору


	52. "Google представил инициативу по стимулированию написания док..."	+/–
	Сообщение от bircoph (ok), 13-Мрт-19, 17:40
	>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API >> кода. Season of Docs же предназначен для пользовательской документации. Это два >> существенно различных вида документации. Например, doxygen никак не поможет пользователю >> GIMP узнать как создать альфа-канал и применить по нему фильтр. > Иначе говоря, в коде GIMP упомянутая операция никак не документирована. Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать. Да и вряд ли её вообще там найдёт.
	Ответить \| Правка \| Наверх \| Cообщить модератору


	60. "Google представил инициативу по стимулированию написания док..."	+/–
	Сообщение от Аноним (58), 14-Мрт-19, 10:20
	>>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API >>> кода. Season of Docs же предназначен для пользовательской документации. Это два >>> существенно различных вида документации. Например, doxygen никак не поможет пользователю >>> GIMP узнать как создать альфа-канал и применить по нему фильтр. >> Иначе говоря, в коде GIMP упомянутая операция никак не документирована. > Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать. > Да и вряд ли её вообще там найдёт. Так doxygen находит и формирует документацию. Другое дело, если комментарии в коде касаются лишь сигнатур функций, расшифровывая сокращённые имена и дублируя код, но не описывают доступным языком что же программа на самом деле делает, то да, в итоге пользователю читать оказывается нечего.
	Ответить \| Правка \| Наверх \| Cообщить модератору