The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

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

"Серьезность проблемы пренебрежения открытыми проектами проце..."  +/
Сообщение от 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
Новость: https://www.opennet.ru/opennews/art.shtml?num=26303

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

Оглавление

Сообщения по теме [Сортировка по времени | 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. "Серьезность проблемы пренебрежения открытыми проектами проце..."  +/
Сообщение от Ян Злобин email(ok) on 21-Апр-10, 03:44 
>Речь не о хелпах, а о документировании кода. Да, в опенсорсе бывает его совсем нет и это очень ужастно

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

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

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

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

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

33. "Серьезность проблемы пренебрежения открытыми проектами проце..."  +/
Сообщение от Ян Злобин email(ok) on 21-Апр-10, 10:23 
>Сплю и вижу домохозяйку, которая читает исходники дабы понять как работает программа...

При чем здесь домохозяйка-то?  Речь зашла об исходниках, а это явно не для домохозяек. :-)

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

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

и много сорцов ты прочитал и понял без телепатии? Неужели в ваших гнутых стандартах нет требования комментировать код... я очень удивлюсь если так

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

32. "Серьезность проблемы пренебрежения открытыми проектами проце..."  +1 +/
Сообщение от Ян Злобин email(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 email(ok) on 20-Апр-10, 21:23 
У многих проектов с документацией проблемы. Особенно с локализованной. Справка к GIMP переведена лишь частично.
Из-за этого у нас внедрение в учебный процесс тормозится.
Высказать мнение | Ответить | Правка | ^ | Наверх | Cообщить модератору

20. "Серьезность проблемы пренебрежения открытых проектов процесс..."  +2 +/
Сообщение от rm_ email(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. "Серьезность проблемы пренебрежения открытых проектов процесс..."  +/
Сообщение от Ян Злобин email(ok) on 21-Апр-10, 16:29 
>Так что надо двигаться в сторону C#/D, там хоть поменьше кодомусора.

Глупости все это.  Если привык оформлять код как придется, то на любом языке получится мусор.

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

40. "Серьезность проблемы пренебрежения открытых проектов процесс..."  –1 +/
Сообщение от eugeni email 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 | Индекс форумов | Темы | Пред. тема | След. тема




Спонсоры:
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2021 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру