百度空间 | 百度首页 
 
查看文章
 
怎样写好教程
2008-01-29 08:09

近日整理电脑, 发现一篇去年 7 月写的文章, 没写完却因为别的事把它忘了, 现在看来, 里面有些话是可以做座右铭时常提醒自己的.

近日用 Mplaye KK 编译版看 AVI, 资源占用率确实低, 不到 10%, 且不用解包.
但 Mplayer 是不能推荐给大家的, 一方面它需要手动设置的地方太多, 比如自设关联文件, 由此引出的我对它的使用还不熟练. 写不出教程来.
教程的最低要求有两点: 1. 准确; 2. 可读.
要做到准确不难, 只要有帮助文档; 但可读性就难以做到了. 要系统, 全面地说明一件东西, 并不比概括地介绍一个系统容易多少.
要实现整篇文章的通顺, 就需要有十倍的知识去了解. 我们可以轻松地用一天时间看完一本小学课本, 但我们的大学课本, 特别是专业课, 连编写它的老师都不愿去讲. 因为他们也不能全面地理解, 他们懂得并不比书上写的多多少. 大学课本的可读性差, 就像我们写的论文, 看的文献一般, 一边是我们自己的一无所知, 一边也有作者水平所限.
想法, 只要是人脑里出来的东西, 都必然带着人类的偏激, 所以当我们有想法, 但单独一人行不通时, 我们就应该利用, 寻找, 创造出舆论来帮助自己. 我们面对一个软件时, 一个负责任的态度是"己所不欲, 勿施于人", 但即使是"己所欲", 也请勿"施于"人, 我们做的应该是"献于人", 至于大家能否接受, 那要看我们的观点, 能否刺激读者的兴趣.
我们要做的是扬长不护短, 无论能否保持中立, 详尽而准确的事实罗列, 都是对读者的负责. 介绍单个软件时, 对同类型软件了解的广度和深度, 都是提高可读性的关键.

这很难...


类别:默认分类 | 浏览() | 评论 (0)
 
网友评论:
发表评论:
姓 名:
网址或邮箱: (选填)
内 容:
验证码: 请点击后输入四位验证码,字母不区分大小写
      

     

©2009 Baidu