V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
cxp
V2EX  ›  问与答

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

  •  
  •   cxp · 2021-10-20 19:17:21 +08:00 · 1551 次点击
    这是一个创建于 1138 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

    7 条回复    2021-10-21 13:40:18 +08:00
    sickoo
        1
    sickoo  
       2021-10-20 19:20:55 +08:00 via iPhone
    你好嵌入式老哥,会 modbus 吗?今天遇到这个挺头疼,没法下手,一个温感变送器接 ttl 转 rs485,之后 怎么 modbus 到 arduino 的板子?
    cxp
        2
    cxp  
    OP
       2021-10-20 19:29:26 +08:00
    @sickoo 这个不是很清楚哎
    cxp
        3
    cxp  
    OP
       2021-10-20 19:31:34 +08:00
    本来现在的整理倾向于海思 SDK 的文件整理,代码对比用的是自建的 gitlab
    Android2MCU
        4
    Android2MCU  
       2021-10-20 20:03:26 +08:00
    同事用的为知笔记,自己的记录都写在上面,忘记了就往上面一搜就有了。至于 data sheet 这些文件云盘保存,在笔记软件记个索引,我觉得就 OK 了吧
    xylophone21
        5
    xylophone21  
       2021-10-21 10:00:00 +08:00
    》》但是苦于不同平台的不同代码,记录的时候总会产生分支

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

    如果一定要解决,我建议是整理协议这些更稳固的东西,而不是整理 SDK,你正在整理的 SDK,可能就是别人抱怨的 x 山
    如果一定要整理,那就只能忍着,想想你在整理 x 山就好了
    wanniwa
        6
    wanniwa  
       2021-10-21 11:06:16 +08:00
    国外的 notion 和国内的 wolai 和为知是我比较喜欢的
    nicknick
        7
    nicknick  
       2021-10-21 13:40:18 +08:00 via Android
    文件夹+md,任何平台都靠不住。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2709 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 11:25 · PVG 19:25 · LAX 03:25 · JFK 06:25
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.