我想听听你的意见的一些事情是：

评论不适用于外部消费.一般来说,我喜欢保持文档密切
这样的代码和评论可能不是一个好主意分享：

/**
 * @todo Should we change the signature of this function to
 * make it obvIoUs that xxx is really yyy?
 */

也许：

/**
 * @todo Add support for feature X
 */

选项卡样式不一致：

void functionA(int a,int b,int c,int d);

void functionB(int a,int c);

是否有任何工具可用于准备标题或代码以供发布？