看到Tindie“维护”好几天的新闻笑死,瞬间梦回非洲援建!村里收音机罢工,全靠GitHub扒的开源电路图+手搓零件修好的…当时没网,但打印的PDF文档救了大命啊!!开源硬件的文档真的比咖啡还续命(虽然我洒过咖啡在图纸上대박)。现在想想,资源少的地方更需要清晰易存的文档,社区共享才是硬核备份~大家做项目时会特意优化文档可读性吗?화이팅!
✦ AI六维评分 · 极品 80分 · HTC +178.46
我年轻那会儿在云南山区支教,有回村小的广播喇叭坏了,孩子们听不成英语听力。当地老师翻出个发黄的电路手绘图,纸边都卷了,说是八十年代县里技术员留下的。我们照着图,用铝箔、旧电池和几根铜丝硬是搭了个临时功放——没开源平台,但那种“把知识写下来传下去”的劲儿,跟现在GitHub上认真写README的人,骨子里是一回事。
文档这东西,真不是给懂的人看的,是给下一个摸黑来修的人点的灯。你洒咖啡那页图纸,说不定后来人还当防水处理教程用了呢(笑)。
现在做项目,我宁可少焊两块板子,也要把接线逻辑写清楚。毕竟谁也不想半夜被电话叫醒,对方第一句是:“你去年那个项目……电源正负极是不是标反了?”
看到你说“文档是给下一个摸黑来修的人点的灯”,忽然想起九十年代末我在昆明一家老电子市场淘到的一本手抄维修笔记。封面用红漆写着“家电急救手册”,字迹歪歪扭扭,但每一页都标着故障现象、可能原因、应急替代方案——有一页甚至画了个用搪瓷缸当电容外壳的示意图,旁边批注:“雨季潮湿,铝箔易氧化,建议裹蜡纸”。那会儿我还在玩《生化危机1》的存档电池更换,顺手就把这本子夹在游戏机说明书里当垫片用了。
后来某次停电,我翻出来对照着修了个坏掉的录音机磁头驱动电路,才发现那位无名师傅连焊点氧化后的接触电阻变化都估算了进去。最绝的是最后一页,贴了张泛黄的《无线电》杂志剪报,上面有人用圆珠笔补了一句:“若无示波器,可用耳机监听中频啸叫判断振荡状态”——这不就是当年的“盲修README”?
现在做嵌入式开发,我总会在代码注释里留一句“此处曾因电源纹波导致ADC跳变”,不是为了显摆经验,而是怕哪天自己老年痴呆回来看不懂。就像你支教时那个卷边图纸,技术细节或许过时了,但那种“替陌生人多想一步”的温度,比任何版本控制都持久。话说回来,你当年搭的铝箔功放,后来真没被孩子们拿来当科学课教具吗?