V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member Sign In
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 4504 days ago, the information mentioned may be changed or developed.
CodeWa（ http://codewa.com ）是我2013年的个人任务之一，很幸运能够在2013年年底之前完成，目前自己试跑了一段时间，也算是最简可用版本出炉。
CodeWa的口号是：“读懂每一行代码！”，这个口号其实来自一个比较无奈的现实。这个现实就是，我们身为程序员，用代码混饭吃，但是很多人每天都只在机械地coding，能够主动去读优秀代码的人其实非常之少。就我身边的朋友来说，每天和各种开源软件打着交道，但是对WebServer的运作、HTTP协议的实现、数据库缓存的内部实现等等完全没有概念，而了解这些最方便有效系统的方法，莫过于读源码。
为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”。那如果我们能够做一些事，让读源码的难度降低下来，是不是会有更多人愿意去读优秀的源码，提高自己的水平呢？我想这个答案是肯定的。
于是有了CodeWa，在CodeWa，每个人都可以对每一行代码添加自己的批注，每一个人也可以看到其他人添加的批注，当你看不懂一段代码时，其他人的批注没准就能够帮你理解。经过时间的沉淀，可能对每一行代码，我们都能积累很多不同角度的优秀批注，帮助新加入的朋友更容易的进行学习。
CodeWa现在还很简陋，但是让他运作起来的核心功能已经有了，现在，就等你加入了。
http://codewa.com
CodeWa的口号是：“读懂每一行代码！”，这个口号其实来自一个比较无奈的现实。这个现实就是，我们身为程序员，用代码混饭吃，但是很多人每天都只在机械地coding，能够主动去读优秀代码的人其实非常之少。就我身边的朋友来说，每天和各种开源软件打着交道，但是对WebServer的运作、HTTP协议的实现、数据库缓存的内部实现等等完全没有概念，而了解这些最方便有效系统的方法，莫过于读源码。
为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”。那如果我们能够做一些事，让读源码的难度降低下来，是不是会有更多人愿意去读优秀的源码，提高自己的水平呢？我想这个答案是肯定的。
于是有了CodeWa，在CodeWa，每个人都可以对每一行代码添加自己的批注，每一个人也可以看到其他人添加的批注，当你看不懂一段代码时，其他人的批注没准就能够帮你理解。经过时间的沉淀，可能对每一行代码，我们都能积累很多不同角度的优秀批注，帮助新加入的朋友更容易的进行学习。
CodeWa现在还很简陋，但是让他运作起来的核心功能已经有了，现在，就等你加入了。
http://codewa.com
Supplement 1 · Jan 15, 2014
更新一下近期工作：
firefox无法滚动的问题解决
firefox行号对内容错位问题解决
添加修改昵称功能，避免暴露邮箱地址的隐私
添加helloworld沙盘演练项目，方便大家试用CodeWa
及一系列内部改造
同时完成了个人的Nginx源码阅读计划的一小部分，对Nginx内存池管理部分源码进行了较完整的批注。见：http://v2ex.com/t/97180
firefox无法滚动的问题解决
firefox行号对内容错位问题解决
添加修改昵称功能，避免暴露邮箱地址的隐私
添加helloworld沙盘演练项目，方便大家试用CodeWa
及一系列内部改造
同时完成了个人的Nginx源码阅读计划的一小部分，对Nginx内存池管理部分源码进行了较完整的批注。见：http://v2ex.com/t/97180
 |
1
ilingbar Jan 6, 2014
加入。。。。
|
 |
2
dimpurr Jan 6, 2014 via Android
构思挺好的，就是要让用户有心去贡献批注这点很难啊 …… 没有考虑到这方面的激励机制么
|
 |
3
iammutex OP @dimpurr
嗯，实话说，能在知名的开源项目的源码库上，留下自己的一点注解，能够帮到其他读源码的人，就我个人而言，这应该就算是一种激励了。希望不是太过理想化 ：） |
 |
4
xuanjianfeng Jan 6, 2014
创意很好。大家贡献对代码的理解。
|
 |
5
dongbeta Jan 6, 2014
版本升级怎么办？
|
 |
6
stupil Jan 6, 2014  1
该相册会员已进行防盗链。
|
 |
7
zzNucker Jan 6, 2014
这个想法挺好啊。
|
 |
8
bengol Jan 6, 2014
great idea :)
|
 |
9
isayme Jan 6, 2014
来个lua？
|
 |
10
zenozeng Jan 6, 2014
很有趣
|
|
11
iammutex OP @dongbeta 版本升级这个问题是我最早想过的，我觉得，读源码的过程更多的是在学习，从中学到编程的思想和知识就够了，并不一定要跟进每个版本。相信你精通一个版本后应该能够很容易就读懂跟进的内容，CodeWa目前能帮助到这里已经很满足了。
|
 |
12
yangff Jan 6, 2014 2
「际上归结到一个字上，就是“难”。」
拉到吧，其实是“懒”。 |
 |
13
PotatoBrother Jan 6, 2014
想法很不错啊，支持ing
|
|
14
iammutex OP @isayme lua是我2013年的读码计划之一，可惜没有达成，下一个确实可能是lua。
一个webserver（Nginx），一个存储产品（Redis），一门语言（Lua），都是最优秀的开源项目，好像是一个很好的开始。 |
 |
15
lsmgeb89 Jan 6, 2014
以前有过相同的想法，试了下，Firefox 怎么页面都滚动不了啊！
|
|
16
iammutex OP |
 |
17
sapjax Jan 6, 2014 1
想法不错，以前的《django book》也是这种标注的形式，不过是教程，不是源码 http://djangobook.py3k.cn/2.0/chapter03/
|
 |
19
lazygunner Jan 6, 2014
不错 用了一下 挺方便
|
 |
20
jandan Jan 6, 2014
很不错啊 试试
|
 |
21
hhrmatata Jan 6, 2014 via Android
想法挺好，很纳闷为什么github不开发这种功能。对于github的追赶着来说，确实一个好特性。
|
 |
23
yetone Jan 6, 2014
很不错，支持！
|
 |
24
mahone3297 Jan 6, 2014
很赞！不过好像每行代码都注释的话，有些地方有感觉 有点累赘（可能说的不太准确，应该说是粒度问题）。
|
 |
26
lsj5031 Jan 6, 2014
开源吗，一直想知道类似django books 那样的侧边批注怎么实现的，自己想过几个思路都太繁琐了……
|
|
27
iammutex OP @mahone3297 是的，粒度问题确实开始感觉别扭。比如我们想注释的可能是一个函数或者一个类或者一个数据结构。但是这里只能在一行。开始我也苦恼过。
但是换一种方式想，我们在代码里加注释，其实也是选择在某两行之间写下若干说明，我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式，可以是一个函数调用，可以是一个函数定义的开头，可以是一个类定义的开头。 |
 |
29
blueandhack Jan 6, 2014
 防盗链是？ |
 |
30
ultragtx Jan 6, 2014
不错 支持一下
PS. 为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难” 不是"懒"么 |
|
31
iammutex OP @blueandhack 额，貌似是又拍的问题，我尽快解决。感谢提醒！
|
 |
33
Mcatt Jan 6, 2014
很赞的想法！
|
 |
34
Tankpt Jan 6, 2014
必须一个个开始读么？里面的库有哪些呢
|
|
35
hhrmatata Jan 6, 2014
建议提供api,方便开发第三方的编辑器插件。感觉还是用编辑器阅读比较舒服。
|
 |
36
MingZhe Jan 6, 2014
已经绑定进来。。。水平有限，还不敢乱写
|
|
37
hhrmatata Jan 6, 2014
怎么样申请增加开源项目？
|
 |
39
allan888 Jan 6, 2014
踢偏全部挂了，防盗链
|
 |
41
ceclinux Jan 6, 2014
好东西啊，支持~
|
|
42
iammutex OP |
 |
43
timothyye Jan 6, 2014 via Android
不错的创意，就是貌似图床有问题，满页的防盗链
|
 |
44
cute Jan 6, 2014
不错的想法。
|
 |
