|
|
发表于 2005-3-7 22:47:27
|
显示全部楼层
Post by lincomet
最好再分一下难易程度。
还有,涉及一些技术细节的最好解释的清楚一点。还有有代码的话,代码的注释最好详细一些,可以让初学者学更多的东西。
问题就在这里。维护不同的两份文档是不是有用?对于文档来说,什么最重要?在《人本界面》中提到,不要区分普通用户和所谓专家用户。我觉得,最重要的,是操作要简捷,并且可以重复/撤销,要解释每个动作的作用和影响。这个原则对普通用户还是专家用户都适用。
既然如此,就应当按照用到的命令数量,将文档分类。用到 rpm 或者 apt-get 命令的美化过程可以完美地满足上面的要求,但是用到 vi 或者 gedit 的美化过程……恕我直言,根本无法满足要求,用户甚至无法运行那些命令。而 mkdir 或者 cp 之类的操作,几乎不必解释命令本身的含义,却几乎无法解释它们可能造成的影响。比如有人说 cd /usr/bin && ln -s fcitx chinput 的时候,命令本身的含义是创建一个链接,但是这个命令很可能没有任何影响,用户可能输入了 cd /usr/bin & & ln -s fcitx chinput 之类的。还有修改 LC_* 变量的操作,太可怕了,太野蛮了。(这句话不是我原创的)
不理解一个美化过程的含义时,不知道如何查看这个过程的结果时,最好还是不要去冒风险 |
|