观技术部与其他部门互撕有感

[ww940521]

最近不知道是天气太热脾气暴躁还是怎么的，我们部门一直跟其他部门吵架。我发现本质问题还是沟通，我们做完产品变更没有及时传达到其他部门，工作流不完善，文档也不完善。即使写了文档也是零落的，而且很快会随时间被淹没。文档也没人看，有问题还是问。而且有时候答案还不一致。我想着有没有一个软件能做时间流把一个产品的变更记录完整记录而且能实时提示所有成员，且能用最简便的方式使用让所有成员养成使用习惯。做完产品第一时间更新文档，遇到问题先想到查询文档。例如可以像 QQ 一样吸附在桌面，随手就可以打开。不知道大家公司是怎么解决这个问题的。

[levelworm]

流程最终还是落实到人。上面不重视肯定没有用。

[xujinkai]

这种事情得领导重视领导推，而且领导得有办法推得下去。

[blackmirror]

软件是一大堆，文档是没人写，没人看的

[ajaxgoldfish]

上午下午每天抽出几分钟开两个会不用文档也 OK ，而且进度赶的也快

[brader]

这个是产品经理的事情，关我们毛事

[Peakday]

跟我们一样，文档写在多，再详细也没人看，即使有写过的问题记录也还是直接问你

[szdosar]

1.很多人知道，帮人即是帮己；
2.精力有限时，如何分配精力，是门学问，向上帮，得到晋升，向下扶，得到人心；
3.天之道，损有余而补不足，老天帮老实人

[ww940521]

@blackmirror 软件是一大堆，但是不便捷。我们用的企业微信，文档一大堆，写了一丢就不管了，没人维护，自己都找不到想要的文档。要是把文档都写在一个地方能有个快捷的打开方式用的人肯定多。

[ww940521]

@Peakday 让他们挂在桌面上，随时就能看让查看文档的成本远小于沟通成本，以更懒省事的方式击败惰性。

[wetalk]

@ww940521 知识库管理工具，不要用企微或钉钉自带的，很拉，推荐 confluence ，基本满足你的需求

[M003]

流程有问题,发布有问题.
业务方提需求,要有工单.

产品升级完成, 技术写个文档, 完成哪些需求列个表格<带上提工单的人 /工单号>, 技术修复的 bug 单列.

然后通过公司渠道发出去就对了. 别人看不看就是别人的事了.

100 个人提 100 个需求,总不会跟着这 100 个人私聊一下.

广而告之,业务方看产品升级文档也是他们的责任和义务啊,总不能光提需求,不看反馈吧.

应该有很多文档都实现这个功能了.<阿里语雀 /腾讯兔小巢> 这些更新都可以推送到相关人.

养成看到习惯, 当然要跟💰挂钩.倒逼.不然没动力啊.技术没动力写.业务方懒得看...

[ww940521]

@wetalk 已经废弃了，这么复杂的玩意，开发人员都懒得用别说客服了。

[RightHand]

jira 以及各种板这类的？？？

[M003]

@ww940521 战胜惰性是永远不可能的.

看文档要搜索关键词,辨别,过滤. 问技术,直接就得到最终答案多方便.
业务方把<辨别 /过滤>这个流程省略,可能节省不少时间了.

[ww940521]

@M003 真有人不看，看了也会忘记，也没有看文档的习惯，一有问题就吵架，嗓门还特别大，受不了😅

[ww940521]

@M003 关键是小公司技术负责的业务太多，有些自己都忘了，还要技术去查文档。有的时候可能问同事可能不负责这个业务，他也不知道谁负责这个业务。产品甚至也不熟悉。甚至给出错误答案，直接搞出事故。

[ww940521]

@RightHand 看了下，还是太复杂，我想着就只是一个文档，就只有一个层级更直观更简便。

[wentx]

是不是可以把每天的交流，问的一些问题丢给类似 chatGPT 这样的 AI 通过 chatGPT 自动回答过滤一部分

[wangnimabenma]

考了 pmp 几年了感觉没什么卵用，但感觉里面的一些思路还是适合 op 这个问题的。主要是撕逼的时候可以用术语去撕
:-P

[ww940521]

@wentx 可以在文档的基础功能上加入 AIReview 和 AI 学习，想搞一款这样的软件，名字都想好了，准备开干。

