寻找精心设计，记录完备的开源项目

Question

下个月，我的公司将发布我们的一项技术作为开源项目。我们现在正在准备网站，文档等。我想问的问题是：

您会推荐哪些开源项目作为一个记录良好，精心设计的项目的参考？

我们正在寻找具有良好网站展示，文档，教程，样本等的开源项目。我们可以学习的项目。

（关于我们项目的几句话，如果它是相关的：它是一个基于OpenLayers的网页映射的JavaScript库。）

我的示例是JQuery或Vaadin。

Answer 1

Django框架是well-documented，拥有自己的book，一个不错的website，彻底contribution policy等等。你还想要什么？

值得注意的一件好事（我知道很多其他项目都这样做），它们是将文档作为主干的一部分包含在内，所以当有人提交补丁时，它们会同时包含对文档的更改。这确实有助于保持所有内容同步。

Answer 2

  

您会推荐哪些开源项目作为一个记录良好，精心设计的项目的参考？

Qt 4。它是双许可的（商业/ LGPL），所以它在技术上不是100％纯开源，但你无法击败documentation and tutorials。

Answer 3

在这方面，我看到sqlite获得了很多奖项。源代码，测试和文档都很干净，维护良好且充足。

他们可能没有最酷的网页设计师，但他们专注于重要的事情。

Answer 4

我有偏见，但我认为Kuali做得很好：http://www.kuali.org/

Answer 5

Blender 3D非常专业且记录完备。 您可以找到developer documentation，end-user documentation（完整的教程和视频教程），end-user website和books...

Answer 6

  

我们正在寻找具有良好网站展示，文档，教程，样本等的开源项目。我们可以学习的项目。

• Spring Framework（他们的网站可能不像Vaadin那样精简，但文档，教程和示例都是示例）。
• Ruby On Rails
• YUI Library

Answer 7

我喜欢Ubuntu网站

的外观，布局和功能（尤其是社区）

Answer 8

MooTools 是非常完整的文档，它可能是ProtoType旁边最喜欢的JS库。它的麻省理工学院获得许可（如果这对你很重要），而且从我记忆中来看，它非常优雅。

Answer 9

的Drupal！ http://drupal.org/handbook - 非常好的文档......等等。但这是“大家伙”之一。

我也喜欢http://teambox.com/：正是您需要的文档。

Answer 10

Wordpress？和其他人一样，有一个很好的网站，在线文档，很多人都在使用它。

Answer 11

红宝石。

• 网站：http://www.ruby-lang.org/en/（大量内容，积极更新）。
• 文档：http://www.ruby-doc.org/（许多文档）。
  • “附加文档化”，附带教程：http://ruby-doc.org/docs/
• 来源：http://github.com/ruby/ruby

Answer 12

我在我的一个项目中使用Ogre3D大约9个月，评论非常好。

Answer 13

与其他一些建议相比，它的使用略少，但我对Fog Project有很好的体验。文档非常好，Wiki /论坛也是如此。 Ubuntu是另一个好的，虽然这里已经提到了。

Answer 14

我认为www.php.net是有用的链接方式，可搜索的可更新文档，有用库的链接，即将发布的版本说明等等。

Answer 15

我喜欢使用Sass的Haml和http://yardoc.org/文档 我发现类和方法的实时搜索（右上角标签）非常快速和方便。

他们也都有简单，设计精美的主页（Haml home和Sass home），这些主页明确说明了他们所做的事情，以便让人们快速了解。

同样Sinatra有一个非常简单的方法，就像django一样，有一个"book"，它有一个similar api to Sass and Haml，你可以在github上查看它。

Answer 16

当我与HtmlUnit合作时，我认为它已经很好地呈现并且记录良好。也非常积极地维护，这很好。

Answer 17

我特此提名Aubit4GL http://www.aubit.com/

Answer 18

Django project。优秀的代码，出色的文档，强大的支持，有组织的发布政策。

Answer 19

试着看看Yii这是一个用于MVC应用程序的PHP框架（包括Web和命令行），具有良好的数据库抽象层，良好的代码质量和一致性，并且不会因为想要支持而陷入困境古老的php安装。

Answer 20

我强烈建议你包括过去几年在开源工作的人，并从他那里获得建议。

它比跟随某些东西更有效，因为他可以立即给你指示并使你的目标大获成功。

Answer 21

我投票给grails！基于Groovy的框架构建于Spring MVC之上。我个人使用它，这很好。

Answer 22

看一下Ghostscript，它也是行业中获得许可并得到良好支持的：http://ghostscript.com/

其他人在我面前提到了Ubuntu，我会在第二/第三/那些建议中提到。

我认为git很好，如果你不熟悉，请看http://git-scm.com/documentation。

根据假定的用户群，在化石项目中有不同程度的抛光。对于普通用户来说，开发人员的项目看起来很脆弱。很多项目都没有达到吸引大量用户和开发人员的程度。

gnome和KDE桌面环境都值得关注。分别为http://www.gnome.org/和http://www.kde.org/。任何项目都可以受益于一个大按钮，上面写着“帮助！我不是超人，但我想学习这个”，然后握住他们的手并走过去...但当然有很多写作和艺术/截图参与类似的事情。