45
2exco Jan 6, 2014
有创新，加油！
|
|
46
iammutex OP @timothyye
@allan888 @blueandhack 不好意思，是用了又拍的付费图片服务，好像某些地区CDN的图片防盗链规则没有更新，已经联系他们解决。并先将图片放到自己本机先提供服务了。 |
 |
47
fdsfsdfsdf3334 Jan 6, 2014
为什么没有python方面的 另外， 注册了个帐户，为什么用户名 显示的直接是 我的邮箱前缀 还有隐私可言吗
|
|
48
iammutex OP @fdsfsdfsdf3334
python方面的暂时没有。 昵称这个确实抱歉，直接用了邮箱前缀，是有一定隐私问题。 现在CodeWa还比较简陋，不仅昵称设置功能，很多功能都还没有，会尽快考虑大家的各种需求进行迭代。 |
|
49
PotatoBrother Jan 6, 2014 via iPad
希望加入tornado的源码啊
|
 |
50
ChiangDi Jan 6, 2014
好东东～～
|
 |
51
cbsw Jan 6, 2014
LZ能把代码开源出来不，你一个人要实现大家提出的要求貌似太困难了吧，比如Firefox的不兼容问题，开源出来相信大家很快会帮助解决的
|
|
52
mahone3297 Jan 6, 2014
@iammutex 但是换一种方式想，我们在代码里加注释，其实也是选择在某两行之间写下若干说明，我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式，可以是一个函数调用，可以是一个函数定义的开头，可以是一个类定义的开头。
嗯，你这样说也有点道理。但是可能展现形式要稍微考虑下。不是每次点一行，出来一个注释。 可能不点，把每行注释直接显示出来，不需要多点一下，可能这样的形式会比较好。 ps：看到你说你好像用的时又拍云。你时付费的吗？还是多少量以内时免费的？ |
|
53
iammutex OP @mahone3297
也纠结过不用点就出来的模式，最后放弃的原因是，还是希望能够尽量读，读不明白再点注释看。这样可能能学到更多东西？毕竟我们读的是代码，而不是注释，就像那种英文下面就是中文的文章，很难真的学到英文。当然，这个可以再等实践检验一下：） 又拍是付费的，我当时做 NoSQLFan.COM 时买的～我用量不大，一直都没用完。 |
|
54
iammutex OP @fdsfsdfsdf3334
已经添加一个简陋的修改昵称功能，隐私问题确实是大问题。有需要的同学可以点CodeWa导航栏上的“设置”去修改昵称。 |
 |
56
maddot Jan 7, 2014
有意思，为什么不走国际路线做成英文的呢
|
 |
57
shellcodecow Jan 7, 2014
代码考虑开源不？
|
 |
58
SR1 Jan 7, 2014
 很不错的想法，支持楼主～ 挑个文字上小错误，见上图 |
 |
59
xigua1 Jan 7, 2014
牛逼！！ 很给力
|
|
60
lsj5031 Jan 7, 2014
@iammutex
哦……这我想过的，不过觉得粒度不太灵活的…… 我是想把这样的形式做进博客里…… 但是如果这么弄不管批注是按行走还是按段走都很麻烦…… 第一文章要打散之后存储，然后万一修改一下也很有可能伤筋动骨…… |
 |
61
bakac Jan 7, 2014 via iPad
ios不能滚动代码
|
 |
62
yolio2003 Jan 7, 2014
太棒了, lua +1 支持
|
|
64
iammutex OP @bakac iPad可能还考虑一下兼容性，iPhone真心还没想到好的信息组织方法，就算样式功能上按PC版兼容了其实也是不可用。想到好的组织方法再考虑动手：）
|
 |
