如果你曾经使用过PHP、Ruby、Perl、Groovy,或许还用其他语言编程,那么你就会知道有一个集中、官方的参考文档和内联社区反馈空间是多么美好。

这是JEE社区一直缺少的东西,也是导致许多网站试图提供有用的文档却效果不佳的原因——抛开社区部分,我们会认为这是任何开源技术的优点。

成功的开源社区文档计划具有以下特点:

  • 在中央、官方网站上提供全面文档(http://seamframework.org)
  • 内联评论和用户反馈。
  • 网站上的最常见路径是最直观、最易见的路径。
  • 流畅的导航和文档层次结构。(URL与面包屑导航匹配内容。如果用户迷路,他们可能会放弃。)
  • 准确且相关的官方信息,经过充分审查的信息。

我相信还有更多,但这是我目前能想到的。

让进步发生

在开启我在Red Hat(希望是漫长的)任期之际,我专注于改进Seam框架和Java EE的整体社区文档。我开始通过更新Seam框架网站来更清晰地显示Seam和Weld JIRAs的链接;你之前需要做一些挖掘。

所有我的努力都可以在这里追踪: https://jira.jboss.org/jira/browse/JBSEAM-4585

请,如果你们发现任何关于Seam或Weld文档的未解决问题或痛点,请将它添加到这个Jira。如果你们做不到,请在这里评论,我会确保它得到解决。

SeamFramework.org 需要改进,我确实认为该社区应属于 jboss.org,以便充分认可他们的辛勤工作和杰出成就。Jboss.org 也提供了我在社区管理工具中寻找的大部分功能,但我们拭目以待大家的需求 ;)

快乐的社区创造快乐的软件!


返回顶部