还在加班吗?记得吃晚饭哦!

编程开发

关于基于极狐 GitLab 的知识库探索思路

2022年09月30日 15:30:32 · 本文共 859 字阅读时间约 3分钟 · 1,218 次浏览
关于基于极狐 GitLab 的知识库探索思路

本文是探索阶段,并未实施,仅供思路参考。

我司一直有个头疼的问题,公司庞大人员混杂,知识分散,往往会造成同一个东西多个团队在多个项目上开发多个应用,比如工作流程引擎,我司就有三套,功能基本差不多,但是被多个团队在多个项目上各自开发。

根本原因还是因为知识与能力都在各个团队、项目组之间独立,没有有效的知识库共享,不仅仅是开发人员,还包括销售、售前等角色。

我们需要知识库做什么

技术上的知识就不用说了,程序员写文档和阅读文档都是基本功,但是,一个项目不仅仅是程序员在参与,从开始的销售到后面的售前方案设计,项目之间都是独立的,没有形成知识共享,很多时候销售或售前工程师看到新出了某个标准规范,想要分享,你让他上 GitLab 上写 Wiki?基本不可能。或者你让程序员天天关注某某云文档?基本也不可能。

他们想要什么样的知识库

  • 销售和售前:希望能通过简单的方式,比如发一封邮件就将自己的所见所得分享到知识库中,并不想写 Markdown 文档。
  • 程序员:想通过 Markdown 格式分享文档、代码片段、案例
  • 所有人:想有搜索功能,最好智能一些,别只搜索标题


基于极狐 GitLab 怎么样

首先,极狐 GitLab 可以提供邮件接收能力,通过 service desk 可以将邮件转化为 issue 议题,并可以通过 webhook 通知到我们的程序。

其次,程序在 GitLab 可以自由的编写 Wiki、md文件,更加熟悉的页面和流程。

最后,极狐 GitLab 可以为我们提供较好的搜索功能、完善的API自动化操作。

我的想法

自己写一个程序来接收极狐 GitLab 的 webhook 通知,通过极狐 GitLab API 获取详细的 issue 内容,根据内容的格式,判断是网址链接还是附件,如果是链接就访问获取页面内容,然后自动创建 Wiki 或者在 repo 中新增新的 md 文件。将来内容多了以后可以生成静态文件进行访问。

如果要搜索内容,基本极狐 GitLab 的搜索能力就够了。


我觉得比较好的案例就是极狐官方自己的 Handbook,但我们为啥不能直接照搬呢?因为极狐的员工基本都会使用 GitLab,而我们要照顾不会使用 GitLab 的其他部门,目前能想到的就是基于 service desk 邮件的分享,其他渠道我暂时没想到,小伙伴们有好点子吗?

商业用途请联系作者获得授权。
版权声明:本文为博主「任霏」原创文章,遵循 CC BY-NC-SA 4.0 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://www.renfei.net/posts/1003535
评论与留言

以下内容均由网友提交发布,版权与真实性无法查证,请自行辨别。

微信搜一搜:任霏博客