程序员如何比较规范的整理资料

[cxp]

本人是苦逼的嵌入式程序员，各种硬件 datasheet，各种软件 SDK，包括自己学习记录的一些文章，有时候总会画很多时间去整理这些资料（虽然总感觉自己已经整理得还不错了），但是苦于不同平台的不同代码，记录的时候总会产生分支，但是本来就很多相同之处。于是，问下大家都是怎么管理自己的技术栈资料的。（实际上是在划下水）

[sickoo]

你好嵌入式老哥，会 modbus 吗？今天遇到这个挺头疼，没法下手，一个温感变送器接 ttl 转 rs485，之后 怎么 modbus 到 arduino 的板子？

[cxp]

@sickoo 这个不是很清楚哎

[cxp]

本来现在的整理倾向于海思 SDK 的文件整理，代码对比用的是自建的 gitlab

[Android2MCU]

同事用的为知笔记，自己的记录都写在上面，忘记了就往上面一搜就有了。至于 data sheet 这些文件云盘保存，在笔记软件记个索引，我觉得就 OK 了吧

[xylophone21]

》》但是苦于不同平台的不同代码，记录的时候总会产生分支

这个是你代码没有把相同的流程统一，而是 DRY 了，文档是无从解决的
当然，这不是你的问题，你们公司选择了直接使用 SDK，在上面修改。而不是自己实现 SDK，把硬件差异抽象出来。

如果一定要解决，我建议是整理协议这些更稳固的东西，而不是整理 SDK，你正在整理的 SDK，可能就是别人抱怨的 x 山
如果一定要整理，那就只能忍着，想想你在整理 x 山就好了

[wanniwa]

国外的 notion 和国内的 wolai 和为知是我比较喜欢的

[nicknick]

文件夹+md，任何平台都靠不住。