CodeWa - 读懂每一行代码！

[iammutex]

CodeWa（ http://codewa.com ）是我2013年的个人任务之一，很幸运能够在2013年年底之前完成，目前自己试跑了一段时间，也算是最简可用版本出炉。

CodeWa的口号是：“读懂每一行代码！”，这个口号其实来自一个比较无奈的现实。这个现实就是，我们身为程序员，用代码混饭吃，但是很多人每天都只在机械地coding，能够主动去读优秀代码的人其实非常之少。就我身边的朋友来说，每天和各种开源软件打着交道，但是对WebServer的运作、HTTP协议的实现、数据库缓存的内部实现等等完全没有概念，而了解这些最方便有效系统的方法，莫过于读源码。

为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”。那如果我们能够做一些事，让读源码的难度降低下来，是不是会有更多人愿意去读优秀的源码，提高自己的水平呢？我想这个答案是肯定的。

于是有了CodeWa，在CodeWa，每个人都可以对每一行代码添加自己的批注，每一个人也可以看到其他人添加的批注，当你看不懂一段代码时，其他人的批注没准就能够帮你理解。经过时间的沉淀，可能对每一行代码，我们都能积累很多不同角度的优秀批注，帮助新加入的朋友更容易的进行学习。

CodeWa现在还很简陋，但是让他运作起来的核心功能已经有了，现在，就等你加入了。

http://codewa.com

[hhrmatata]

想法挺好，很纳闷为什么github不开发这种功能。对于github的追赶着来说，确实一个好特性。

[iammutex]

@hhrmatata
希望通过CodeWa能有更多人有能力读源码，喜欢上读源码，学到更多东西，到github做更大的贡献。

[yetone]

很不错，支持！

[mahone3297]

很赞！不过好像每行代码都注释的话，有些地方有感觉 有点累赘（可能说的不太准确，应该说是粒度问题）。

[Jat001]

@hhrmatata github 有这功能，只不过只能在 commit 中评论。

[lsj5031]

开源吗，一直想知道类似django books 那样的侧边批注怎么实现的，自己想过几个思路都太繁琐了……

[iammutex]

@mahone3297 是的，粒度问题确实开始感觉别扭。比如我们想注释的可能是一个函数或者一个类或者一个数据结构。但是这里只能在一行。开始我也苦恼过。
但是换一种方式想，我们在代码里加注释，其实也是选择在某两行之间写下若干说明，我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式，可以是一个函数调用，可以是一个函数定义的开头，可以是一个类定义的开头。

[iammutex]

@lsj5031 前端的东西看看源码就能看明白了吧。后端的东西貌似也很简单，存一下每一行加的批注就好了。

[blueandhack]

防盗链是？

[ultragtx]

不错 支持一下

PS. 为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”

不是"懒"么

[iammutex]

@blueandhack 额，貌似是又拍的问题，我尽快解决。感谢提醒！

[iammutex]

@ultragtx
@yangff
好吧，希望能帮懒人勤快起来。

[Mcatt]

很赞的想法！

[Tankpt]

必须一个个开始读么？里面的库有哪些呢

[hhrmatata]

建议提供api,方便开发第三方的编辑器插件。感觉还是用编辑器阅读比较舒服。

[MingZhe]

已经绑定进来。。。水平有限，还不敢乱写

[hhrmatata]

怎么样申请增加开源项目？

[iammutex]

@Tankpt
目前只放开了Nginx和Redis的两份源码，后续上多了会放更多上去。也会考虑让大家自己上传的方式。但目前，确实只有这两个。

[allan888]

踢偏全部挂了，防盗链

[allan888]

@allan888 “图片”全挂了，打错