65
shizhz Jan 7, 2014
太好了，我给自己2014年的目标就是认真读代码，以前总是抱着书看，最近发现自己的动手能力真的很差，其中没有读过优秀代码也是主要的原因之一。我主要做java开发想从spring开始读，比较低端不知道有没有童鞋有兴趣:(
很希望参与楼主这个计划。 |
 |
66
allenforrest Jan 7, 2014
Safari 支持的很好：
1、如果能选择一段代码做 comment 就更好了。 2、如果有一个顶部或侧边的导航，能一眼看到当前代码文件有多少注释点了，并且能快捷移动到每一个注释点，就更好了。 |
 |
67
book118 Jan 7, 2014
想法不错，要是网站做得好，稳定，就有发展。I think
|
 |
69
ygmpkk Jan 7, 2014
这个很好，我以前有这方面的想法，做这样一个东西。强烈支持
|
 |
70
linuxer Jan 7, 2014
支持一个，就是Firefox用不了。
|
|
71
iammutex OP @allenforrest 谢谢建议
按段做批注不易于查看方式的统一，目前还没有想到好的做法，在代码块开始的位置来写可能更容易让人理解一点 第二点，能告诉我一下你为什么会有这种需求吗？在我看来批注点是一个附属信息，主体还是对源码的阅读。现在在读到有批注的行，行号的颜色会更深一点作为标识，不知道这个是否满足你的需求。 |
|
72
iammutex OP @bakac 其实现在就是这样的，有批注的行，行号会加深。不过现在批注还很少，大家可能没看到。
另外，文件列表中，文件名后面的数字就标识此文件有多少批注，可以找个批注多的文件点进去感受一下。 |
 |
74
v2ex_user001 Jan 7, 2014
很不错的想法。不知道LZ是怎么解决版本升级的问题，到时候行号对不上之前的批注是不是都对不上了？
|
 |
75
jingwentian Jan 7, 2014
很赞的创意, 其实早就有类似的想法...
|
 |
76
sqbing Jan 7, 2014
确实不错
|
|
77
iammutex OP @v2ex_user001 版本升级这个请看11楼的回复～
|
 |
78
suckli Jan 7, 2014
能够跳转函数或变量就更好了
|
|
79
mahone3297 Jan 7, 2014
@iammutex 嗯，说的也有点道理。
nosqlfan居然是你做的？。。。赞！关注你。。。 |
 |
80
carlhan Jan 7, 2014
想法太棒了。。。
|
 |
81
ibillxia Jan 7, 2014
idea不错，不过目前的设计和实现的功能缺失还太naive了，继续加油！
|
 |
82
yayanet Jan 7, 2014
赞啊！！太棒了
|
 |
83
collar Jan 7, 2014
Coooooool！！！！！
提个小建议，对每个地方得注释可以做成帖子的形式，方便讨论，也能方便引入用户积分等机制 |
|
85
iammutex OP |
 |
86
chinvo Jan 7, 2014
不讓改用戶昵稱是怎麽樣……提示“用戶名只能是……”
|
|
88
chinvo Jan 7, 2014
好吧……只是不讓用數字作開頭而已。。。
提個小建議，關於“帖子形式”，我個人感覺可以直接做成嵌套評論的形式，只展示某幾條，其餘就要點“more”來看。 |
 |
89
qiongqi Jan 7, 2014
赞！
|
 |
90
nesuk Jan 7, 2014
出发点很赞！朴素的实现也很好！
|
 |
91
banxi1988 Jan 7, 2014
我之前也有这个想法来着,哈哈,被你实现了.支持,已经加入.
同名gmail |
 |
93
imbahom Jan 7, 2014
支持，lua+1
|
 |
94
ariestiger Jan 7, 2014
以前读spring源码的时候有过相似的想法，不过没去做，哎！
对了，这里面似乎没法自己添加代码，如果能以指定maven artifact，或者github地址方式来添加代码，那就挺好了 |
 |
95
darasion Jan 7, 2014
赞，不明觉厉。
|
 |
96
flydream Jan 7, 2014
创意不错，赞一个
|
 |
97
teddy1004 Jan 7, 2014
赞，很好的东西！
|
 |
98
chenyg32 Jan 7, 2014
@yangff 懒是天性。如果能降低学习的难度，那自然是好的。能够用最懒的方式学到相同的东西，那我愿意。有时候一些东西学起来太难，其实就是教材不好或基础不够，倒不是懒不懒的问题。
|
 |
99
Numbcoder Jan 7, 2014
Good idea！
支持！ |
 |
100
pirex Jan 7, 2014
我还以为是让机器来解读代码。。
|
Select Language