维持一个程序员Wiki[封闭]

Question

我最近把负责维基于发展的团队。Wiki是仍然处于初级阶段，所以我有很多的房间要工作。它的目标是房子内部发展的团队。目前，主要的信息，wiki拥有被编码的标准。

• 什么是一些最佳做法，开发团队用于其内部维基？
• 什么样的信息是重要的是要有一个开发维基？
• 如果你要去wiki对开发团队什么样的信息，你会期望看到什么？
• 是有一些信息，不应该去上wiki即使它似乎是一个很好的主意吗？

-编辑--

• 此外，是否有一个良好的方式来组织的信息？(例如通过层(数据，用户界面)，由项目或其它)

Answer 1

• 引入来源基于新的程序员
• 一般性文件(不API文件每se，但更多的教程中喜欢的东西)
• 列出的工作人员/人是谁做什么以及如何达到这些
• 说明/资源/文章，解释的概念使用的软件
• 文件的建立过程和文件系统的布局的代码

其他的事情我通常把有

• 规划/待办列表
• 信息是有趣的其他人读
• 其他的一切，我觉得应该分享

Answer 2

我们有一个发展wiki，这是一个伟大的工具。我们用它 的一切!

• 当头脑风暴的新的想法，我们捕获他们在wiki。低摩擦性质wiki取得了很容易让人在组织(我们是一个小的启动)到增加的想法，因为他们想到他们。我们有一个高级别"集思广益"页面，该页面链接到详细的网页含有彻底说明的每一个想法。
• 每次迭代，我们的"移动"功能主意的项目"集思广益"的要素的列表中对这次迭代。的细节特征是冲出包括设计和实施细节。
• 为特征是完成，迭代页成为我们的版本说明页面-其中也包括释放的标记来自我们的版本控制系统。
• 我们有一个错误的页面的工作非常相似的特性的网页。错误的修正添加到迭代/释放的网页，因为他们的工作/完成。
• 我们还创建了我们的用户文档有关的wiki和出口这些网页，它与释放。

随着时间的流逝。这种工具被视更多和更有价值。我们绕了创建新的维基于不同的产品的公司工作。

我希望你找到你的发展wiki作为有用的，因为我们没有！

Answer 3

Wikipatterns 是一个网站，专门记录最佳wiki做法。他们还描述了反模式和谈的方式来处理它们。我阅读他们的书，这是一个伟大的资产对我来说，获得一个维基断地在150多人的组织。

Answer 4

一件事，我们强调，在我们的开发wiki是，它是更新的当事情变化。我们不希望我们的维基，目的是提供信息，并以一个中央来源收集的知识成为这么出的日期，这是没用的。作为代码被更新、开发人员被要求更新任何有关的信息。

比其他编码标准，我们保持技巧和为工作与我们的码基地，设置信息用于新的雇用和一般环境信息。

Answer 5

• 燃尽的图表
• 共同建立信息对于发展的环境(为，当新的人开始)
• 规格
• 已知问题和解决方法与开发工具

Answer 6

拿出某种风格的指导，并教导他人如何风格的东西。当我负责的企业wiki，所有其他开发商将编写糟糕的文章，几乎没有格式化，并且看起来可怕。

远离的东西，需要讨论。我试着鞋拔在一本审查部分，但这太难以有人评论的东西。

例在房子图书馆都很好。和/或"故事"走一个用户通过一个过程当MethodX。

Answer 7

什么是一些最佳做法，开发团队用于其内部维基？

使它看起来不错。我知道这听起来并不重要，但是如果你多花一点时间的品牌它支付条款的人实际上使用它。和吸收关键的，或者它只会枯萎和死亡。

什么样的信息是重要的是要有一个开发维基？

• 一般信息有关的一个项目里程碑、交付日期等。
• 摘要设计的决定/会议。重要的，所以你不再次访问同一区域的一次又一次。
• 如何引导一般的发展项目(例如，如何制定一个新的插件)

如果你要去wiki对开发团队什么样的信息，你会期望看到什么？

项目的信息，谁是工作上有什么等等。设计的决定。还最佳做法和有用的链接的网站。

是有一些信息，不应该去上wiki即使它似乎是一个很好的主意吗？

低级别工作清单往往会波动和不能保持最新，并可能会产生误导。此外，关键的通信部门之间更适合的电子邮件，然后对话的可复制的wiki。这太容易忽视它，否则！

Answer 8

记住这一wiki是互动的。如果你想出版的，如在出版燃尽图，那么你不认为远远不够的。分发这些信息仅为它的一部分。

为实例，而不是具有一个"当前燃尽图"页面，创建一个网页为"燃尽的图表，对每周的10-27-2008"，然后鼓励人民发表意见的图表，这意味着什么，为什么你没有如此糟糕，星期。

Answer 9

最难的部分是获得开发人员使用你的wiki。我有一些长期建议： http://possibility.com/wiki/index.php?title=GettingYourWikiAdopted

得到一个Wiki通过是艰难的

有一个冠军

删除反对意见

创建内容

绊住Wiki在公司的过程

传福音

不要放弃

考虑不使用Wiki对话

只要做到这一点！不要等待一个预算

有一个过渡计划

促进维基

一个很好的做法是，让整个文件和源码对于每个建立可以通过你的wiki。然后，开发商将去wiki访问建立的信息，这使得它非常宝贵的。

Answer 10

Wiki可以是一个宝贵的资源用于软件开发团队，但他们没有银弹。它是太容易建立一个维基，将迅速淘汰或成为严重过时。

在我看来，成功的关键Wiki是获得整个团队对委员会。这意味着让人们远离其他资源(特别是电子邮件档案)作为知识库，并提供一些激励人们作出贡献。

然而，它也是重要的不是一个沙皇的格式:如果你有一个很大的文件，你在产生，说,MS WORD,它可能是理想的做他们都在Wiki的格式，但这需要时间，可能是令人讨厌的，如果你有图、文件等。在这些情况下，最好的妥协和让人们保持它在word格式，只要作为唯一的方法，以访问最新版本是通过Wiki。

如果你不是个经理，您需要获得一个管理董事会，因为它将需要一些"执行".

那里已经积累的研究和经验上的维基和他们的使用在软件工程。你可以搜索的含石棉材料的数字图书馆，例如。我是一个coorganizer的一年一度的研讨会上的维基于本身和我们有几个有趣的经验的报告和有额外的材料的国际专题讨论会Wiki。

Answer 11

我们的房子和电队wiki。还有，我们把所有的必要信息用于每一个项目，我们是发展中:

• 库
• 地址为虚拟机
• 密码
• 项目的文件
• 项目概况
• 项目状态

和其他任何需要我们填补被写在一个项目。它是最有用的网络应用程序，我们正在运行(除了 螳螂).在更一般的网页，我们把一个定义中的每一个分类，我们使用的，一般项目的指导方针、政策、编码和发展做法，我们使用。它是存在的，它是简单和有效的而且我认为每个团队应有其中的一个。