forum.opennet.ru

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

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

Исходное сообщение

[ Отслеживать ]

Присылайте удачные настройки в раздел примеров файлов конфигурации на WIKI.opennet.ru.

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

Оглавление

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

Полезное начинание, редкость в наше время Но очень любопытно будет посмотреть н, EHLO, 11-Мрт-19, 23:23 (1) //
- Не перевозбуждайтесь мордору проход закрыт To participate in Season of Docs as , myhand, 12-Мрт-19, 10:16 (13) //
  - Тем не менее украинцы могут, думаю, и белорусы тоже Но я не отрицаю что это гадк, Ilya Indigo, 12-Мрт-19, 11:15 (14) //
    - Почему-ж это гадко и подло Сделайте свой Гугл с гуглокодом и антихерассмент-ти, myhand, 12-Мрт-19, 12:03 (17)
      - Потому что он дискредитирует опенсорс ставя граждан одних стран выше других , Ilya Indigo, 12-Мрт-19, 12:38 (19)
        
        Гугл лишь соблюдает закон , myhand, 12-Мрт-19, 12:50 (20)
        
        О Что русскому хорошо, то немцу смерть авторство автора Модератор, прикрой ча, Аноним, 12-Мрт-19, 23:01 (41)
        
        Они тебе до сих пор не запрещают писать документацию И никого по этому принципу, Аноним, 13-Мрт-19, 16:31 (47)
        
        Вы натурально ничего не понимаете Кул-мегахацкиры из России не для того Трампа д, myhand, 13-Мрт-19, 18:34 (53)
  - Не слишком много ль господа исключительные _возможно_ заплатят за полгода суеты , Аноним, 12-Мрт-19, 12:52 (21) //
    - Тем, кого мама с папой не содержат - возможно пригодилась бы подобная денюшка за, myhand, 12-Мрт-19, 13:23 (24)
      - Поработать за _возможно_ заплатят Что-то ты то сам в очередь не рвёшся, а тольк, Аноним, 12-Мрт-19, 14:10 (26)
        
        Как бы нормальные условия в моей стране СпасибоПутинуЗаЭто Только в случае гуг, myhand, 12-Мрт-19, 14:28 (27)
        
        Он уже и до Гугла добрался Кидок там сразу в условиях, в разбросе размера возна, Аноним, 12-Мрт-19, 14:54 (30)
        
        К счастью, нет, за Гугл вы не волновайтесь Что вам мешает уточнить до траты свое, myhand, 12-Мрт-19, 15:05 (32)
        
        Да, тут пора волноваться за кого-то другого То ваш бог виноват, что Гугл _возмо, Аноним, 12-Мрт-19, 16:09 (36)
        
        Натурально, за весьма вероятно половозрелого гражданина, не овладевшего навыка, myhand, 12-Мрт-19, 17:05 (38)
        
        Так укажи, что именно вызывает затруднения при прочтении, попробую перефразирова, Аноним, 13-Мрт-19, 16:36 (48)
        
        Боюсь, научить вас читать по интернету - я таки не смогу , myhand, 13-Мрт-19, 18:38 (54)
        Зато сам научишься , Аноним, 14-Мрт-19, 10:06 (58)
  - Россия не является страной, в отношении которой действует эмбарго США Санкции , bircoph, 13-Мрт-19, 00:23 (43) //
    - Я рад, что вы убедились А теперь ссылку на список стран , чтобы не быть ну т, myhand, 13-Мрт-19, 10:52 (46)
      - Да, давай список стран , Аноним, 13-Мрт-19, 16:40 (49)
      - Вот список стран, участвующих в этом году в Google Summer of Code https develo, bircoph, 13-Мрт-19, 17:38 (51)
        
        Хорошо А теперь, внимание, вопрос где тут про организации Интересно, спасибо , myhand, 13-Мрт-19, 19:07 (55)
        
        Доказывать исходный тезис проход закрыт следует его автору - то есть тебе В, Аноним, 14-Мрт-19, 10:12 (59)
        
        https developers google com season-of-docs terms program-rulesЧитайте п 4 Воо, myhand, 14-Мрт-19, 11:06 (61)
        
        А какая разница Ограничения по странам для студентов и для организаций одинаков, bircoph, 14-Мрт-19, 14:01 (62)
        
        Здравый смысл Не, не слышали Ну элементарно же Эмбарго - оно чтоб террориста, myhand, 14-Мрт-19, 16:29 (63)
Интересно что выйдет Но ещё интересней выяснить почему же у разрабов проектов т, Аноним, 11-Мрт-19, 23:57 (3) //
- Лень и ограниченный словарный запас, Аноним, 12-Мрт-19, 00:40 (5)
- Во-первых, не увсех плохо, а во-вторых, может быть просто некогда Наваял что-то, YetAnotherOnanym, 12-Мрт-19, 01:02 (6)
- Это как раз очевидно 1 код писать интересно, а документацию писать скучно и лен, KonstantinB, 12-Мрт-19, 01:56 (7) //
  - Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная, Аноним, 12-Мрт-19, 07:29 (10) //
    - Ты путаешь тёплое с мягким Doxygen 8212 это техническая документация по API , bircoph, 13-Мрт-19, 00:29 (44)
      - Иначе говоря, в коде GIMP упомянутая операция никак не документирована , Аноним, 13-Мрт-19, 16:42 (50)
        
        Пользователь не разработчик по коду не сможет понять, как эту опцию использов, bircoph, 13-Мрт-19, 17:40 (52)
        
        Так doxygen находит и формирует документацию Другое дело, если комментарии в ко , Аноним, 14-Мрт-19, 10:20 (60)
- почему плохо, не все знают про doxygen , еще_адын_ананим, 12-Мрт-19, 09:20 (12)
- СистемД пример заразителен, не , Аноним, 12-Мрт-19, 23:07 (42)
посмотрел я этот markdown ну ничего сложного, но геморно будет набирать докумен, Анонимчжан, 12-Мрт-19, 00:12 (4) //
- Если ты не знаешь что такое Markdown и не знаешь про редакторы то что ты тут воо, Анонич, 12-Мрт-19, 02:48 (8) //
  - я тут смотрю на тупеющее поколение, которое все больше и больше изобретает велос, аноним3, 12-Мрт-19, 11:20 (15) //
    - Латех, Зануда, 12-Мрт-19, 12:57 (22)
- Ты, наверное, MSDN не видел Вот где плохо-то , Аноним, 12-Мрт-19, 19:38 (39)
М-де , трурль, 12-Мрт-19, 03:36 (9) //
- в зависимости от покупательской способности Гугла и далее по тексту , Аноним, 12-Мрт-19, 07:32 (11)
Я даже сначала Гуголь похвалить хотел за уникальную инициативу, возможно даже по, Ilya Indigo, 12-Мрт-19, 11:23 (16) //
- Гугл так разпереживался, что не может вам здесь ответить Ушол, жрет галстух в , myhand, 12-Мрт-19, 12:07 (18)
- Russia is not a country currently embargoed by the United States , Аноним 80_уровня, 14-Мрт-19, 20:00 (64)
Теперь будет не только индусский код, но и индусская документация , nobody, 12-Мрт-19, 13:15 (23) //
- И всё это будет лежать в индусской системе контроля версий на gitahub com, burjui, 14-Мрт-19, 03:14 (57)
И здесь Гоогле Начинание, может и хорошее - но начинатели уже не вызывают довер, Аноним, 12-Мрт-19, 14:58 (31) //
- это начинание попахивает попыткой создать систему с хорошей документацией благо, анонзыы, 13-Мрт-19, 01:04 (45)

Форумы | Темы | Пред. тема | След. тема

Партнёры:

Хостинг:

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

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