[ww940521]

@ajaxgoldfish 开会也是时间成本，开会也要总结落实到文档，不然开会就没意义。

[Hidetodong]

一年前我也有这样的疑问，但是后面想通了。

每一方的核心利益都是用尽量少的精力解决问题，放在业务方的角度，TA 对产品出问题第一时间肯定不会想到自己先做一层过滤，而是把问题路由到对应部门等回调。

中间这层筛选过滤得出答案的过程很难节约，「更新记录」和「业务方具体需要解决的问题」之间还是有很大距离的。

目前想到的是，如果能用文档 AI 助理的说不定能解决，前提是产品文档和更新记录足够完整，不然感觉没啥太大意义，不过这又绕回没人写文档的问题了。

所以无解

[debuggerx]

水平越一般的越爱撕
水平差的一般不敢撕
水平高的直接解决问题懒得撕

[darkengine]

"遇到问题先想到查询文档". -> 这个对人员要求很高。

[caiji11]

将帅无能 累死三军

[veike]

是外包公司吗？

[shwnpol]

其实就是没有时间余裕查看文档了吧，重新规划项目周期安排时间，核算开发成本是需要考虑时间成本的，比如一个项目只给两三天时间跟时间充裕的两种情况，肯定是后者效果更好。盲目赶工结果因为产品质量出严重问题还不如不赶

[ww940521]

@veike 不是

[ww940521]

@darkengine 主要还是习惯吧。

[ww940521]

@Hidetodong 我们的文档写的有但是很分散，接口文档用 swagger ，知识库用 confluence ，小的说明直接用文档，设计用蓝湖，懒得发文档的直接群里 @所有人。最后它们好多都变成了消耗品而不是资产。

[ww940521]

@caiji11 搞技术的再怎么样也没有客服和销售嘴皮子溜吧。

[iblessyou]

一切普遍性问题（不是一两个人出现了）都是领导的问题。
领导都解决不了的就是制度问题。
如果行动的付出和回报不对等，那就独善其身吧

[lambdaq]

沟通问题其实就是管理问题。

[westoy]

吵只是表象， 实质还是部门间分锅、抢话语权、争部门地位、分蛋糕、拉小弟这些的问题

这件事解决了还会借其他的事表现出来的

一团和气是不存在的

[ww940521]

@shwnpol 就是不赶工做完也是摸鱼。

[shaozelin030405]

要是不算工作量，绩效，那就随缘了

[ww940521]

@westoy 好吧，办公室政治，好复杂。

[ww940521]

@shaozelin030405 对哦吵架也算工作量😅

[ww940521]

@lambdaq 我还想着用技术解决一切问题，我太年轻了。

[winglight2016]

部门内部我推了 SOP ，目前运行状况不错，减少了很多沟通问题。跨部门目前用 TAPD 管理需求，强制要求记录所有变更。开会必须有会议纪要。

以上已经是最低要求了，再低那就不是一家有前途、能发展的公司了，趁早换吧。

[ww940521]

@winglight2016 我们公司同样有这些，但是不是很好用。维护和使用成本都太高，信息太分散查找效率低，沟通依然存在断层。如果能用一个平台整合就好了。

[kksyy]

@ww940521 擦，同程的？

[Hancock]

把沟通成本提高, 万事提工单, 加急必须经过 manager, 后面自然会先看文档在提工单.
前提是你们文档是完整准确的

[FrankFang128]

不准问，大家才会写文档。

[mazai]

工具只是载体，本质还是人的问题，没有重视这个事。

[litchinn]

你说的对文档更新要求很高，因为只要有一次出现文档没有及时更新，人们就会觉得文档不如直接问人，显然文档并不总是最新的。

例如 leaderA 先和 DevA 沟通了下，觉得需要改动一个地方，然后 Dev 开始工作并更新文档，这个过程中 leaderA 将消息同步给了 DevB 让他也跟进，这时候 DevB 是看不到文档变更的。

所以我觉得问题就不在用什么文档，而是你需要一个方式将变化通知给所有需要知道的人，要做的是制定一个规则，然后发送邮件

[Blank10030]

