Objective C 这种自解释型的语言需要很长的文档么?

[alexrezit]

我的项目通常只有特别复杂的地方才加上一些注释, 而且我也认为这种语言本身的特性就不需要很复杂的文档, 被吐槽了... = =

- 我们之前的项目文档比程序都长.
- 私以为 Objective C 的东西只有闭源项目才需要文档.
- 凡是程序都要有文档啊亲. 优秀是一种习惯.
- ...

[saharabear]

这个。。。。。。。。。

我不多说了，座等评论。

--------------
好像我这样的回复不符合规定，那说几句：有什么样的语言不是自解释型的呢？文档是指API文档还是编码说明文档？应用是自己写着一套的还是写API给别的组用的？ 这些对文档的要求不大一样吧？

[alexrezit]

@saharabear
编码说明文档是什么? 自己写着一套的... 我觉得像 Objective C 这种 caller 加上 method 连起来直接就是一句大白话的真心没啥必要, 想弄明白一个模块什么功能看文档不如看代码快.

[saharabear]

@alexrezit 我觉得吧，如果是多人协作，别人可以轻松看明白输入和输出的，就没必要写注释了。但是如果真的有必要写注释，就定义一下除了输入和输出以外的东西，比如异常或者一些特殊的地方。

不然，就没大有必要多写注释了。