Erlang 文档计划
在 Erlang 这个小世界里,一直不乏格式良好,态度严谨的文档(貌似 Erlang 很有点学院气息)。读完这些东西,常常让人有豁然开朗之感。可是它们又犹如深海明珠,难得一见。用上最先进的 google 也不济事,一网抄下去,常常啥也捞不上来。尤其是,在中文环境里,又隔阂了语言的屏障,凭一人之力来收集这些文档,几乎变成一个让人绝望的任务。
通过网络,集合大家的力量来收集这些“珍宝”,似乎是个不错的想法。更进一步,受“段先德”同学关于“无一遗漏地精读的方式,就是把它翻译一回”的激励。也许,除了“段先德”和“Dino Wu”之外,还有另外一些奉行开源精神的 hacker 们,也愿意与其他人分享自己的“精读”的心得。而整个中文社区的用户都将因此获益。
希望,通过这个小小的“Erlang文档计划”,为中文地区的Erlang用户带来一些便利。
方法很原始(但应该很可靠
),在这个(http://erlang-china.org/erlang-doc)地址,会维护一份文档列表,通过各种渠道的收集到的文档都会迅速的被添加进去。希望这个列表会变得很长,很全,并且出现 N 多的中文版。
为便于整理,对于每一篇好文档,最好提供如下资料:
必填:
类目 (如:官方文档,论文,活动文档,其他;如果是活动,则请注明活动名称,如: EUC07,CN-Erlounge-II等),
名称 (英/中/简,尽量详细,如:Making reliable distributed systems in the presence of software errors/面对软件错误构建可靠的分布式系统/JoeThesis 2003),
作者 (如:Joe Armstrong),
URL (如:http://www.erlang.org/download/armstrong_thesis_2003.pdf,如果没有原始下载链接,也可发一贴,以附件形式上传到 erlang-china.org ),
选填:
简介 (大致介绍一下内容,没准写的好,就有同学主动要来翻译啊
)
然后,将你发现的好文档:
1,回复到 http://erlang-china.org/erlang_doc 中,
2,发送到 erlang-china 或 ecug 的 maillist 中,
3,直接发 gtalk 给我,如果你有我的 gtalk,
各位开始翻译计划时,也请通过上面的方式通知,以便标注“某某正在翻译中”,避免题材撞车。
that’s all. let’s make it.
trapexit上的cookbook, how to do文档貌似不错。
提议非常不错。
不过有个修改建议:经过那么长时间在Blog上打滚,我个人感觉Blog不太适合知识管理,推荐Wiki系统。如Google Code Wiki,不妨用 http://code.google.com/p/ecug/。不过这个Wiki又有一点不太好,必须成为Project Member才能够编辑。
@mryufeng 好提议,我会把它 cookbook 和 how to 补充进去。
@xushiwei wiki 是个好主意,不过,我试了一下,还没有找到好方案。
现在登录 erlang-china.org 的 dashboard 下就开了一个架设在 wordpress 上的 miniwiki ,郁闷的是它不是一个 open page 。而其他的 wiki 又貌似不能和 wordpress 的用户系统打通,还得再找找方案。
各位有啥好提议?