扁平式管理说是为了提高工作效率，其实很多时候事情来了就是你推我我推你，最后让老实人背锅。
传统式管理虽然工作效率降低了，但是事情到你这里了你就必须处理。

[ww940521]

@kksyy 不是，只是不知名的小公司。

[ww940521]

@Hancock 有些紧急的问题其他部门还是习惯第一时间找技术，即使这个问题已经有成熟的解决方案也有处理经验，他们就是记不住啊。

[deesan]

“我想着有没有一个软件能做时间流把一个产品的变更记录完整记录而且能实时提示所有成员，且能用最简便的方式使用让所有成员养成使用习惯。”
第一感觉是用 email 解决，email 转发抄送自带无限时间戳；
第二感觉是用支持历史版本的 all in one ，比如 notion ，成本是需要全部换成国外生产力套件，比如设计部把 figma 直接拖进 notion ；

[yufeng0681]

软件质量管理 CMM3 ， 里面有对各阶段交付的文档质量有要求。
敏捷开发也是有文档交付的，而且要求团队成员：业务熟悉，技术水平高。
小公司，这么明显的问题（文档和代码对应不上），不想着遵循质量管理规范，想大力出奇迹。
不过乱糟糟的状况 ，可能对技术部大部分员工有利，公司不敢随意裁员，说不定哪里就埋了一堆的坑

[24Arise]

我以为就我们存在这种问题，没想到大家都有这问题，产品文档产品同事自认为写的都很详细很清晰，step by step

交付或其他部门不看文档一方面是主动性问题，一方面是大家底子和站的角度不同对于文档的需求也不同，其他部门可能更倾向发现问题后能迅速定位解决方案，不想通篇阅读文档

很多时候大家可能仅仅只关心自己负责的那一块

[ww940521]

@deesan 这样不够便捷，容易产生使用疲劳。

[ww940521]

@yufeng0681 问题是你写的文档不仅要对本部门负责，还要供其他部门使用，要考虑其他部门使用的便利性和可读性

[catch]

飞书文档啊

[ww940521]

@24Arise 那就需要 AI 来帮忙了。

[maemolee]

能不能把你们的代码和文档都喂给 AI ，让 AI 代替你们去回复业务部门的问题 hhhh

[lower]

单从解决方案来说，我觉得可以朝产品自文档方向去搞
就是类似一个新游戏刚打开的那种引导，第一步、第二步。。。
各种流程步骤说明、填写提示、校验提示、错误提示再带个帮助链接之类的
当然这是最理想最极致的情况……

[ThreeK]

阿里、腾讯、java 、spring 、python 、github 。。。 各式各样的文档有人去直接看吗，不还是 google 在跳转过去

[ww940521]

@catch 功能是够了，就跟腾讯文档一样便捷度还是不够，查看文档要打开软件再找到文档打开文档查找条目。用完要关掉或者压缩在导航栏。而且还要考虑跨窗口或者分屏操作的不便。更新通知也太不明显。我想他要是能直接像 QQ 或者 360 那样吸附在屏幕边缘，有更新就蹦出来，或者鼠标拖过去就直接悬浮显示全文，关机重启后还在原来位置，文档是后台已经预载好的直接就能查看最新的那多方便。

[ww940521]

@ThreeK 看文档太麻烦了，还是直接 StackOverflow 找解决方案省事😋

[ww940521]

@maemolee 那也首先要有完善的文档做保底。

[johnnyNg]

把文档丢给 chatgpt ，然后弄一个企微机器人，有问题问机器人

[libook]

核心问题不是工具，而是流程和制度，流程负责效率，制度负责保证流程的有效性。

[ww940521]

@lower 那文档不太好写吧。

[janus77]

公司流程制度有问题
别说什么懒得看、懒得更新，要是规定制度，落实责任，会有这种问题？
举例：提 bug 写明白什么原因，什么版本修了，给谁测。如果他不按时测，那是他的问题，绩效扣他的。
重点是最后一句。
不落实到规章制度，谁管你啊

[tianmalj0613]

从敏捷上面讲，文档的更新也是交付物之一，QA 应该对文档的正确性进行及时的验证。但是这样 对研发和测试的要求都很高，所以还是制度和流程的问题

[maemolee]

@ww940521 是的，有了文档之后，就是解决业务部门不喜欢看文档的问题，让他们找机器人客服呗。

