企业wiki

听说wiki这东西已经是好几年前的东西了,但一直没有用过,只是偶尔享受别人的成果,感觉很特别。公司最近准备开始使用wiki,理由是为了开发人员能更好地交流。讨论到最后,发现wiki其实也是一个知识共享的平台,大家可以把工作中积累的经验或教训在wiki中发表,避免错误的重复发生,同时让好多东西能够更广泛地传播。同时,wiki也可以很好地充当开发文档的角色。这些都是在决定使用wiki之前没想到的。

因为开发团队中各成员的水平参差不齐,通常有经验的员工曾经遇到的问题,犯过的错误,年轻员工也在不断着地重复着。我在Review代码时常常看到一些类似的问题,总是一犯再犯。于是我告诉有经验的员工对比较典型的问题进行总结,用邮件的方式传播,保证每个人都能看到,同时吸取教训或是经验。这样就起到一个知识分享的作用,好的东西总是受人喜爱的。但这也引发了两个问题,一是邮件这种方式决定了写邮件的人不会很注重格式,认为它不是正式的文档,就不会花很多心思让它的内容和结构变得更条理。如果重写再重发,收到邮件的人通常都不会再仔细看了,效果不好。二是新员工无法得到他入职之前我们已经分享过的成果。于是他又再重蹈覆辙,然后花费不少的时间和精力(包括很多人的)去修正。

我也曾经想过制定完整的开发规范,但没有积累到一定程度,这个规范怎么都无法符合我的要求。况且每次更新都只能是个别的员工去做,更新完之后,有没有人去看它也是个问题。这里涉及到不只是员工本身的积极性,也有人性的东西在里面。再怎么强求也没用,所谓勉强没幸福的。

现在决定使用wiki,可以解决不少问题。首先,谁都可以去编辑它,激发了每个人的积极性。既然是我写的,而且还会有很多人看,责任感就出来了。至少不会像邮件一样,三五句就打发了,也不管别人看不看得懂。其次,wiki不像是文档那么枯燥,你不会还没打开就已经失去兴趣。说不定可以得到意外的收获,或是发现有问题的地方,需要你的帮助。wiki是沟通,不是说教,没那么容易让人犯困。第三,我们的文档也可以写在wiki里面,既好维护,又易共享,也容易查找。就我所知,开发文档的维护是一件非常困难的事,常常过了几个版本后,最初的开发文档和需求可能已经找不到了,或者好不容易找到了一些,发现已经老的不能再老,跟现在的情况已经差了好几代。

当然,wiki也有它的缺点,就是难以控制内容的质量。不过我觉得瑕不掩玉,值得一用。

第一次正式使用wiki,先抛出一块砖。过段时间会再总结一下心得,与大家分享。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
当然!我可以为您提供一些 DokuWiki 的基本教程。 DokuWiki 是一个开源的、简单易用的 Wiki 系统,适用于个人、团队和企业使用。它基于纯文本文件存储数据,无需数据库支持,并且具有强大的标记语言和插件系统。 以下是一些基本的 DokuWiki 教程步骤: 1. 安装 DokuWiki: - 前往 DokuWiki 的官方网站(https://www.dokuwiki.org/)下载最新版本。 - 解压下载的文件,并将其部署到您的 Web 服务器上。 - 在浏览器中访问您的 DokuWiki 安装文件夹,按照提示进行安装配置。 2. 创建页面: - 登录到 DokuWiki 后台管理界面。 - 导航到“命名空间”或“页面索引”,找到合适的位置创建您的新页面。 - 点击“创建此页面”或类似的按钮。 - 在编辑器中使用 DokuWiki 的标记语言编写内容,并点击保存。 3. 添加链接: - 在您想要添加链接的页面编辑器中,使用双方括号包裹页面名称来创建一个链接。例如:[[新页面]]。 - 保存并浏览您的页面,链接将自动转换为可点击的链接。 4. 编辑页面: - 登录到 DokuWiki 后台管理界面。 - 导航到要编辑的页面。 - 点击“编辑此页面”或类似的按钮。 - 使用编辑器进行修改,并点击保存。 5. 使用插件: - DokuWiki 有许多可用的插件,可以通过后台管理界面安装和配置。 - 导航到“扩展功能”或“插件管理”,查找并安装您感兴趣的插件。 - 配置插件的设置,并根据需要使用插件提供的功能。 这只是一个基本教程的概述,DokuWiki 有很多更高级的功能和选项,您可以根据自己的需求进一步探索和学习。祝您使用 DokuWiki 的愉快!

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值