开源代码团队注释/翻译

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

这是一个创建于 3147 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

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

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

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

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

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

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

只是异想天开，轻拍

开源

代码

注释

翻译

20 条回复 • 2016-05-11 08:54:39 +08:00

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

android 的 https://github.com/LittleFriendsGroup/AndroidSdkSourceAnalysis
不谢

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 via iPhone

楼主创意很好，我觉得做个类似的 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=1 ， http://codewa.com/。
不过觉得这种还是公开的代码管理平台做这种事比较容易一些，关键是要有人组织才行