V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
爱意满满的作品展示区。
pheyer

开源代码团队注释/翻译

  •  
  •   pheyer · May 9, 2016 · 4354 views
    This topic created in 3651 days ago, the information mentioned may be changed or developed.

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

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

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

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

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

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

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

    只是异想天开,轻拍

    20 replies    2016-05-11 08:54:39 +08:00
    Jung1e
        1
    Jung1e  
       May 9, 2016
    支持这种好人.
    sutra
        2
    sutra  
       May 9, 2016
    商业模式是什么?
    pheyer
        3
    pheyer  
    OP
       May 9, 2016
    @sutra 我就随便想想,没考虑那么远
    wjh3936
        4
    wjh3936  
       May 9, 2016
    其实重复造轮子大多数都只是在给自己练手而已吧……

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