CodeWa - 读懂每一行代码!

2014-01-06 20:32:08 +08:00
 iammutex
CodeWa( http://codewa.com )是我2013年的个人任务之一,很幸运能够在2013年年底之前完成,目前自己试跑了一段时间,也算是最简可用版本出炉。

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

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

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

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

http://codewa.com
23265 次点击
所在节点    程序员
158 条回复
hhrmatata
2014-01-06 21:33:28 +08:00
想法挺好,很纳闷为什么github不开发这种功能。对于github的追赶着来说,确实一个好特性。
iammutex
2014-01-06 21:37:15 +08:00
@hhrmatata
希望通过CodeWa能有更多人有能力读源码,喜欢上读源码,学到更多东西,到github做更大的贡献。
yetone
2014-01-06 21:38:20 +08:00
很不错,支持!
mahone3297
2014-01-06 21:43:08 +08:00
很赞!不过好像每行代码都注释的话,有些地方有感觉 有点累赘(可能说的不太准确,应该说是粒度问题)。
Jat001
2014-01-06 21:46:14 +08:00
@hhrmatata github 有这功能,只不过只能在 commit 中评论。
lsj5031
2014-01-06 21:49:05 +08:00
开源吗,一直想知道类似django books 那样的侧边批注怎么实现的,自己想过几个思路都太繁琐了……
iammutex
2014-01-06 21:52:30 +08:00
@mahone3297 是的,粒度问题确实开始感觉别扭。比如我们想注释的可能是一个函数或者一个类或者一个数据结构。但是这里只能在一行。开始我也苦恼过。
但是换一种方式想,我们在代码里加注释,其实也是选择在某两行之间写下若干说明,我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式,可以是一个函数调用,可以是一个函数定义的开头,可以是一个类定义的开头。
iammutex
2014-01-06 21:56:37 +08:00
@lsj5031 前端的东西看看源码就能看明白了吧。后端的东西貌似也很简单,存一下每一行加的批注就好了。
blueandhack
2014-01-06 22:02:24 +08:00

防盗链是?
ultragtx
2014-01-06 22:04:33 +08:00
不错 支持一下

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

不是"懒"么
iammutex
2014-01-06 22:05:54 +08:00
@blueandhack 额,貌似是又拍的问题,我尽快解决。感谢提醒!
iammutex
2014-01-06 22:07:32 +08:00
@ultragtx
@yangff
好吧,希望能帮懒人勤快起来。
Mcatt
2014-01-06 22:08:16 +08:00
很赞的想法!
Tankpt
2014-01-06 22:12:49 +08:00
必须一个个开始读么?里面的库有哪些呢
hhrmatata
2014-01-06 22:20:43 +08:00
建议提供api,方便开发第三方的编辑器插件。感觉还是用编辑器阅读比较舒服。
MingZhe
2014-01-06 22:21:46 +08:00
已经绑定进来。。。水平有限,还不敢乱写
hhrmatata
2014-01-06 22:22:17 +08:00
怎么样申请增加开源项目?
iammutex
2014-01-06 22:22:45 +08:00
@Tankpt
目前只放开了Nginx和Redis的两份源码,后续上多了会放更多上去。也会考虑让大家自己上传的方式。但目前,确实只有这两个。
allan888
2014-01-06 22:25:59 +08:00
踢偏全部挂了,防盗链
allan888
2014-01-06 22:26:24 +08:00
@allan888 “图片”全挂了,打错

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/95902

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX