forum.opennet.ru - "Серьезность проблемы пренебрежения открытыми проектами проце..." (39)

форумы

помощь

поиск

регистрация

майллист

вход/выход

слежка

"Серьезность проблемы пренебрежения открытыми проектами проце..."

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

"Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
Сообщение от opennews (??) on 20-Апр-10, 17:04
Джо Брокмейер (Joe "Zonker" Brockmeier), недавно покинувший пост лидера сообщества разработчиков openSUSE, опубликовал заметку (http://ostatic.com/blog/wheres-the-summer-of-documentation) в которой посетовал, что Google следовало бы провести наряду с "Summer of Code" инициативу "Summer of Documentation", в которой привлечь молодежь к процессу документирования кода, написанию качественных руководств, переводу на другие языки и улучшению дизайна пользовательского интерфейса. По мнению Джо на вопрос, чего не хватает открытому ПО, один из наиболее частых ответов - "документации". URL: http://ostatic.com/blog/wheres-the-summer-of-documentation Новость: http://www.opennet.dev/opennews/art.shtml?num=26303
Высказать мнение \| Ответить \| Правка \| Cообщить модератору

Оглавление

Серьезность проблемы пренебрежения открытыми проектами проце..., Аноним, 17:04 , 20-Апр-10, (1) –2

Серьезность проблемы пренебрежения открытыми проектами проце..., name, 17:22 , 20-Апр-10, (4) +1

Серьезность проблемы пренебрежения открытыми проектами проце..., User294, 21:28 , 20-Апр-10, (16) +1

Серьезность проблемы пренебрежения открытыми проектами проце..., Аноним, 19:52 , 21-Апр-10, (41)

Серьезность проблемы пренебрежения открытыми проектами проце..., anonymous vulgaris, 21:23 , 20-Апр-10, (11) –1

Серьезность проблемы пренебрежения открытыми проектами проце..., Трухин Юрий Владимирович, 21:26 , 20-Апр-10, (13) –3

Серьезность проблемы пренебрежения открытыми проектами проце..., anonymous vulgaris, 21:35 , 20-Апр-10, (18)

Серьезность проблемы пренебрежения открытыми проектами проце..., Трухин Юрий Владимирович, 09:25 , 21-Апр-10, (28)

и семплов ещё, Вова, 09:56 , 21-Апр-10, (30)

Серьезность проблемы пренебрежения открытыми проектами проце..., Ян Злобин, 03:44 , 21-Апр-10, (25)

Серьезность проблемы пренебрежения открытыми проектами проце..., Feadot, 08:57 , 21-Апр-10, (26) –1

Серьезность проблемы пренебрежения открытыми проектами проце..., Ян Злобин, 10:23 , 21-Апр-10, (33)

Серьезность проблемы пренебрежения открытыми проектами проце..., Трухин Юрий Владимирович, 09:26 , 21-Апр-10, (29) –1

Серьезность проблемы пренебрежения открытыми проектами проце..., Ян Злобин, 10:22 , 21-Апр-10, (32) +1

Серьезность проблемы пренебрежения открытыми проектами проце..., vayerx, 17:10 , 21-Апр-10, (39)

Серьезность проблемы пренебрежения открытыми проектами проце..., Веслый мясник, 01:37 , 22-Апр-10, (44) +1
Серьезность проблемы пренебрежения открытыми проектами проце..., неизвестный, 08:29 , 22-Апр-10, (45)

Серьезность проблемы пренебрежения открытыми проектами проце..., А, 17:11 , 20-Апр-10, (2) –2

Серьезность проблемы пренебрежения открытыми проектами проце..., name, 17:25 , 20-Апр-10, (5) +2
Серьезность проблемы пренебрежения открытыми проектами проце..., аноним, 17:58 , 20-Апр-10, (7) +3

Серьезность проблемы пренебрежения открытыми проектами проце..., croster, 17:16 , 20-Апр-10, (3)

Серьезность проблемы пренебрежения открытыми проектами проце..., Твистер, 17:40 , 20-Апр-10, (6)
Серьезность проблемы пренебрежения открытыми проектами проце..., Аноним, 18:57 , 20-Апр-10, (8)

Серьезность проблемы пренебрежения открытых проектов процесс..., Belov Sergey, 21:23 , 20-Апр-10, (12)
Серьезность проблемы пренебрежения открытых проектов процесс..., rm_, 21:52 , 20-Апр-10, (20) +2
Серьезность проблемы пренебрежения открытых проектов процесс..., амонинус, 22:22 , 20-Апр-10, (21)

Серьезность проблемы пренебрежения открытых проектов процесс..., Вова, 10:00 , 21-Апр-10, (31) +1

Серьезность проблемы пренебрежения открытых проектов процесс..., Aleksey, 14:02 , 21-Апр-10, (36) +1

Серьта я согласен, Вова, 14:43 , 21-Апр-10, (37)

Серьезность проблемы пренебрежения открытых проектов процесс..., XoRe, 00:47 , 21-Апр-10, (24)

Серьезность проблемы пренебрежения открытых проектов процесс..., anonymous, 18:08 , 23-Апр-10, (46)

Серьезность проблемы пренебрежения открытых проектов процесс..., XoRe, 22:33 , 23-Апр-10, (47)

Серьезность проблемы пренебрежения открытых проектов процесс..., anonymous, 11:00 , 24-Апр-10, (48)

Серьезность проблемы пренебрежения открытых проектов процесс..., Аноним, 09:17 , 21-Апр-10, (27)
Серьезность проблемы пренебрежения открытых проектов процесс..., Proger, 12:02 , 21-Апр-10, (35) –2

Серьезность проблемы пренебрежения открытых проектов процесс..., Ян Злобин, 16:29 , 21-Апр-10, (38)

Серьезность проблемы пренебрежения открытых проектов процесс..., eugeni, 18:33 , 21-Апр-10, (40) –1
Серьезность проблемы пренебрежения открытых проектов процесс..., Аноним, 00:00 , 22-Апр-10, (42) +1

Серьезность проблемы пренебрежения открытых проектов процесс..., Аноним, 00:05 , 22-Апр-10, (43)

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

1. "Серьезность проблемы пренебрежения открытыми проектами проце..." –2 +/–

Сообщение от Аноним (??) on 20-Апр-10, 17:04

Как будто к проприетарщине больше документации...

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

4. "Серьезность проблемы пренебрежения открытыми проектами проце..." +1 +/–

Сообщение от name (??) on 20-Апр-10, 17:22

ну вот к win32 GDI, к примеру, её _как минимум_ на порядок больше, чем к иксам

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

16. "Серьезность проблемы пренебрежения открытыми проектами проце..." +1 +/–

Сообщение от User294 (ok) on 20-Апр-10, 21:28

Осталось только найти мазохистов которые будут под гольные иксы программить :D

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

41. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Аноним (??) on 21-Апр-10, 19:52

Под иксы документации - пяток толстеньких книжечек от O'Reilly плюс подробные описания ключевых библиотек и протоколов X11 в комплекте дистрибутива (объемистые такие pdf'ки).
Вы мне лучше покажите мазохистов, которые в 2010 году будут программить под Win32 GDI, без MFC и прочих дотнетов.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

11. "Серьезность проблемы пренебрежения открытыми проектами проце..." –1 +/–

Сообщение от anonymous vulgaris on 20-Апр-10, 21:23

>Как будто к проприетарщине больше документации...
хелпы там нормальные

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

13. "Серьезность проблемы пренебрежения открытыми проектами проце..." –3 +/–

Сообщение от Трухин Юрий Владимирович on 20-Апр-10, 21:26

Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

18. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от anonymous vulgaris on 20-Апр-10, 21:35

>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает
>его совсем нет и это очень ужастно
речь в новости абсолютно обо всем включая translators, user interface designers, artists,
а самое слабое место это обычно хелпы, потому что - TONS of documentation that many people simply CAN'T slog through.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

28. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Трухин Юрий Владимирович on 21-Апр-10, 09:25

>а самое слабое место это обычно хелпы, потому что - TONS of
>documentation that many people simply CAN'T slog through.
вы не рвзработчик на сколько я понимаю... иначе вряд ли такое бы написали. Help можно написать, а вот использовать более-менее сложную библиотеку без комментированного кода нереально. Если вы конечно не обладаете даром телепатии.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

30. "и семплов ещё" +/–

Сообщение от Вова on 21-Апр-10, 09:56

>>а самое слабое место это обычно хелпы, потому что - TONS of
>>documentation that many people simply CAN'T slog through.
>
>вы не рвзработчик на сколько я понимаю... иначе вряд ли такое бы
>написали. Help можно написать, а вот использовать более-менее сложную библиотеку без
>комментированного кода нереально. Если вы конечно не обладаете даром телепатии.
всё правильно, + примеры использования, тоже адски важны.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

25. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Ян Злобин (ok) on 21-Апр-10, 03:44

>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно
Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если код писан по стандартам GNU - читать его одно удовольствие.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

26. "Серьезность проблемы пренебрежения открытыми проектами проце..." –1 +/–

Сообщение от Feadot (ok) on 21-Апр-10, 08:57

>Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если код писан по стандартам GNU - читать его одно удовольствие.
Сплю и вижу домохозяйку, которая читает исходники дабы понять как работает программа...
По нажатию F1, не хэлп, а сразу исходник программы открывает!

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

33. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Ян Злобин (ok) on 21-Апр-10, 10:23

>Сплю и вижу домохозяйку, которая читает исходники дабы понять как работает программа...
При чем здесь домохозяйка-то?  Речь зашла об исходниках, а это явно не для домохозяек. :-)

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

29. "Серьезность проблемы пренебрежения открытыми проектами проце..." –1 +/–

Сообщение от Трухин Юрий Владимирович on 21-Апр-10, 09:26

>>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно
>
>Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если
>код писан по стандартам GNU - читать его одно удовольствие.
и много сорцов ты прочитал и понял без телепатии? Неужели в ваших гнутых стандартах нет требования комментировать код... я очень удивлюсь если так

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

32. "Серьезность проблемы пренебрежения открытыми проектами проце..." +1 +/–

Сообщение от Ян Злобин (ok) on 21-Апр-10, 10:22

>и много сорцов ты прочитал и понял без телепатии? Неужели в ваших
>гнутых стандартах нет требования комментировать код... я очень удивлюсь если так
Да немало.  И регулярно читаю.  Где-то есть комментарии, где-то нету.  Когда код хорошо оформлен обычно и без комментариев все понятно.
Например, что делает функция gtk_tree_view_get_selection легко понятно из без телепатии. :-)

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

39. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от vayerx (ok) on 21-Апр-10, 17:10

реализацию математики почитайте

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

44. "Серьезность проблемы пренебрежения открытыми проектами проце..." +1 +/–

Сообщение от Веслый мясник on 22-Апр-10, 01:37

Сплю и вижу человека, который юзает (к примеру) OpenSSL, руководствуясь исходниками. Смешно, ей-богу...

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

45. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от неизвестный on 22-Апр-10, 08:29

полность согласен

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

2. "Серьезность проблемы пренебрежения открытыми проектами проце..." –2 +/–

Сообщение от А (??) on 20-Апр-10, 17:11

Большинство кода дают большие компании и в отсутствии док есть логика. Код открыт и бесплатен, кто ниасилил прочитать код и разобраться как работает платит за поддержку. Пока красноглазые приверженцы меряются крутизной дистров умные дядьки деньги зарабатывают.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

5. "Серьезность проблемы пренебрежения открытыми проектами проце..." +2 +/–

Сообщение от name (??) on 20-Апр-10, 17:25

>кто ниасилил прочитать код и разобраться как работает
функции должны быть документированы, читать все исходники, чтобы понять какая функция нужна для выполнения необходимого действия - чистое красноглазие

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

7. "Серьезность проблемы пренебрежения открытыми проектами проце..." +3 +/–

Сообщение от аноним on 20-Апр-10, 17:58

А автор пробовал разрабатывать что-нибудь сам?

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

3. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от croster (ok) on 20-Апр-10, 17:16

Есть и проекты с хорошей документацией. Пример - PostgreSQL, там документация на 2000 страниц в pdf формате.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

6. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Твистер on 20-Апр-10, 17:40

На sendmail вон более 1200 страниц описания
и что кто-то активно пользует?

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

8. "Серьезность проблемы пренебрежения открытыми проектами проце..." +/–

Сообщение от Аноним (??) on 20-Апр-10, 18:57

согласен, отличная документация у mediawiki а худщая у zend framework

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

12. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от Belov Sergey (ok) on 20-Апр-10, 21:23

У многих проектов с документацией проблемы. Особенно с локализованной. Справка к GIMP переведена лишь частично.
Из-за этого у нас внедрение в учебный процесс тормозится.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

20. "Серьезность проблемы пренебрежения открытых проектов процесс..." +2 +/–

Сообщение от rm_ (ok) on 20-Апр-10, 21:52

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

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

21. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от амонинус on 20-Апр-10, 22:22

Да, к сожалению. Многие лидеры проектов еще не поняли, что даже если код компилируется не на компьютере, а в голове, и не с Си, а с английского, он не менее важен, чем тот, который в компьютере, и должен, блин, быть частью проекта, а не "сопровождением". Особенно когда проект открытый.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

31. "Серьезность проблемы пренебрежения открытых проектов процесс..." +1 +/–

Сообщение от Вова on 21-Апр-10, 10:00

>Да, к сожалению. Многие лидеры проектов еще не поняли, что даже если
>код компилируется не на компьютере, а в голове, и не с
>Си, а с английского, он не менее важен, чем тот, который
>в компьютере, и должен, блин, быть частью проекта, а не "сопровождением".
>Особенно когда проект открытый.
Заурядный программист пишет код, понятный компилятору, хороший - код, понятный другому программисту.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

36. "Серьезность проблемы пренебрежения открытых проектов процесс..." +1 +/–

Сообщение от Aleksey (??) on 21-Апр-10, 14:02

А очень хороший еще и документацию к коду.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

37. "Серьта я согласен" +/–

Сообщение от Вова on 21-Апр-10, 14:43

всё так, локальные викисы и сам пишу, и в других приветствую.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

24. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от XoRe (ok) on 21-Апр-10, 00:47

Я так понимаю, открытые исходники недостаточно документированы по сравнению с закрытыми?
Ну, давайте посмотрим на закрытые исходники, поучимся у них документированию)
А где закрытые исходники?
Нету.
Т.е. Брокмейер сетует только по поводу того, на что можно посмотреть.
Посмотрел бы он на документированность закрытого кода...)
А документация к программе...
Мистеру Брокмейеру стоит указать на команду man, которая дает возможность почитать не только документацию к программам, но даже к функциям языков (man malloc).
В остальном я бы сказал, что на документацию всегда можно найти время.
Если один человек будет заниматься только документацией, он сможет немало написать)
Нужно просто исходить из позиции "это нужно сделать".

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

46. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от anonymous (??) on 23-Апр-10, 18:08

Документированный код — это не обязательно комментарии в исходниках. Новость перечитайте.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

47. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от XoRe (ok) on 23-Апр-10, 22:33

>Документированный код — это не обязательно комментарии в исходниках. Новость перечитайте.
Ну, если вы про man'ы, то с этим лучше, чем во многих проприетарных программах.
А перевод на другие языки страдает, как у опенсурса, так и у клозедсурса.
Не могу сказать, у кого страдает меньше.
Если только разделить проекты по крупности и сравнивать в своей весовой категории.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

48. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от anonymous (??) on 24-Апр-10, 11:00

>Ну, если вы про man'ы, то с этим лучше, чем во многих
>проприетарных программах.
>А перевод на другие языки страдает, как у опенсурса, так и у
>клозедсурса.
Перевод вопрос отдельный, в новости тоже разделено. А маны это только часть документации:
$ man openoffice
No manual entry for openoffice
$ man firefox
(сами оцените информативность;)
и т.д. Для гуевого софта нужны обычные хелпы, а их часто или нет, или недостаточно наполнены, или не локализованы, или и то, и другое.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

27. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от Аноним (??) on 21-Апр-10, 09:17

"Серьезность проблемы пренебрежения открытых проектов процессом документирования"
забористо

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

35. "Серьезность проблемы пренебрежения открытых проектов процесс..." –2 +/–

Сообщение от Proger (ok) on 21-Апр-10, 12:02

А причём тут вообще "пренебрежение"? Трольвадс же сказал: "for fun", а какой фан писать доки?!? Каждый мнит себя кульхацкером и пишет код не для того, чтобы его потом скурпулёзно вылизывать и документировать - добьются компиляции, запустят перделку - всё, фан получен, сорсы - в массы! :) Или я ошибаюсь?
А по мне не в доках дело, а в инструментах - чем примитивнее язык (С/С++), тем сложнее докапываться до логики (хотя она КАК БЫ очевидна). Это как с часами - вроде бы все колёсики на виду, но ни черта непонятно! :)) Так что надо двигаться в сторону C#/D, там хоть поменьше кодомусора.
Ну и ещё момент: многие библебатеки написаны чуть ли не на заре линупса, некоторые - свежие, но опять являются чьим-то "портoм", в результате этот тухлокод поддерживается годами, совместимости ради. Перепроектировать этот хлам никому не интересно (а коммерч. компаниям и не выгодно), так что мегабайты обросших библиотек кочуют из дистра в дистр, затрудняя и компиляцию, и переносимость и даже улучшение. Либа более, чем в 500Кб кода - уже не поддающийся осмыслению монстр, так что даже доки тут не панацея - "вся проблема в головах".

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

38. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от Ян Злобин (ok) on 21-Апр-10, 16:29

>Так что надо двигаться в сторону C#/D, там хоть поменьше кодомусора.
Глупости все это.  Если привык оформлять код как придется, то на любом языке получится мусор.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

40. "Серьезность проблемы пренебрежения открытых проектов процесс..." –1 +/–

Сообщение от eugeni on 21-Апр-10, 18:33

Я "домохозяйка" и я хочу владеть документацией на родном языке.
Я хочу настраивать свою систему как хочу.Я не хочу болтаться по
идиотским форумам ,видя ,идиотские советы "учи американски".
Не хочу долбитсься с Google-переводчиком.
И я готов пожертвовать деньги для хорошего перевода.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

42. "Серьезность проблемы пренебрежения открытых проектов процесс..." +1 +/–

Сообщение от Аноним (??) on 22-Апр-10, 00:00

не вопрос. 200$ за 40 тыщ знаков, предоплата 50%. Да, и заказчик должен быть на Украине или в США. Устраивает?

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

43. "Серьезность проблемы пренебрежения открытых проектов процесс..." +/–

Сообщение от Аноним (??) on 22-Апр-10, 00:05

сорри, про минимальный объем забыл добавить. 5 х 40 000 тыс. зн.

Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

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

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

Партнёры:

Хостинг:

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

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

1. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–2 +/–
Сообщение от Аноним (??) on 20-Апр-10, 17:04
Как будто к проприетарщине больше документации...
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	4. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+1 +/–
	Сообщение от name (??) on 20-Апр-10, 17:22
	ну вот к win32 GDI, к примеру, её _как минимум_ на порядок больше, чем к иксам
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	16. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+1 +/–
	Сообщение от User294 (ok) on 20-Апр-10, 21:28
	Осталось только найти мазохистов которые будут под гольные иксы программить :D
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	41. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Аноним (??) on 21-Апр-10, 19:52
	Под иксы документации - пяток толстеньких книжечек от O'Reilly плюс подробные описания ключевых библиотек и протоколов X11 в комплекте дистрибутива (объемистые такие pdf'ки). Вы мне лучше покажите мазохистов, которые в 2010 году будут программить под Win32 GDI, без MFC и прочих дотнетов.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	11. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–1 +/–
	Сообщение от anonymous vulgaris on 20-Апр-10, 21:23
	>Как будто к проприетарщине больше документации... хелпы там нормальные
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	13. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–3 +/–
	Сообщение от Трухин Юрий Владимирович on 20-Апр-10, 21:26
	Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	18. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от anonymous vulgaris on 20-Апр-10, 21:35
	>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает >его совсем нет и это очень ужастно речь в новости абсолютно обо всем включая translators, user interface designers, artists, а самое слабое место это обычно хелпы, потому что - TONS of documentation that many people simply CAN'T slog through.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	28. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Трухин Юрий Владимирович on 21-Апр-10, 09:25
	>а самое слабое место это обычно хелпы, потому что - TONS of >documentation that many people simply CAN'T slog through. вы не рвзработчик на сколько я понимаю... иначе вряд ли такое бы написали. Help можно написать, а вот использовать более-менее сложную библиотеку без комментированного кода нереально. Если вы конечно не обладаете даром телепатии.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	30. "и семплов ещё"		+/–
	Сообщение от Вова on 21-Апр-10, 09:56
	>>а самое слабое место это обычно хелпы, потому что - TONS of >>documentation that many people simply CAN'T slog through. > >вы не рвзработчик на сколько я понимаю... иначе вряд ли такое бы >написали. Help можно написать, а вот использовать более-менее сложную библиотеку без >комментированного кода нереально. Если вы конечно не обладаете даром телепатии. всё правильно, + примеры использования, тоже адски важны.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	25. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Ян Злобин (ok) on 21-Апр-10, 03:44
	>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если код писан по стандартам GNU - читать его одно удовольствие.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	26. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–1 +/–
	Сообщение от Feadot (ok) on 21-Апр-10, 08:57
	>Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если код писан по стандартам GNU - читать его одно удовольствие. Сплю и вижу домохозяйку, которая читает исходники дабы понять как работает программа... По нажатию F1, не хэлп, а сразу исходник программы открывает!
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	33. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Ян Злобин (ok) on 21-Апр-10, 10:23
	>Сплю и вижу домохозяйку, которая читает исходники дабы понять как работает программа... При чем здесь домохозяйка-то? Речь зашла об исходниках, а это явно не для домохозяек. :-)
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	29. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–1 +/–
	Сообщение от Трухин Юрий Владимирович on 21-Апр-10, 09:26
	>>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно > >Зачастую можно обходиться и без подробной документации, ибо есть исходники. Особенно, если >код писан по стандартам GNU - читать его одно удовольствие. и много сорцов ты прочитал и понял без телепатии? Неужели в ваших гнутых стандартах нет требования комментировать код... я очень удивлюсь если так
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	32. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+1 +/–
	Сообщение от Ян Злобин (ok) on 21-Апр-10, 10:22
	>и много сорцов ты прочитал и понял без телепатии? Неужели в ваших >гнутых стандартах нет требования комментировать код... я очень удивлюсь если так Да немало. И регулярно читаю. Где-то есть комментарии, где-то нету. Когда код хорошо оформлен обычно и без комментариев все понятно. Например, что делает функция gtk_tree_view_get_selection легко понятно из без телепатии. :-)
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	39. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от vayerx (ok) on 21-Апр-10, 17:10
	реализацию математики почитайте
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	44. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+1 +/–
	Сообщение от Веслый мясник on 22-Апр-10, 01:37
	Сплю и вижу человека, который юзает (к примеру) OpenSSL, руководствуясь исходниками. Смешно, ей-богу...
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	45. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от неизвестный on 22-Апр-10, 08:29
	полность согласен
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

2. "Серьезность проблемы пренебрежения открытыми проектами проце..."		–2 +/–
Сообщение от А (??) on 20-Апр-10, 17:11
Большинство кода дают большие компании и в отсутствии док есть логика. Код открыт и бесплатен, кто ниасилил прочитать код и разобраться как работает платит за поддержку. Пока красноглазые приверженцы меряются крутизной дистров умные дядьки деньги зарабатывают.
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	5. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+2 +/–
	Сообщение от name (??) on 20-Апр-10, 17:25
	>кто ниасилил прочитать код и разобраться как работает функции должны быть документированы, читать все исходники, чтобы понять какая функция нужна для выполнения необходимого действия - чистое красноглазие
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	7. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+3 +/–
	Сообщение от аноним on 20-Апр-10, 17:58
	А автор пробовал разрабатывать что-нибудь сам?
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

3. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
Сообщение от croster (ok) on 20-Апр-10, 17:16
Есть и проекты с хорошей документацией. Пример - PostgreSQL, там документация на 2000 страниц в pdf формате.
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	6. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Твистер on 20-Апр-10, 17:40
	На sendmail вон более 1200 страниц описания и что кто-то активно пользует?
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	8. "Серьезность проблемы пренебрежения открытыми проектами проце..."		+/–
	Сообщение от Аноним (??) on 20-Апр-10, 18:57
	согласен, отличная документация у mediawiki а худщая у zend framework
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

12. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+/–
Сообщение от Belov Sergey (ok) on 20-Апр-10, 21:23
У многих проектов с документацией проблемы. Особенно с локализованной. Справка к GIMP переведена лишь частично. Из-за этого у нас внедрение в учебный процесс тормозится.
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

20. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+2 +/–
Сообщение от rm_ (ok) on 20-Апр-10, 21:52
Переводы вечно устаревшие и неактуальные, в реальности никто их не будет поддерживать в актуальном состоянии в свободных проектах, как бы этого ни хотелось г-ну Джо Брокмейеру. Поэтому хотите пользоваться компьютером - извольте знать хотя бы технический английский.
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

21. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+/–
Сообщение от амонинус on 20-Апр-10, 22:22
Да, к сожалению. Многие лидеры проектов еще не поняли, что даже если код компилируется не на компьютере, а в голове, и не с Си, а с английского, он не менее важен, чем тот, который в компьютере, и должен, блин, быть частью проекта, а не "сопровождением". Особенно когда проект открытый.
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	31. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+1 +/–
	Сообщение от Вова on 21-Апр-10, 10:00
	>Да, к сожалению. Многие лидеры проектов еще не поняли, что даже если >код компилируется не на компьютере, а в голове, и не с >Си, а с английского, он не менее важен, чем тот, который >в компьютере, и должен, блин, быть частью проекта, а не "сопровождением". >Особенно когда проект открытый. Заурядный программист пишет код, понятный компилятору, хороший - код, понятный другому программисту.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	36. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+1 +/–
	Сообщение от Aleksey (??) on 21-Апр-10, 14:02
	А очень хороший еще и документацию к коду.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору


	37. "Серьта я согласен"		+/–
	Сообщение от Вова on 21-Апр-10, 14:43
	всё так, локальные викисы и сам пишу, и в других приветствую.
	Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору

24. "Серьезность проблемы пренебрежения открытых проектов процесс..."		+/–
Сообщение от XoRe (ok) on 21-Апр-10, 00:47
Я так понимаю, открытые исходники недостаточно документированы по сравнению с закрытыми? Ну, давайте посмотрим на закрытые исходники, поучимся у них документированию) А где закрытые исходники? Нету. Т.е. Брокмейер сетует только по поводу того, на что можно посмотреть. Посмотрел бы он на документированность закрытого кода...) А документация к программе... Мистеру Брокмейеру стоит указать на команду man, которая дает возможность почитать не только документацию к программам, но даже к функциям языков (man malloc). В остальном я бы сказал, что на документацию всегда можно найти время. Если один человек будет заниматься только документацией, он сможет немало написать) Нужно просто исходить из позиции "это нужно сделать".
Высказать мнение \| Ответить \| Правка \| ^ \| Наверх \| Cообщить модератору