开源代码团队注释/翻译

2016-05-09 10:27:39 +08:00
 pheyer

这个世界上有很多开源代码,其中有不乏有很多著名的,多读读好的开源代码对自己应该还是益处多多的,然而多数开源代码文档不佳,注释也偏少,读起来还是挺痛苦的。

一份开源代码如果有很多人读,我想是不是可以这样,弄一个开源代码团队分工注释的合作机制:一人读一个模块,理解后加上尽可能详尽的注释,然后合并,大家再读开源代码其他的模块省时省力,发现其他人的注释问题也可以修改,这应该也算是互帮互助吧。然后新手看这份开源代码也能省时省力,当然也可以加上打赏功能,毕竟前人是花了时间的。有了注释的话文档是不是也更写了呢?

如果这可行的话,私以为各种开源代码管理平台最适合来组织这种活动,比如国外的 Github ,国内的 coding 和 osc 的,针对国内程序员的话 Github 可能不会指望了,但是国内的话如果有开源代码管理平台来组织这种事,会不会是一种差异化竞争力呢?

上面说的是开源代码团队注释,下面来说说开源代码翻译。

经常在 V2EX 上看到各种分享开源代码的,但是感觉很多都是重复的事情,比如我所知道的 V2EX 的 iOS 版本就已经有好多个了,还有那个 Gank 什么的,什么一不小心就做出来一个新的版本了,你在逗我😂

可能大部分做这种事的是学生,也许是练手,也许是没有什么新点子没办法。但我就觉得你们还可以做一些其它的事情,比如我最近想到了一个是:代码翻译。所谓代码翻译,以 iOS/Android 为例,就是把 iOS 上有 Android 没有的完整开源项目翻译到 Android 上去,或者反过来把 Android 上面的完整开源项目翻译到 iOS 上去,其它语言也类似。

如果上面的 iOS/Android 代码翻译做了一遍之后,会不会你比较弱的一种语言能力得到了加强呢?现在不是流行全栈吗,这种事情做了一遍之后是不是往全栈之路更推进了一步呢?

只是异想天开,轻拍

3726 次点击
所在节点    分享创造
20 条回复
Jung1e
2016-05-09 12:49:24 +08:00
支持这种好人.
sutra
2016-05-09 16:55:47 +08:00
商业模式是什么?
pheyer
2016-05-09 16:56:59 +08:00
@sutra 我就随便想想,没考虑那么远
wjh3936
2016-05-09 17:05:03 +08:00
其实重复造轮子大多数都只是在给自己练手而已吧……

关于打赏部分挺赞同的,但是需要考虑到和代码管理平台合作,以及关于打赏分成——总得有作者的份吧?= =这样子的话又得考虑给作者打赏和给某次合并代码的人的打赏,想想挺乱的……
pheyer
2016-05-09 17:09:26 +08:00
@wjh3936 是够麻烦的
wjh3936
2016-05-09 17:12:13 +08:00
@pheyer 所以最好的方法还是在注释里面加上作者的支付宝 [逃
inmyfree
2016-05-09 17:15:48 +08:00
specita
2016-05-09 17:16:45 +08:00
可以组织一个,刚在 github 上看到一个源码注释的,不过是 android 的 https://github.com/LittleFriendsGroup/AndroidSdkSourceAnalysis
LZ 的意思应该是这种吧
maddot
2016-05-09 17:18:01 +08:00
采取 stackoverflow 的形式来组织更好,比如遇到某行代码不懂,就对那行代码提出问题,然后就等别人来回答, github 再把这些问题与答案按项目聚集在一起,就成了 github 版的 stackoverflow
zztt168
2016-05-09 17:20:56 +08:00
楼主创意很好,我觉得做个类似的 wiki 就能够实现注释功能。我觉得是很有意义的事情。
代码翻译可能又是另外一个产品了,可能难度更大一些。
pheyer
2016-05-09 17:24:20 +08:00
@specita 能写成文档当然更好啦,有大局观,可以说是注释的副产品。但是它没有把注释的代码集中起来,每个人的文章又都是分散的
pheyer
2016-05-09 17:26:03 +08:00
开源代码团队注释还有一个问题是,如果原始开源代码有更新,那么合并最新的代码时,注释的代码有可能更容易造成冲突
LMkillme
2016-05-09 17:32:16 +08:00
两三年前,在 V2 这边就看见有人做了个网站做这事,好像叫 codewa ,不过现在好像已经关了
pheyer
2016-05-09 17:42:15 +08:00
@LMkillme 原来早就有人想到了啊,我找到了,没关,初衷也是一样,想降低阅读开源代码的难度,不过他的不叫注释,叫批注。 https://www.v2ex.com/t/95902?p=1http://codewa.com/。
不过觉得这种还是公开的代码管理平台做这种事比较容易一些,关键是要有人组织才行
hitmanx
2016-05-09 18:20:27 +08:00
能做成肯定是大功一件,但是感觉烂尾的可能性挺高..
yangxin0
2016-05-10 09:55:25 +08:00
没得背景的强撸某个源代码只有灰飞烟灭,注不注释都一样
ManKane
2016-05-10 12:22:50 +08:00
支持 LZ 这种想法,如果开干,我愿意贡献一点绵薄之力!
DT27
2016-05-10 13:41:16 +08:00
什么时候学习能直接输入大脑里就好了。。。
innoink
2016-05-11 02:45:22 +08:00
翻译其实是平台移植??
大项目光看注释没啥用,因为设计思路和程序流程肯定和你看注释的流程不一样,有这工夫还不如写个《 xxx 源码剖析》
pheyer
2016-05-11 08:54:39 +08:00
@innoink 是平台移植,这个更准确

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/277273

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX