最近有人提“国产”，我也说说我的感受，抛砖引玉

[JohnBull]

开发的项目调研过很多国内厂家的硬件解决方案，用过一些之后，感觉特别明显的是：缺乏工程师文化。

国内厂家的方案其实都很讨人喜欢，“便宜”就不说了，默认的。最鲜明的优点是产品设计强，功能设计通常都能直击要害，装上去就能解决问题。

但是我对他们仍然特别小心、抗拒乃至恐惧，因为他们的弱点也特别明显：
- 没文档，有文档也是 8 年前的。——有问题还特么需要 QQ 群 /微信群里问
- 不开源。——你说一个卖硬件的公司，为什么不愿意把自己产品的 demo 程序开源呢？我其实也明白，一坨屎怎么好意思开源
- 协议设计粗糙（屎一样）。——比如号称干了十多年的单片机通讯的大佬，结果连字节序都不明白
- 做事情不规范。提供一个 so ，竟然要从 stdout 吐调试信息，还关不掉
- 版本控制混乱。——或者说没有版本管理，各种 demo/SDK 的关系连他们自己都搞不清楚，估计是因为核心人员离职了

[zomco]

其实不能太过要求国产硬件厂家有软件开发那种工程师文化

硬件便宜 -> 压缩研发成本 -> 给的待遇低 -> 招的人水平低 -> 缺乏工程师文化

至于为什么硬件便宜，每个人都应该有自己的答案

[JohnBull]

@james122333 抬杠？硬件的东西是人家做得，你怎么自己来？你以为是实现一个 rfc 协议吗？

[Va1n3R]

@gstqc 你们新自由主义者眼里是不是只有发达国家了，发展中的资本主义国家就被你们选择性忽视了是吧

[JohnBull]

大家说来说去都是在聊“文档”，其实那只是一个方面。

而且，扪心自问一下，不用心维护文档而采用 qq/微信群解决问题，真的就能省事吗？

[ql562482472]

我现在就发现文档很重要，比起很多开源组织，我公司的产品就急缺文档

[levelworm]

@wbwm 当然写，而且得写足了。不然过一年自己也看不懂（狗头

[levelworm]

@JohnBull 黑客为了共享也会写清楚的。RTFM ，没有 M 怎么好意思说这句话？

[night98]

@JohnBull 这你就不懂了，你文档写的很好没人搭理会造成公司不缺你的假象，你随便写写老板天天被销售拉群聊找你解决问题自然眼熟度就上去了，升职加薪。我愿称之为特色开发主义

[dfkjgklfdjg]

就一句话，有多少吐槽项目没有文档的人会整理开发需求以及记录需求变更的（ PM 要做的事情干嘛我来做🐶），
还有就是项目组是否有 review 。以我看来大部分人不要说写文档了，函数注解都不一定能够写清楚，还有些人可能连版本锁都不一定有。

不是说大环境怎么样，而是大家自己写的时候都不重视，不管是开发岗还是管理岗，都是别人有文档怎么写那么垃圾，自己没文档就是没时间搞这个东西。多少项目工作交接就是靠的《口口相传》。

[zachgenius]

自打将近十年前集成微信 sdk 以及多年前被阿里各类 sdk 坑的要死要活 (他们有的 sdk 发布出来后各种打广告, 各种推广, 然后你一入局他们就没人维护甚至文档都撤了. 阿里那个 sdk 当时还作为创业时候核心业务调用的 sdk, 阿里不声不响弃坑之后我们花了快一年才迁移完), 我就远离国产项目, 特别是 BATTMD 这些个所谓头部大厂的东西, 非必要不适用. 都已经被他们搞的 PTSD 了.

国产厂商各类软件 SDK, 尤其是那些所谓头部大厂的, 我都默认是 KPI 项目. 哪怕是核心如微信极其支付, 集成过的人都想死. 文档散落在 N 处地方.

以至于现在 github 上找 repo, 看账户名疑似中国的, 以及项目 readme 除了英文之外只支持简体中文的, 我都不跳过.

[guabimian]

国内很多创业公司都是部分核心人员从老东家带出来的程序改改 就要匆忙挣钱了 哪有心思做精细活。同样失去核心人员的公司也是在屎山上堆。用人机制 文化各方面都有关系

[kingjpa]

直击要害，说的没毛病。
补充一点 工时 2k/人 /天的 团队依然是这个吊样，能怪他们收入不高吗 来不及写吗

[iXInbo]

@wbwm 公司没要求，一般都懒得弄；或者自己有个小本子记下关键信息，但是这会主动和公司分享吗。

[cssk]

@mistkafka #40 对对，责任全在打工仔

[zomco]

@JohnBull 其实原理图开源也可以，画 PCB 打样贴片让他自己来

[fukongqi]

我还是会督促团队写文档的，但是只重视英文，因为受众广。写完英文再写中文有点无用功的感觉

[spadger]

顺便吐槽一下“国产”客户，明明资料连接都在网站上明显位置，自己不找或者找不到，非要让别人发给他。
即使有了文档也不看，只会把文档上的问题一个个问，甚至是 FAQ 上的问题。

[Samuel021]

我们公司的产品倒是有写文档的要求，但是发现客户不咋愿意看文档，即使文档写的清清楚楚明明白白了，还是要“提工单，在微信群里问”……

[onice]

主要是项目要赶进度，写文档又不会带来收益。然后就是写了文档，，别人一看就懂了，，不能增加自己在公司的分量。

[sunocean]

归根结底是不尊重人才，加上工作量太大，没有工程师文化。