这个世界上有很多开源代码,其中有不乏有很多著名的,多读读好的开源代码对自己应该还是益处多多的,然而多数开源代码文档不佳,注释也偏少,读起来还是挺痛苦的。
一份开源代码如果有很多人读,我想是不是可以这样,弄一个开源代码团队分工注释的合作机制:一人读一个模块,理解后加上尽可能详尽的注释,然后合并,大家再读开源代码其他的模块省时省力,发现其他人的注释问题也可以修改,这应该也算是互帮互助吧。然后新手看这份开源代码也能省时省力,当然也可以加上打赏功能,毕竟前人是花了时间的。有了注释的话文档是不是也更写了呢?
如果这可行的话,私以为各种开源代码管理平台最适合来组织这种活动,比如国外的 Github ,国内的 coding 和 osc 的,针对国内程序员的话 Github 可能不会指望了,但是国内的话如果有开源代码管理平台来组织这种事,会不会是一种差异化竞争力呢?
上面说的是开源代码团队注释,下面来说说开源代码翻译。
经常在 V2EX 上看到各种分享开源代码的,但是感觉很多都是重复的事情,比如我所知道的 V2EX 的 iOS 版本就已经有好多个了,还有那个 Gank 什么的,什么一不小心就做出来一个新的版本了,你在逗我😂
可能大部分做这种事的是学生,也许是练手,也许是没有什么新点子没办法。但我就觉得你们还可以做一些其它的事情,比如我最近想到了一个是:代码翻译。所谓代码翻译,以 iOS/Android 为例,就是把 iOS 上有 Android 没有的完整开源项目翻译到 Android 上去,或者反过来把 Android 上面的完整开源项目翻译到 iOS 上去,其它语言也类似。
如果上面的 iOS/Android 代码翻译做了一遍之后,会不会你比较弱的一种语言能力得到了加强呢?现在不是流行全栈吗,这种事情做了一遍之后是不是往全栈之路更推进了一步呢?
只是异想天开,轻拍
1
Jung1e 2016-05-09 12:49:24 +08:00
支持这种好人.
|
2
sutra 2016-05-09 16:55:47 +08:00
商业模式是什么?
|
4
wjh3936 2016-05-09 17:05:03 +08:00
其实重复造轮子大多数都只是在给自己练手而已吧……
关于打赏部分挺赞同的,但是需要考虑到和代码管理平台合作,以及关于打赏分成——总得有作者的份吧?= =这样子的话又得考虑给作者打赏和给某次合并代码的人的打赏,想想挺乱的…… |
7
inmyfree 2016-05-09 17:15:48 +08:00
|
8
specita 2016-05-09 17:16:45 +08:00
可以组织一个,刚在 github 上看到一个源码注释的,不过是 android 的 https://github.com/LittleFriendsGroup/AndroidSdkSourceAnalysis ,
LZ 的意思应该是这种吧 |
9
maddot 2016-05-09 17:18:01 +08:00
采取 stackoverflow 的形式来组织更好,比如遇到某行代码不懂,就对那行代码提出问题,然后就等别人来回答, github 再把这些问题与答案按项目聚集在一起,就成了 github 版的 stackoverflow
|
10
zztt168 2016-05-09 17:20:56 +08:00 via iPhone
楼主创意很好,我觉得做个类似的 wiki 就能够实现注释功能。我觉得是很有意义的事情。
代码翻译可能又是另外一个产品了,可能难度更大一些。 |
11
pheyer OP @specita 能写成文档当然更好啦,有大局观,可以说是注释的副产品。但是它没有把注释的代码集中起来,每个人的文章又都是分散的
|
12
pheyer OP 开源代码团队注释还有一个问题是,如果原始开源代码有更新,那么合并最新的代码时,注释的代码有可能更容易造成冲突
|
13
LMkillme 2016-05-09 17:32:16 +08:00
两三年前,在 V2 这边就看见有人做了个网站做这事,好像叫 codewa ,不过现在好像已经关了
|
14
pheyer OP @LMkillme 原来早就有人想到了啊,我找到了,没关,初衷也是一样,想降低阅读开源代码的难度,不过他的不叫注释,叫批注。 https://www.v2ex.com/t/95902?p=1 , http://codewa.com/。
不过觉得这种还是公开的代码管理平台做这种事比较容易一些,关键是要有人组织才行 |
15
hitmanx 2016-05-09 18:20:27 +08:00
能做成肯定是大功一件,但是感觉烂尾的可能性挺高..
|
16
yangxin0 2016-05-10 09:55:25 +08:00 via iPhone
没得背景的强撸某个源代码只有灰飞烟灭,注不注释都一样
|
17
ManKane 2016-05-10 12:22:50 +08:00
支持 LZ 这种想法,如果开干,我愿意贡献一点绵薄之力!
|
18
DT27 2016-05-10 13:41:16 +08:00
什么时候学习能直接输入大脑里就好了。。。
|
19
innoink 2016-05-11 02:45:22 +08:00
翻译其实是平台移植??
大项目光看注释没啥用,因为设计思路和程序流程肯定和你看注释的流程不一样,有这工夫还不如写个《 xxx 源码剖析》 |