开发者社区> 问答> 正文

建议:用户手册


最近买了贵公司产品,目前用着很不错,非常高兴!
但存在些问题(仅个人意见),如用户手册,编写实在言简意不赅.
用户手册的目的是在于用户能够根据手册内容非常快速的完成配置过程,对于老手可以起到帮助回忆的作用,对于新手亦可引路.
首先,以vsftp配置为例, Linux下如何进行FTP设置,可以看出编写人员实在不用心,身为同行虽能知晓其中缘由,但不能苟同.
用户手册面向群体为大众,你不能认为我的手册就是为高手准备的,它的意义在新手身上更能体现,高手未必使用.
以FTP配置为例,我的是Debian,
第一,说更新源,提到了那么个工具,结束了?用户下载下来他就知道怎么用了?至少也应该说个scp过程吧,或者其它方法.
第二,使用apt-get就能保证成功,有没有提不成功怎么办?注意,update_source.sh中指定的源未必一定适用,因为并非Ali专有源.
第三,这点促使我提些意见,说到添加ftp账号和位置,说"检查nologin的位置",可能在某某地方,你让用户ls去?知道cat /etc/passwd | grep nologin,告诉用户目录位置不比让用户去想上哪找nologin目录好吗?再说添加pwftp用户,连目录都没有,useradd后chown去改变谁去,要不说明mkdir -p去创建,要不useradd -m参数去指定.
第四,提到修改配置,编辑vsftpd.chroot_list,似乎你装完这个文件不存在吧,一般用户肯定说这个文件我怎么找不到...
最后,说了这么多,只是因为看到这样的用户手册,感觉跟新手写的一般,草草描述过程,故写下建议.
个人意见可能存有偏颇之处.如果觉得细节不好说大可以图文并茂.一直认为阿里在技术和产品方面非常优秀,希望不要让人觉得大企业也是只为买出产品,不顾用户,让人诟病.

展开
收起
packrat 2014-05-31 18:45:34 7702 0
1 条回答
写回答
取消 提交回答
  • 有问题可以后台提交工单
    2014-05-31 19:47:16
    赞同 展开评论 打赏
问答分类:
问答地址:
问答排行榜
最热
最新

相关电子书

更多
15分钟打造你自己的小程序更新版 立即下载
阿里开发者手册-单元测试专题 立即下载
《Java开发手册》2019最新版发布! 立即下载

相关实验场景

更多