[yufeng0681]

@ww940521 #54
你首次提的问题是：文档不一致，没人看，还是问人
你扩展说的问题是：文档自己部门人看，外面部门看，还要可读性
这不是一个问题，解决方案也不一样。
研发部门，需求文档，（详细）设计文档，接口文档，都是研发各岗位对齐用的，保证不做错
其他部门，要看你们的产品使用文档 /安装文档 /特性文档，最多再看看需求文档，里面有功能实现的详细描述（比特性文档还要详细）。 其他部门要看你的设计文档干啥？他也要研发？

小软件公司发展不起来，有大部分时候都是对质量要求低，不愿意为质量投入时间。 吵架只能浪费时间，无法形成合力。 有权力的领导不懂质量管理，也就不会把活分派到螺丝钉，算入绩效考核。
螺丝钉也不可能负重前行，毕竟就是个赚生活费的工作而已。。

[wolfie]

长期问题，那就是管理不行。

产品变更历史，拿一个 word 都能搞定，问题不在管理工具。

信息同步最容易出现的问题是，文章写太烂 而且内容无用太多，导致正经内容别人也不看。

[ww940521]

@yufeng0681 好吧，我以为你讲的也是产品文档。

[mosfet]

重要的是流程的落实执行，一个 excel 都够用
不然工具再高级，流程再专业，都是白搭

[zengzizhao]

你们的企业微信和 TAPD 结合就可以了，文档和需求的变更有记录，发生变更时可以推送到企业微信

[312ybj]

企业微信真的垃圾，垃圾中的垃圾。 不如用飞书，文档跟流程都能结合到一起， 知识库也有。 像之前的知识库太割裂了，更新都没人知道

[ily433664]

关键是得执行，如果没有人来推动落实，就算给你一百个软件也没用

[Duolaimon]

可以为每个产品都单独拉一个产品服务群，所有产品更新都在这个群里发公告周知、同步，答疑也在群里进行，我感觉这样基本上就够用了，问题多的话也可以每周安排个值班人专门处理。

[SekiBetu]

钉钉，OA 审批

[GuLuDaDuiZhang]

文档简单搜一下搜不到就直接找人问这样还快。

尽管 wiki 之类的文档工具有一堆，里面文档其实不少勉强算是用起来了，但还得看人，我们的文档都是时效性差、内容不详细、结构混乱，写过文档的应该知道写文档也是不小的工作量，所以基本上第一版出来后，后续就没人维护了，连需求单也是这样，最后都得靠问，靠口口相传。特别是那些历史遗留问题基本得靠研发上去看代码和提交记录来查是什么情况。

[fds]

所以吧，还是得等待技术进步。等哪一天 AI 发展完善，文档就是软件本身，哪里不明白还能直接问 AI 。

[tanranran]

明显是管理问题

[ma2258006]

文档想要写的易于理解其实很难，随着产品迭代不断迭代文档更难，可能 99.9% 的中型以上团队都做不到这一点。而且对于文档，最常见的场景有两种，一类是前人写给后人看，另一类是一个部门的人写给另一个部门的人看，总之都不是给老板看。这就跟做产品写代码很像，产品的真实用户体验，与文档的读者体验，在大多数老板那里，都没办法被准确计量。所以大多数“智者”，写文档时，就都不会在意那些细节了。

[otakustay]

未来就是文档随便写，别管目录结构，写完全部 embedding 进 AI ，文档入口永远是问 AI 问题，不存在单独找一篇出来看的情况

[sujin190]

既没人认真写，写了也不会有人认真看，这才是现实

[huzhizhao]

得领导推的，用什么倒是无所谓

[RyougiShiki]

产品经理、老板、技术领导，这几位的水平，决定下面一帮程序员工作强度上下浮动两倍以上。

[AyaseEri]

淘宝客服也很纳闷，说明都写在商品详情里了，还是会有人问。
厂商也很纳闷，说明书都给你了，怎么安装都写在里面了，怎么还是有人找客服。

[niceyuri]

文档写的再多没人看也没用。我最近在做这个这种小项目，用 chatgpt 作为智能客服，然后用文档训练它们，再给业务人员用……试试这样能否解决问题。