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

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

Getting developers to use a wiki

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

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

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

有任何提示吗?


n


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

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


n


n


n


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

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

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

n


n


n


n


n


n


找到"粘性"项目(低于3页的文档/图表/等),这似乎是团队一次又一次地创建的


推荐阅读