分享一个直接在源代码上讨论和批注的软件：极客讨论器

软件的最大特点是可以直接在源代码选择要说明的部分，然后用消息来解释它。消息可以含文字，图片，源代码补丁，链接其它项目的源代码等。消息可以发布到社区网站或者公司内部论坛上进行讨论。

软件可以从这里下载： http://www.gtalkabout.cn/download.html

下面介绍一下使用方法：
一开始先选一个极客网站，这是告诉软件要在哪里讨论。这里既包括互联网上的网站，也可以在公司内部服务器搭建一个论坛，如果本地安装了web服务器，也可以连接本机的论坛。如果自己搭论坛要图方便的话建议使用phpBB 3.0.12，因为极客讨论器自带了phpBB的讨论插件。如果选用其它论坛或者网站程序也可自己用python开发讨论插件。

然后软件需要配置源代码所在的版本库，可以是subversion或者git的版本库。在前一个界面可以选择一个已存在的项目配置，没有的话新建一个项目配置。这里通过“第三方开源项目”按钮进入到配置界面，选择httpie的版本库，这是github上一个很不错的python项目。

开始讨论前，会先将httpie整个库克隆到本地，这是git版本库的特点，以后就可以直接在本地访问了，注意git克隆有可能是个很耗时间的操作，根据版本库的大小和网速决定，像httpie整个版本库从github克隆到我的电脑花了十多分钟。不过下次就好了，每次只会克隆新增加的版本。如果是subversion版本库，则会检出最新版本的源代码，然后把版本库一个版本一个版本的同步到本地，比git版本库能更快进入状态。极客讨论器的同步映射功能非常实用，它能自动为你选择是访问远端库还是本地映射库。

讨论之前先了解一下界面。占据界面中央和左边的大部分白色底部的是代码的查看区，左边是文件列表，每个文件上有svn/git状态标志。中央是查看和编辑源代码，如果标题是红色表示正在讨论，是不能编辑的。而下方和右边才是本软件的特别之处。下方带滑块的进度条可以在版本库里导航，可以访问任一版本，如果版本已经映射到本地会自动优先访问本地的副本，否则访问远端的原本；箭头可以检查远端是否有人提交了新版本，如果你有版本库的写权限的话，也可以提交你的修改。右边则是讨论区域，可以在这里收别人的消息和发送自己的消息。

下面正式开始讨论了。在论坛讨论无非就是发帖和看别人的帖子。帖子或者叫做消息在极客讨论器中是和代码位置相关的，讨论的时候可以把代码的结果记录下来，或者像做注释一样，说明这段代码的功能。在讨论区输入一个帖子，回车即可载入这个帖子和所有回帖。某个文件有多少条讨论消息会显示在文件左边。某段代码被消息讨论会变成红底，如果选中它可以找到讨论这段代码的消息。通过消息也可以定位指向的代码。消息不但可以定位到这个项目中，也可以定位到其它的项目中，还可以携带代码补丁。那些没有提交到版本库权限人的可以通过这种方式向有提交权限的提供自己的贡献。

另外特别介绍一下程序员记，这是开源项目的笔记和讨论类网站，特别适合在github，csdn，oschina等网站有开源项目的同学，在你开发的同时可以在这里记录代码的实现流程，有图有文字，还可以在这里和下载使用你代码的同学交流，他们也可以通过发帖向你提问或者发送代码补丁给你。这里是按用户划分版面，只要注册后填写你的github账号，我们会去查看你的github空间，里面至少有一个项目的readme有：请在程序员记(http://www.progbbs.com)的“xxx 的项目”和我进行讨论。就会划分一个名为“xxx 的项目”版面给你，你在此版面有删除帖子和审批帖子的权限。xxx是你在程序员记网站的注册名。