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