В следующем месяце моя компания выпустит одну из наших технологий в качестве проекта с открытым исходным кодом. Сейчас мы готовим сайт, документацию и так далее. Вопрос, который я хотел бы задать, заключается в следующем:
Какие проекты с открытым исходным кодом вы бы рекомендовали в качестве ссылки на хорошо документированный, хорошо представленный проект?
Мы ищем проекты с открытым исходным кодом, которые имеют хорошую презентацию на сайте, документацию, учебники, образцы и т.д. Проекты, о которых мы могли бы узнать.
(Несколько слов о нашем проекте, если это имеет значение: это библиотека JavaScript для веб-сопоставления на основе OpenLayers.)
Мои примеры были бы JQuery или Vaadin.
инфраструктура Django хорошо документирована, имеет ее book, хороший веб-сайт, тщательный политика вклада и многое другое. Что еще вам нужно?
Одна хорошая вещь, которую нужно отметить (и я знаю, что многие другие проекты делают это), включают ли они документы как часть соединительной линии, поэтому, когда кто-то отправляет патч, они включают в себя изменения в документации в одно и то же время, Это действительно помогает синхронизировать все.
Какие проекты с открытым исходным кодом вы бы рекомендовали в качестве ссылки на хорошо документированный, хорошо представленный проект?
Qt 4. Это двойная лицензия (коммерческая/LGPL), поэтому она технически не является 100% -ным открытым исходным кодом, но вы не можете выполнить документацию и учебные пособия.
Я видел много призов за sqlite в этом отношении. И исходный код, тесты и документация являются чистыми, ухоженными и многочисленными.
У них могут не быть крутых веб-дизайнеров, но они сосредоточены на важных вещах.
MooTools очень документирован и, возможно, мой любимый JS lib рядом с ProtoType. Его лицензия MIT (если это имеет значение для вас) и, насколько я помню, очень изящно написано.
Мне нравится внешний вид, макет и функции (особенно сообщество) Ubuntu сайт
Я предвзятый, но я думаю, что Куали делает неплохую работу: http://www.kuali.org/
Мы ищем проекты с открытым исходным кодом, которые имеют хорошую презентацию на сайте, документацию, учебники, образцы и т.д. Проекты, о которых мы могли бы узнать.
Drupal! http://drupal.org/handbook - очень хорошая документация.. и т.д. Но это относится к числу "больших парней".
Мне также нравится http://teambox.com/: именно то, что вам нужно для документации.
Blender 3D очень профессиональна и очень хорошо документирована. Вы можете найти , документация для конечного пользователя (в комплекте с учебниками и видеоуроками), конечный пользовательский сайт и книги...
Wordpress? Как и другие, есть хороший сайт, онлайн-документация и используется довольно многими людьми.
рубин.
проект Django. Отличный код, отличная документация, отличная поддержка, организованная политика выпуска.
Настоящим я назначаю Aubit4GL http://www.aubit.com/
Когда я работал с HtmlUnit, я подумал, что он довольно хорошо представлен и хорошо документирован. Также очень активно поддерживается, что приятно.
Я поклонник Sass и Haml docs, которые используют http://yardoc.org/
Я нахожу поиск в реальном времени классов и методов (верхние правые вкладки) очень быстрыми и удобными.
У них также есть простые, красиво оформленные домашние страницы (Haml home и Sass home), которые разъясняют, что они делают, чтобы дать людям быстрое понимание.
Также Sinatra имеет довольно простой подход, который, как и django, имеет "book" , он получил аналогичный api для Sass and Haml, и вы можете проверить все это на github.
Я использовал Ogre3D в одном из моих проектов около 9 месяцев, и он был очень хорошо прокомментирован.
Я думаю, что www.php.net - это путь с точки зрения полезных ссылок, поисковой обновляемой документации, ссылок на полезные библиотеки, заметки о предстоящих рейсах и т.д. и т.д.
Он немного менее часто используется, чем некоторые другие предложения здесь, но у меня были большие впечатления от Fog Project. Документация отличная, как и Wiki/Forums. Ubuntu является еще одним хорошим, хотя это уже упоминалось здесь.
Попробуйте взглянуть на Yii его фреймворк PHP для приложений MVC (как для сети, так и для командной строки) с приличным уровень абстракции базы данных, хорошее качество кода и согласованность, а также не увязнуть, желая поддерживать античные установки php.
Я бы настоятельно рекомендовал вам включить кого-то, кто работает в open source в течение последних нескольких лет, и получить от него совет.
Это более эффективно, чем следовать чему-то, поскольку он может дать вам указания мгновенно и сделать вашу цель великим успехом.
Я голосую за grails! Основа groovy, построенная поверх Spring MVC. Я лично использую его, это хорошо.
Взгляните на Ghostscript, который также был альтернативно лицензирован и хорошо поддерживается в промышленности: http://ghostscript.com/
Другие упомянули Ubuntu передо мной, и я буду второй/третьей/nth этих рекомендаций.
Я думаю, что git хорошо представлен, посмотрите http://git-scm.com/documentation, если вы не знакомы.
Существуют разные уровни полирования в проектах foss в зависимости от предполагаемой базы пользователей. Проекты для разработчиков могут казаться жесткими для обычных пользователей. Многие проекты никогда не доходят до уровня польского языка, который привлекает массу пользователей и разработчиков.
Стоит посмотреть на настольные среды gnome и KDE. http://www.gnome.org/ и http://www.kde.org/ соответственно. Любой проект может выиграть от большой кнопки, которая говорит "помогите! Я не сверхчеловек, но я хочу это узнать", а затем держит их за руку и проходит через них... но, конечно, есть много писем и картинок/скриншотов что-то подобное.