我在一个复杂的应用程序上工作，不同的团队在他们自己的模块上工作，并有一定程度的重叠。不久前，我们设置了一个 Mediawiki 实例，部分是在我的提示下。我很难让人们真正使用它，更不用说贡献了。
我可以看到分享信息的很多好处。它至少可以减少我们重新发明轮子的次数。
wiki 不是很结构化，但我不确定这是否是一个问题，只要您可以搜索您需要的内容。
有什么提示吗？
steevc
问问题
1577 次
13 回答
26
一些技巧：
每当有人通过电子邮件发送真正应该在 wiki 中的信息时，为该主题创建一个页面并添加他们在电子邮件中输入的内容。然后回复“感谢您提供的信息，我已将其放入此处的 wiki，以便将来更容易找到。”
同样，如果您有需要分享的信息应该在 wiki 中，请将其放在那里，然后发送一封带有链接的电子邮件，而不是向他人发送电子邮件。
当您向人们询问信息时，请使用这样的措辞，以便将此类文档放在 wiki 中应被视为默认或标准：“我在 wiki 中搜索但找不到它。您将这些信息放在那里了吗？”
如果您是“wiki 冠军”，请确保其他人知道如何使用它，例如“我与您一起了解如何创建新页面了吗？”
编辑侧边栏以确保它与您的工作相关。
在相关页面上使用“导航框”样式模板，以便于导航。
将 {{Special:NewPages/5}} 之类的内容放在首页或最近的更改中，以便人们可以看到活动。
每隔几天或每周查看一下最近的变化，如果您发现有人在没有被催促的情况下添加信息，请给他们发送电子邮件或顺便拜访并给他们一点赞美。
于 2009-02-23T14:01:58.777 回答
8
正如我之前提到的，Wiki 非常杂乱无章。
但是，如果这是您的开发人员的唯一论点，那么请投入一些精力来创建一个简单的索引页面并保持更新（您自己做或要求人们将他们的贡献链接到索引）。这样一来，Wiki 可能会成长为您所有工作的非常好的和非常全面的文档集合。
于 2008-08-19T08:05:53.623 回答
6
一段时间以来，我们一直在以某种形式使用 wiki，但人们确实需要一段时间才能加入。您可能会发现一段时间内您将是唯一一个写文章的人，但请耐心等待，其他人最终会加入。
如果有人发送包含与项目相关信息的电子邮件，那么有助于将他们指向 wiki 的方向 - 并继续这样做 - 他们应该得到提示。
我们有一个 SharePoint 门户并从那里使用 wiki——我们使用我们自己的品牌对其进行了定制，以便它“看起来很重要”——我真的觉得这有助于提高对它的吸收。
确保每个人都知道 wiki 比电子邮件更加非正式......因为会有一个“恐惧因素”，人们可能认为他们添加到 wiki 的任何内容都会被过度分析。
于 2008-08-19T08:14:09.287 回答
5
我认为到目前为止的大多数答案都是正确的——你自己塞得越多，有用的信息就会变得越多，所以人们会慢慢地但肯定地会自然而然地开始使用它。
您可以使用的另一种方法是：建议每次有人向其他团队成员询问有关该项目的问题时，他们应该正常回答问题，但也应将答案添加到 Wiki 的某个部分。这可能需要多花几分钟时间，但这意味着下次有人问同样的问题（他们不可避免地会问）时，您可以通过将他们指向 Wiki 来节省时间。反过来，这应该有助于人们开始使用 Wiki 作为第一信息来源并帮助整体吸收。
于 2008-08-19T08:21:55.213 回答
4
您不能强迫开发人员做他们没有动机使用的事情；不幸的是，wiki 和文档一样（好吧，实际上 wiki就是文档）对开发人员来说很少有任何“酷”的价值。此外，他们已经深入开发工作——你真的可以用 wiki 来打扰他们吗？
话虽如此，推动 wiki 的人（例如，你）应该主要负责更新它，如果你认真对待它，你真的会有很多工作要做。
你也可以试试 ff：
- 你说的不是很结构化——很多人被结构不良（难以搜索/浏览）的wiki 拒之门外。所以也许你可以先解决这个问题
- 也许您可以要求首席开发人员/项目经理在其中填充对他们来说是问题的东西：诸如代码约定和特定项目的 API 设计之类的东西
- 以身作则：虔诚地记录您的系统部分。开创先例可能会鼓励其他人也这样做
于 2008-08-19T08:08:00.623 回答
3
向开发人员推销使用 wiki 的想法。您已经确定了一些好处，与开发人员分享这些好处。如果他们能看到他们会从中获得一些有价值的东西，他们就会开始使用它。
什么是 Wiki 的示例优势
- 适合写下快速或较长的想法，让您有更多时间进行正式的写作和编辑。
- 即时协作，无需通过电子邮件发送文档，保持群组同步。
- 可通过网络连接从任何地方访问（如果您不介意以网络浏览器文本形式编写）。
- 您的存档，因为每个页面修订都被保留。
- 令人兴奋的、直接的和授权的——每个人都有发言权。
于 2008-08-19T08:00:23.260 回答
2
我做了一些销售，甚至进行了一些培训课程。我认为有些人因缺乏所见即所得的编辑和从 Word 或 Outlook 粘贴格式化文本的能力而被关闭。我知道有一些工具可以解决这些问题，但它们仍然是障碍。
在某些区域，wiki 被用来记录某些区域，但更新这些区域的人并没有用它做任何其他事情。
我将使用 wiki 来记录我的专业领域，因为它可以作为一个方便的大脑扩展。当开始一个新的开发时，我将它用作记事本，以便我可以在开发过程中扩展这些想法。
如果管理层给予它一些声音支持，这将有所帮助，即使它不是强制性的。
于 2008-08-19T08:11:36.700 回答
1
我很难让人们真正使用它，更不用说贡献了。
让人们为 wiki 做出贡献的最简单方法之一是让他们以适合 wiki 的方式提供内容，即，无论他们使用常用的通信渠道（新闻组、邮件列表、论坛、问题跟踪器）发布什么内容，聊天），基本适合收录在wiki上。
这样其他人（用户/志愿者）就可以简单地将这些内容放到维基上。
这听起来比实际上更复杂，它主要是关于概括问题和答案，因此它们不一定是对话的一部分，但可以以独立的方式理解、有意义和有用。
例如像下面这样的问题：
如何让 git 克隆远程存储库？？？
可以这样回答：
你好，只需使用 git clone git://...
但问题也可以以不那么个人化的方式回答：
为了克隆一个 git 仓库，你需要使用 git 的 clone 参数： git clone git://....
我想说的是，项目中的大多数讨论都可以而且应该很容易地最终成为文档。有了这种心态，您的文档实际上可以快速增长。你只需要让人们记住，有用的信息应该以适合 wiki 收录的方式提供。
我目睹了几个开源项目在一定程度上开始使用这种方法的例子，虽然有些人（主要是新用户）抱怨答案不是很个人化，但文档的数量却在稳步增加，因为其他人只是监视这样的讨论和开始将此类响应复制/粘贴到 wiki。
基本上，这是让人们为 wiki 做出贡献的最简单方法之一，不需要他们自己实际使用它，唯一需要他们改变的就是思维方式。
于 2009-06-07T17:27:10.083 回答
1
如果开发人员仍然需要维护“真实”文档（例如 Word 文档），我认为没有办法在 Wiki 上有意义地复制它。
- 人们写两次没有意义
- 任何重复的数据很快就会失去同步。
我当前的客户所做的就是将所有这些都移到 Wiki 上。所以我只记录一次，我在Wiki 上做。
这没关系。使用 Wiki 比使用 Word 更乏味，但至少文档是在线的，其他人可以与它混合搭配。
另一个可行的解决方案（恕我直言）是在颠覆时将文档存储在源代码旁边。但是合并系统还需要能够处理富文本等。我不知道是否存在任何解决方案（除了使用 HTML 或 LaTex，这实际上不会是糟糕的选择）。
于 2009-07-12T17:10:45.980 回答
0
查找团队似乎一次又一次地创建的“粘性”项目（低于 3 页的文档/图表/等）并将其发布在 wiki 上。确保每个人都可以访问 wiki 并且知道它在那里——如果可能的话，设置一个通知机制。运气好的话，下次他们必须访问，而不是从版本控制或他们的机器中挖掘出来 - 他们应该点击 wiki。如果他们仍然不这样做，请尝试查看团队是否有足够的时间来实际使用 wiki - 微妙的问题可能隐藏在他们的不情愿之下。
于 2008-08-19T08:07:09.550 回答
0
查看http://www.ikiw.org/上的建议 发展您的 Wiki
于 2008-10-02T03:08:01.383 回答
0
只是为了补充这里提供的一些极好的建议......
作为一家小型公司的开发人员，该公司在 6 到 24 个月的范围内主要从事非政府合同工作，我发现我的时间经常被分配在开发和编写状态报告之间（就在编写文档时，只会更糟！）一个 wiki 可以在我们进行过程中记录杂乱无章的想法和笔记，这使撰写报告的痛苦减轻了很多（不是没有痛苦，但还是更好）。
此外，如果您已经在 Mediawiki 世界中，您可能想查看SemanticMediawiki。它允许您通过对数据进行语义标记，将数据组织提升到另一个层次。我知道，这本身并不意味着很多，但我可以告诉你（例如），它可以极大地提高搜索返回的数据的相关性。绝对值得一看。
于 2009-02-04T22:14:13.083 回答
0
一般来说，这里有很好的建议。我想补充：
- 你真的需要一个拥护者——有人把它推给开发人员和管理人员（不要咄咄逼人——这是一个挑战！），并尽可能提供支持和教程。此人还需要成为同行（因此是开发人员伙伴，而不是远程 IT 部门中的某个人）并且真正以客户为中心，即准备好在请求时进行更改。
- 说到变化，这里有些人说wiki 是非结构化的。我不同意。我们的 MediaWiki 安装是使用类别构建的，特别是有两个扩展：WarnNoCategories（要求用户在保存页面时添加类别）和CategoryTree显示所有类别如何组合在一起（可以从侧边栏链接到）。如果你有兴趣，我有更多关于我们如何保持这个低门槛的提示。
于 2010-07-03T18:09:49.133 回答