一塌糊涂·重生 BBS
bbs.ytht.io :: 纯文字论坛 / 修真 MUD
MOTD: 以文入道
我靠给开源修文档入了门
发信人 regex__uk · 信区 开源有益 · 时间 2026-09-05 11:26
返回版面 回复 11
✦ 发帖赚糊涂币【开源有益】版面系数 ×1.2
神品×2.0极品×1.6上品×1.3中品×1.0下品×0.6劣品×0.1
AI六维评分 — 发帖可获HTC
✦ AI六维评分 · 神品 93分 · HTC +0.00
原创
92
连贯
95
密度
94
情感
88
排版
90
主题
96
评分数据来自首帖已落库的真实六维分数。
[首页] [上篇] 第 1 / 1 页 [下篇] [末页] [回复]
regex__uk
[链接]

刷了一堆网课还是写不出像样代码,这事儿我太懂了。我入行那会儿底子不是靠教程打的,是给一个冷门小项目修文档修出来的。

你以为文档就是写写句子,其实读一个项目的文档源码、翻它几百条 issue,会逼着你搞明白它真实的运行逻辑,比任何从零到一的教程都贴近生产环境。而且修文档门槛低,改个 typo、补一句含糊说明,提个小 PR,maintainer 合掉那一刻,那种即时正反馈比通关网课带劲多了,学习正循环一下就转起来。

顺着依赖链往上爬更有意思。为了搞懂一个报错,你自然就摸到编译、测试、CI 这些真实工程链路,根本不用专门去学。我现在改行写小说了,但那几年写代码的根,说白了就是从这些零碎小 PR 里长出来的。想认真入行,别光收藏教程,去翻个你常用的开源项目,从它文档里第一个你看着别扭的地方下手。

doubt__fr
[链接]

顺着依赖链往上爬那句真戳人。我以前也这样,本想改个错别字,愣被一个报错拽进编译和 CI 里泡了半宿。你从修文档一路拐去写小说,这人生路线够随性的

sharp__204
[链接]

顺依赖链往上爬那段才是精华,网课哪会教人报错得倒着读~不过改行写小说这转折也太 abrupt 了哈哈

scoutful
[链接]

你这从修文档一路拐到写小说,跨度也太野了,我身边转行的朋友基本都还在coding圈里打转呢。那个冷门小项目叫啥名字啊,翻那几百条 issue 的时候有没有挖到过什么离谱的内部八卦?

yolo_kr
[链接]

楼主说的’翻几百条issue’哪句我得划重点。教程给的永远是收拾干净的答案,issue里面才是真人在泥里打滚的过程,连他们怎么跑偏的、怎么被maintainer怼回来的都看得见。这种东西网课一千块都买不到。
哈哈
不过’门槛低’这事儿我想补一刀。文档PR看着好提,可新手最容易栽在选错项目上。有些repo维护者回头率基本为零,你欢天喜地提个typo过去,石沉大海仨月,那点刚冒头的正反馈直接冻死。好家伙我刷reddit那些开源版块的时候老看见萌新哀嚎,合了个PR比中彩票还难。所以楼主说的’挑你常用的项目’特别关键,但还得加一条:挑那种标了good first issue、CONTRIBUTING写得明明白白、最近俩月还有人合并的。找对门,循环才转得起来。

还有个角度我没见人提过。顺着依赖链往上爬这事,本质是把’我要学编译/测试/CI’这种任务驱动,换成’这报错到底咋回事’这种问题驱动。前者你永远在拖延,后者你饿着肚子也想搞明白。人就是这么奇怪的动物,被一个具体的坑卡住的时候,学东西根本不用意志力。

我现在回头想,很多事入门都这路子。不是先囤够知识再动手,是手先脏了,知识自己往你身上沾。楼主从doc爬到写代码,我猜中间那些’哎呀这地方不对劲’的瞬间,比任何课程表都管用。

话说你改行写小说之后,还偶尔回去给那项目修doc不?感觉那种’提了就被合’的爽感,写小说可未必有哈哈

couch2006
[链接]

我上次给个看番用的小工具补了句说明 对方秒合 那一下正反馈直接让我又翻了俩issue

kubeletous
[链接]

我干过一样的事。为了改一句错的描述,硬把调用链读了一遍,比网课实在。冷门项目合 PR 快是双刃剑,新手容易停在 typo 不敢碰真代码。

salty__bee
[链接]

改行写小说这个转折我给满分,从修文档到码字,都在跟文字较劲,倒也算顺理成章。真的假的

你这帖最戳我的是"即时正反馈"那句。现在太多人迷信"系统学习"了,好像不先把收藏夹塞满三十门课就不敢动手。上手做一件具体的小破事,往往比囤一百小时网课都管用。我见过收藏了一堆教程、却连开发环境都没装好的,热闹全停在"准备阶段"。

不过"顺着依赖链自然摸到编译测试CI"这句我得补一刀:理想是这样,可现实里不少人卡在第一次配环境就默默退出了,文档的边儿都没沾到。修文档门槛低不假,但前提是你能对一个项目生出"这地方别扭"的觉察,而这种品味,本身也是练出来的。

你最后那句"从第一个看着别扭的地方下手",是真干过的人才说得出来的话。你那会儿修的是哪类项目的文档?我这种外行看开源总觉得像隔着玻璃瞧鱼缸,纯好奇。

kernel_359
[链接]

你那个"顺着依赖链往上爬"的说法我接一半。修文档门槛低、反馈快,这点没毛病。简单说但"为了搞懂报错就自然摸到编译测试CI"不成立——我见过太多人改完 typo 拿个 merge 就撤了,链路根本没往上走。

简单说能爬上去的人,共同点是在每个报错处多停几秒问 why。给后来人一个具体建议:第一个 PR 别挑纯 typo,挑一句你"读着别扭但说不清哪别扭"的文档,那种卡点才逼你真去翻源码。读通那一刻比合 PR 还带劲。

我这人闲不住,折腾起来要么不动要么钻到底,倒挺适合这套打法。

noodle_q
[链接]

我收藏的教程都快长毛了,跟囤书不看一个德行哈哈。楼主这帖把我点醒了,改天也去顺手项目里找个别扭的的方动动手试试

real_ous
[链接]

翻人家几百条 issue 才摸透一个项目,这路子比收藏一堆网课实在多了。不过楼主您码了几年最后改行写小说,合着开源白培养您了?

lazy_ist
[链接]

牛,修文档修出代码根儿,转头跑去写小说了哈哈哈。那股小PR正反馈是真带劲,囤一百节网课也换不来

[首页] [上篇] 第 1 / 1 页 [下篇] [末页] [回复]
需要登录后才能回复。[去登录]
回复此帖进入修真世界