【 在 atppp (Big Mouse) 的大作中提到: 】
: 我告诉你们,开源软件,又是大家业余时间做出来的东西,代码就是文档,哼哼
最受不了这个了
这样开了跟没开一样
--
FROM 218.28.14.*

我在采数据没事干，和你多侃两句。你对开源的理解就是这样子地？
我来告诉你，开源的核心精神，就是代码==文档，这是我在开源社区混迹>5年的
经验之谈...开源社区新手不动脑筋的提问得到的回答几乎必然是 RTFC。

bbs 代码是一种特殊的程序，它有两类使用者，一类是站点维护者，一类是站
点使用者（这里包括管理站务）。对于前者来说，代码文档在几乎所有的开源社区
里面都是奢求。很多开源社区，最缺乏的就是代码文档，我说的是相对数量，php
用的人那么多，但是你要做 php ext 的开发，文档有么？几乎是 0。如果你在 php
核心邮件列表问，怎么在 php ext 里面返回一个数组？哪里有文档？我几乎敢打赌
你不会收到回信，或者会收到两个词：RTFC/NO。高手不懈回答，也不懈写文档，因为
代码里啥都有。你可曾见过巨大无比的 mozilla 社区里面，有文档说明处理 cookie
的是哪一部分代码？从这个意义上来说，kbs/ytht/ptt 这三个我看下来，已经超越了很
多大得多的开源社区。我甚至曾经写过部分核心代码分析文档。当然，退一步讲，kbs
的代码某些地方注释很糟糕，结构有些混乱，撇开历史问题不说，这还是一个需要认真面
对的问题，但这并不影响大局。（这虽然是另一个层面的问题，但是因为这个，有时候
我会觉得说 kbs 开源代码=文档的底气不足，这也是我时常会来回答一些低级问题的
原因，但是我相信任何一个诚心诚意想维护站点的人，领进门以后要做到熟悉代码绝
不是一件难事。一个很小的代码改动问题，放到版面上问，我不反对，但是如果没人
回答，这也没什么好抱怨的，因为要我回答我也要去看代码才能回答，提问的人自己
也可以看，我凭什么要费这个时间？）

对于站点使用者，他们相当于开源软件的最终用户，他们所需要的文档就是一般
软件所谓的 manual，这个一般在开源社区里面是极为重要的一部分，很遗憾，
kbs 目前没有一个完善的组织来做这个使用文档的工作，一方面的原因是没有人
来组织，另一方面也是因为很多文档已经存在只是没有整理，例如 BBSHelp
版面的精华区，还有站史版一些系统功能更新记录。kbs 系统的情况很特殊，
它主要依赖于水木的发展而发展，很多使用 kbs 的站点，对这个系统已经相当熟悉，
所以使用文档的制作几乎毫无意义。

我的话完了。数据还没完，faint...


【 在 JulyClyde (七月) 的大作中提到: 】
: 【 在 atppp (Big Mouse) 的大作中提到: 】
: : 我告诉你们,开源软件,又是大家业余时间做出来的东西,代码就是文档,哼哼
: 最受不了这个了
: 这样开了跟没开一样
--
修改:atppp FROM 128.12.150.70
FROM 128.12.150.70

这篇咋不转信呢?

【 在 atppp (Big Mouse) 的大作中提到: 】
我在采数据没事干，和你多侃两句。你对开源的理解就是这样子地？
我来告诉你，开源的核心精神，就是代码==文档，这是我在开源社区混迹>5年的
经验之谈...开源社区新手不动脑筋的提问得到的回答几乎必然是 RTFC。

bbs 代码是一种特殊的程序，它有两类使用者，一类是站点维护者，一类是站
点使用者（这里包括管理站务）。对于前者来说，代码文档在几乎所有的开源社区
里面都是奢求。很多开源社区，最缺乏的就是代码文档，我说的是相对数量，php
用的人那么多，但是你要做 php ext 的开发，文档有么？几乎是 0。如果你在 php
核心邮件列表问，怎么在 php ext 里面返回一个数组？哪里有文档？我几乎敢打赌
你不会收到回信，或者会收到两个词：RTFC/NO。高手不懈回答，也不懈写文档，因为
代码里啥都有。你可曾见过巨大无比的 mozilla 社区里面，有文档说明处理 cookie
的是哪一部分代码？从这个意义上来说，kbs/ytht/ptt 这三个我看下来，已经超越了很
多大得多的开源社区。我甚至曾经写过部分核心代码分析文档。当然，退一步讲，kbs
的代码某些地方注释很糟糕，结构有些混乱，撇开历史问题不说，这还是一个需要认真面
对的问题，但这并不影响大局。（这虽然是另一个层面的问题，但是因为这个，有时候
我会觉得说 kbs 开源代码=文档的底气不足，这也是我时常会来回答一些低级问题的
原因，但是我相信任何一个诚心诚意想维护站点的人，领进门以后要做到熟悉代码绝
不是一件难事。一个很小的代码改动问题，放到版面上问，我不反对，但是如果没人
回答，这也没什么好抱怨的，因为要我回答我也要去看代码才能回答，提问的人自己
也可以看，我凭什么要费这个时间？）

对于站点使用者，他们所需要的文档就是一般软件所谓的 manual，这个一般在
开源社区里面是极为重要的一部分，很遗憾，kbs 目前没有一个完善的组织来做
这个使用文档的工作，一方面的原因是没有人来组织，另一方面也是因为很多
文档已经存在只是没有整理，例如 BBSHelp 版面的精华区，还有站史版
一些系统功能更新记录。kbs 系统的情况很特殊，它主要依赖于水木的发展而发展，
很多使用 kbs 的站点，对这个系统已经相当熟悉，所以使用文档的制作几乎毫无意义。

我的话完了。数据还没完，faint...


【 在 JulyClyde (七月) 的大作中提到: 】
: 【 在 atppp (Big Mouse) 的大作中提到: 】
: : 我告诉你们,开源软件,又是大家业余时间做出来的东西,代码就是文档,哼哼
: 最受不了这个了
: 这样开了跟没开一样
--
修改:atppp FROM 128.12.150.70
FROM 159.226.37.*

        还没看明白么?
        这不是水平问题
        这是态度问题

【 在 liangls (精灵射手) 的大作中提到: 】
: 高手＆菜鸟之间不可调和的矛盾。。。
--
FROM 202.120.3.*

不知道怎么去看,就还是不要用了
如果我没记错的话,从你刚开始来这里就有很多人建议你装一个web forum
【 在 liangls (精灵射手) 的大作中提到: 】
: 新手因为不知道应该怎么看，所以就没有去看，
: 所以会问很多傻问题，被高手当作态度问题。
--
FROM 59.66.134.36