热门：

关于文档：让开发人员使用维基

2023-04-12 12:02:00

关于文档：让开发人员使用维基

Getting developers to use a wiki

我在一个复杂的应用程序上工作，其中不同的团队在各自的模块上有一定程度的重叠。前一段时间，我们在部分提示下设置了一个Mediawiki实例。我很难让人们真正使用它，更不用说贡献了。

我看到分享信息有很多好处。这至少可以减少我们重新发明轮子的时间。

Wiki的结构不是很好，但是我不确定这是一个问题，只要您可以搜索所需的内容即可。

有任何提示吗？

n

正如我之前提到的，Wiki非常无组织。

但是，如果这是开发人员的唯一论点，请投入一些精力来创建一个简单的索引页并保持其更新(可以自己完成，也可以要求人们将他们的贡献链接到索引)。这样，Wiki可能会成长为非常不错且非常全面的文档集，可用于您的所有工作。

n

n

n

向开发人员介绍使用Wiki的想法。您已经确定了一些好处，并与开发人员分享了这些好处。如果他们看到他们将从中获得一些有价值的东西，那么他们将开始使用它。

"什么是维基"的示例优势

  • 非常适合记下快速的想法或更长的想法，使您有更多时间进行正式的写作和编辑。
  • 立即协作，无需通过电子邮件发送文档，从而使组保持同步。
  • 可通过Web连接从任何地方访问(如果您不介意以Web浏览器文本形式编写)。
  • 您的归档文件，因为每个页面的修订版本都会保留。
  • 令人兴奋，直接和授权-每个人都有发言权。
n

n

n

n

n

n

找到"粘性"项目(低于3页的文档/图表/等)，这似乎是团队一次又一次地创建的
开发人员文档应用程序重叠

推荐阅读