让开发人员使用 wiki [关闭]
https://stackoverflow.com/questions/15871
-
08-06-2019 - |
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russian题
我正在开发一个复杂的应用程序，其中不同的团队在他们自己的模块上工作，并且有一定程度的重叠。不久前，我们设置了一个 Mediawiki 实例，部分是在我的提示下。我很难让人们真正使用它，更不用说做出贡献了。
我可以看到共享信息有很多好处。它至少可以减少我们重新发明轮子的次数。
维基不是很结构化，但我不确定这是否是一个问题，只要你可以搜索到你需要的东西。
有什么提示吗？
解决方案
如我所说 前, ，Wiki 非常杂乱。
但是，如果这是开发人员的唯一论据，那么请投入一些精力来创建一个简单的索引页面并保持其更新（您自己做或要求人们将他们的贡献链接到索引）。这样，Wiki 可能会成长为一个非常漂亮且非常全面的文档集合，涵盖您的所有工作。
其他提示
一些技巧：
每当有人通过电子邮件发送真正应该出现在 wiki 中的信息时，请为该主题创建一个页面并添加他们在电子邮件中放入的内容。然后回复“感谢您提供这些信息，我已将其放入此处的 wiki 中，以便将来更容易找到。”
同样，如果您有需要分享的信息应该在 wiki 中，请将其放在那里，然后发送一封带有链接的电子邮件，而不是向人们发送电子邮件。
当您向人们询问信息时，请用措辞表达，以便将此类文档放入 wiki 中应被视为默认或标准：“我在维基百科上搜索过，但没有找到。你把这些信息放在那里了吗？”
如果您是“维基冠军”，请确保其他人知道如何使用它，例如“我和你讨论过如何创建新页面了吗？”
编辑侧边栏以确保其与您的工作相关。
在相关页面上使用“导航框”样式模板以方便导航。
将类似 {{Special:NewPages/5}} 的内容或最近的更改放在首页上，以便人们可以看到活动。
每隔几天或每周查看一下最近的更改，如果您发现有人在未经提示的情况下添加信息，请向他们发送电子邮件或顺便拜访并给予他们一点赞美。
我们已经以某种形式使用 wiki 一段时间了，但人们确实需要一段时间才能加入。您可能会发现一段时间内您将是唯一一个写文章的人，但请耐心等待，其他人最终会加入。
如果有人发送一封包含与项目相关的信息的电子邮件，然后帮助他们指出 wiki 的方向 - 并继续这样做 - 他们应该得到提示。
我们有一个 SharePoint 门户并使用那里的 wiki - 我们用我们自己的品牌对其进行了定制，以便它“看起来很合适” - 我真的觉得这有助于提高它的采用率。
确保每个人都知道维基比电子邮件更加非正式......因为会有一种“恐惧因素”，人们可能会认为他们添加到维基百科的任何内容都会被过度分析。
我认为到目前为止，大多数答案都是正确的——你自己投入得越多，有用的信息就会变得越大，所以人们会慢慢地但肯定地自然地开始使用它。
您可以使用的另一种方法是：建议每次有人向其他团队成员询问有关该项目的问题时，他们都应该像往常一样回答问题，同时还将答案添加到 Wiki 的某个部分中。这可能会额外花费几分钟，但这意味着下次有人问同样的问题时（他们不可避免地会这样做），您可以通过将他们指向 Wiki 来节省时间。反过来，这应该可以帮助人们开始使用 Wiki 作为第一个信息来源，并有助于整体接受。
你不能强迫开发人员做他们没有动力使用的事情；不幸的是维基百科，就像文档一样（好吧，事实上维基百科 是 文档）对于开发人员来说很少有任何“酷”价值。此外，他们已经深入到开发工作中了——你真的能用 wiki 来打扰他们吗？
话虽这么说，推动 wiki 的人（例如，您）应该主要负责更新它，如果您认真对待它，您确实需要做很多工作。
您也可以尝试 ff：
- 你说它的结构不是很好——很多人都对结构不良（难以搜索/浏览）的 wiki 感到厌烦。所以也许你可以先解决这个问题
- 也许您可以要求首席开发人员/项目经理在其中填充对他们来说有问题的内容：诸如针对您的特定项目的代码约定和 API 设计之类的事情
- 以身作则：虔诚地记录 你的 系统的一部分。开创先例可能会鼓励其他人效仿
向开发人员推销使用 wiki 的想法。您已经确定了一些好处，请与开发人员分享。如果他们看到可以从中获得一些有价值的东西，他们就会开始使用它。
示例优势来自 什么是维基
- 适合写下快速想法或较长的想法，让您有更多时间进行正式写作和编辑。
- 无需通过电子邮件发送文档即可立即协作，保持团队同步。
- 可以通过网络连接从任何地方访问（如果您不介意以网络浏览器文本形式书写）。
- 您的存档，因为每个页面修订都会被保留。
- 令人兴奋、直接、赋权——每个人都有发言权。
我做过一些销售，甚至举办过一些培训课程。我认为有些人因为缺乏所见即所得的编辑功能以及从 Word 或 Outlook 粘贴格式化文本的能力而感到厌烦。我知道有一些工具可以解决这些问题，但它们仍然是障碍。
在某些领域，维基百科被用来记录某些领域，但更新这些领域的人并没有用它做任何其他事情。
我将使用 wiki 来记录我的专业领域，无论它是一种方便的大脑扩展。当开始新的开发时，我将它用作记事本，记录我可以随着开发的进展而扩展的想法。
如果管理层能够给予一些口头支持，即使不是强制性的，也会有所帮助。
我很难让人们真正使用它，更不用说做出贡献了。
让人们为 wiki 做出贡献的最简单方法之一，就是让他们以适合 wiki 的方式提供内容，即因此，无论他们使用常用的通信渠道（新闻组、邮件列表、论坛、问题跟踪器、聊天）发布的内容，基本上都适合包含在 wiki 中。
这样其他人（用户/志愿者）就可以简单地获取这些内容并将其放在维基上。
这听起来比实际情况更复杂，它主要是对问题和答案进行概括，因此它们不一定是对话的一部分，但可以以独立的方式理解、有意义和有用。
例如像下面这样的问题：
如何让 git 克隆远程存储库？？？
可以这样回答：
您好，只需使用git克隆git：// ...
但问题也可以用不那么个人化的方式来回答：
为了克隆 git 存储库，您需要对 git 使用克隆参数：git 克隆 git://...
我想说的是，项目中的大多数讨论最终都可以而且应该很容易成为文档。有了这种心态，您的文档实际上可以快速增长。您只需要让人们记住，有用的信息最好以适合 wiki 包含的方式提供。
我亲眼目睹了几个开源项目开始在某种程度上使用这种方法的例子，虽然有些人（主要是新用户）抱怨答案不是很个人化，但文档的主体却在稳步增加，因为其他人只是监视此类讨论并开始将此类回复复制/粘贴到维基百科。
基本上，这是让人们为维基做出贡献的最简单方法之一，不需要他们自己实际使用它，唯一需要他们的是思维的转变。
如果开发人员仍然需要维护“真实”文档（s.a.Word 文档），我认为没有办法在 Wiki 上有意义地复制它。
- 人们写两次是没有意义的
- 任何重复的数据很快就会变得不同步。
我当前的客户所做的就是将所有这些移至 Wiki。所以我只记录一次，然后就这么做 在 维基百科。
这没关系。使用 Wiki 比使用 Word 更乏味，但至少文档是在线的，其他人可以与它混合搭配。
另一个可行的解决方案（恕我直言）是在颠覆时将文档与源代码一起存储。但是合并系统需要能够处理富文本等。以及。我不知道是否存在任何解决方案（除了使用 HTML 或 LaTex，这实际上并不是一个糟糕的选择）。
查找“粘性”项目（第 3 页以下）文档/图表/等）团队似乎一次又一次创建的东西并将其发布在维基上。确保每个人都可以访问 wiki 并知道它在那里 - 如果可能的话，设置通知机制。运气好的话，下次他们必须访问时，他们应该访问 wiki，而不是从版本控制或他们的机器中挖掘它。如果他们仍然不这样做，请尝试看看团队是否有足够的余裕来实际使用 wiki - 更微妙的问题可能隐藏在他们的不情愿之下。
查看以下建议 http://www.ikiw.org/ 发展你的维基
只是为了补充这里提供的一些优秀建议......
作为一家小公司的开发人员，该公司主要负责 6-24 个月范围内的政府合同工作，我发现我的时间经常分散在开发和编写状态报告之间（就在那里编写文档，甚至更糟！）一个维基百科可以让我们在进行过程中记下杂乱无章的想法和笔记，这使得撰写报告变得不那么痛苦（不是更少痛苦，但仍然更好）。
此外，如果您已经进入 Mediawiki 世界，您可能想看看 语义媒体维基. 。它允许您通过语义标记将数据组织提升到另一个级别。我知道，这本身并没有多大意义，但我可以告诉您（例如），它可以极大地提高搜索返回的数据的相关性。这绝对值得一看。
